共用方式為


選擇正確的活動協調器原則

活動協調器提供數個範本原則,應根據您的工作所需的資源來選取。

瞭解您的活動工作負載

判斷您的工作所需的活動協調器資源,以及工作應該執行的條件。 使用效能追蹤分析工作是一個很好的起點。

選擇資源

選擇衍生自效能追蹤的資源。 這些資源應該是您的活動工作負載將影響的資源。 別忘了您隱含取用或影響的資源,例如使用者閑置和電源。

選擇條件

根據工作負載的資源耗用量選擇條件,如效能追蹤中所觀察到。 一般而言,我們建議針對所需的資源使用最佳條件,並在不符合所需時間範圍內的需求時,以較少的條件更新原則。 從最佳條件開始,在不符合原則(不符合其資源條件)以符合任何期限時執行之前,最好先轉換到較小的條件。 這可讓 API 有機會將活動的使用者和系統影響降到最低,同時增加活動執行的機會。

對於可忽略或低資源耗用量的工作負載,ACTIVITY_COORDINATOR_CONDITION_MEDIUM條件可能會可供使用,而不會對系統造成負面影響。 較耗用量較高的工作負載較適合使用條件時,使用方式不太可能影響用戶體驗,例如 ACTIVITY_COORDINATOR_CONDITION_GOOD。 使用較少條件時,這類工作負載更有可能造成重大影響,而且這些影響在本質上可能不是暫時性的。 例如,在中型網路條件下取用因特網可能會導致用戶財務成本,如果該網路已計量並計費。

請記住,除了計算機從任何效能追蹤的功能之外,您的應用程式所支援的裝置和組態類型。 目標環境中的變異性可能表示工作負載如何影響使用者、系統,以及在特定期間內滿足原則的可能性差異。

期限

可能會有各種與活動相關聯的時間限制。 運行時間較長的工作或工作需要開始或完成的時間相對較短,可能更適合使用較少的條件來增加原則開啟的可能性。 較短的執行中工作或工作若有鬆散的時間需求,可能會使用最佳條件來符合其需求。 在較長的時間範圍內,目標系統可能會有低資源耗用量的期間。 如果期限即將到期,建議您在期限之後或接近期限之前,尚未進行足夠的進度,則建議您降級您的原則。 然後,重新指派工作可以在完成時切換至原始原則。

範本原則

API 隨附一組範本原則,適用於一般工作配置檔,可用來簡單開始使用 API。 對於執行本機運算的大部分程序,我們建議使用範本原則。

原則建議

在提供的範本原則中,如果您不確定應該挑選哪一個原則, 則ACTIVITY_COORDINATOR_POLICY_TEMPLATE_GOOD 應該符合大部分案例的帳單。 此原則會將使用者的影響降到最低,同時為原則提供足夠開放且足以完成開發人員工作的可能性。

自定義範本原則

範本原則可能會省略某些資源(例如 GPU),這在一般使用案例中可能不需要。 根據預期的工作負載,您可以使用範本原則做為起點來自定義原則。

從頭開始建置原則

需要完整控制的開發人員可以從空白原則開始: ACTIVITY_COORDINATOR_POLICY_TEMPLATE_EMPTY。 不過,針對這些案例,建議您從 ACTIVITY_COORDINATOR_POLICY_TEMPLATE_BASE 開始,這會指定適用於大部分情況的最低建議資源和條件。 這有助於確保從頭開始設定原則時,不會錯誤地省略重要的資源條件,例如用戶閑置、CPU 和電源資源。

活動協調器 API 概觀

活動協調器 API 和術語

活動協調器範例專案