Actor 的生命週期

Actor 在其生命週期中會經歷一系列階段。了解這些階段以及在每個階段中可以或不可以執行的操作非常重要。

這些階段適用於 actor 本身以及其內部的元件。每個階段都會先應用於所有元件，然後再進入下一個階段。

1. 建構（Construction）

   • 類被實例化，並調用構造函數（constructor）。

   • 使用 inject 和 attach 函數注入服務並附加元件。

   • 不要使用類中作為參數的屬性，因為它們的值此時尚未定義。

2. 反序列化（Deserialisation）

   • 使用 attach 函數或 Attach 裝飾器設置的屬性將被賦值。

   • 在編輯器中配置的參數將被設置到 actor 和元件上。

3. 初始化（Initialisation）

   • onInit 方法會在 actor 上調用，然後依次調用元件上的 onInit 方法。

   • onInit 方法可以是異步的，並且會同時執行。因此，避免依賴其他元件的 onInit 方法中的邏輯，因為它們完成的順序可能不可靠。

   • 可以使用類中的參數屬性，因為此時它們已被定義。

   • 設置訂閱並開始執行遊戲邏輯。

   • 如果某些元件無法在建構階段附加，則可以動態附加它們。使用 this.attach。

   • 不要使用 inject 或 attach 函數。

4. 開始遊戲（Begin Play）

   • 當 actor 被生成到世界中時觸發。

   • onBeginPlay 方法會在 actor 上調用，然後依次調用元件上的 onBeginPlay 方法。這不會在編輯器中發生。

   • 利用此階段啟動遊戲玩法功能。

5. 更新（Update）

   • 在每一幀渲染(rendered)之前調用 onUpdate 方法，此方法通常用於邏輯處理。

   • 執行可能需要變換渲染物件或其他視覺效果的功能。

   • 避免在此函數中創建僅供臨時使用的新物件。由於該函數執行頻率極高，記憶體分配和垃圾回收可能對性能產生顯著影響。

   • 避免將需要與渲染迴圈頻率不同步執行的功能放在更新階段。由於不同 actors 的 onUpdate 方法調用順序無法保證一致，因此同步多個 actors 的功能可能會很困難。建議依賴來自其他 actors、元件或系統發出的事件。

6. 延遲更新（Late Update）

   1. 與 onUpdate 一樣，每幀調用一次，但會在所有 onUpdate 方法執行完畢後調用。

   2. 當您希望確保所有 onUpdate 函數完成後再執行某些代碼時，此方法非常有用。

   3. 例如相機操作或跟隨特定物體，尤其是在相機需要跟隨一個已在 onUpdate 方法中更新過的位置移動的物體時。

7. 結束遊戲（End Play）

   • 當遊戲關閉或 actor 被移除時觸發。

   • onEndPlay 方法會在 actor 上調用，然後依次調用元件上的 onEndPlay 方法。這不會在編輯器中發生。

8. 移除（Removal）

   1. Actor 從世界中移除並被釋放。

   2. 取消所有創建的訂閱。如果您使用 RxJs 創建訂閱，可以使用 .pipe(takeUntil(this.disposed)) 確保當 actor 被移除時自動取消訂閱。