SceneHandle.cs 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. using UnityEngine.SceneManagement;
  2. namespace YooAsset
  3. {
  4. public class SceneHandle : HandleBase
  5. {
  6. private System.Action<SceneHandle> _callback;
  7. internal string PackageName { set; get; }
  8. internal SceneHandle(ProviderOperation provider) : base(provider)
  9. {
  10. }
  11. internal override void InvokeCallback()
  12. {
  13. _callback?.Invoke(this);
  14. }
  15. /// <summary>
  16. /// 完成委托
  17. /// </summary>
  18. public event System.Action<SceneHandle> Completed
  19. {
  20. add
  21. {
  22. if (IsValidWithWarning == false)
  23. throw new System.Exception($"{nameof(SceneHandle)} is invalid !");
  24. if (Provider.IsDone)
  25. value.Invoke(this);
  26. else
  27. _callback += value;
  28. }
  29. remove
  30. {
  31. if (IsValidWithWarning == false)
  32. throw new System.Exception($"{nameof(SceneHandle)} is invalid !");
  33. _callback -= value;
  34. }
  35. }
  36. /// <summary>
  37. /// 等待异步执行完毕
  38. /// </summary>
  39. internal void WaitForAsyncComplete()
  40. {
  41. if (IsValidWithWarning == false)
  42. return;
  43. Provider.WaitForAsyncComplete();
  44. }
  45. /// <summary>
  46. /// 场景名称
  47. /// </summary>
  48. public string SceneName
  49. {
  50. get
  51. {
  52. if (IsValidWithWarning == false)
  53. return string.Empty;
  54. return Provider.SceneName;
  55. }
  56. }
  57. /// <summary>
  58. /// 场景对象
  59. /// </summary>
  60. public Scene SceneObject
  61. {
  62. get
  63. {
  64. if (IsValidWithWarning == false)
  65. return new Scene();
  66. return Provider.SceneObject;
  67. }
  68. }
  69. /// <summary>
  70. /// 激活场景(当同时存在多个场景时用于切换激活场景)
  71. /// </summary>
  72. public bool ActivateScene()
  73. {
  74. if (IsValidWithWarning == false)
  75. return false;
  76. if (SceneObject.IsValid() && SceneObject.isLoaded)
  77. {
  78. return SceneManager.SetActiveScene(SceneObject);
  79. }
  80. else
  81. {
  82. YooLogger.Warning($"Scene is invalid or not loaded : {SceneObject.name}");
  83. return false;
  84. }
  85. }
  86. /// <summary>
  87. /// 解除场景加载挂起操作
  88. /// </summary>
  89. public bool UnSuspend()
  90. {
  91. if (IsValidWithWarning == false)
  92. return false;
  93. if (Provider is SceneProvider)
  94. {
  95. var provider = Provider as SceneProvider;
  96. provider.UnSuspendLoad();
  97. }
  98. else
  99. {
  100. throw new System.NotImplementedException();
  101. }
  102. return true;
  103. }
  104. /// <summary>
  105. /// 异步卸载场景对象
  106. /// 注意:场景卸载成功后,会自动释放该handle的引用计数!
  107. /// </summary>
  108. public UnloadSceneOperation UnloadAsync()
  109. {
  110. string packageName = GetAssetInfo().PackageName;
  111. // 如果句柄无效
  112. if (IsValidWithWarning == false)
  113. {
  114. string error = $"{nameof(SceneHandle)} is invalid.";
  115. var operation = new UnloadSceneOperation(error);
  116. OperationSystem.StartOperation(packageName, operation);
  117. return operation;
  118. }
  119. // 注意:如果场景正在加载过程,必须等待加载完成后才可以卸载该场景。
  120. {
  121. var operation = new UnloadSceneOperation(Provider);
  122. OperationSystem.StartOperation(packageName, operation);
  123. return operation;
  124. }
  125. }
  126. }
  127. }