一律開啟應用程式和系統微光模式

本指南說明如何讓應用程式保持運作、如何因應電源狀態轉換，以及如何管理應用程式行為，在節省電量的同時提供良好的使用者體驗。

持續顯示應用程式會大幅影響電池續航力，因此新增這項功能時，請注意對電量的影響。

核心概念

Wear OS 應用程式以全螢幕顯示時，會處於下列兩種電源狀態之一：

• 互動：高耗電狀態，螢幕會以全螢幕亮度顯示， 讓使用者充分互動。
• 微光：低耗電狀態，螢幕會調暗以節省電力。在此狀態下，應用程式的 UI 仍會佔滿整個螢幕，但系統可能會模糊處理或疊加時間等內容，藉此改變外觀。這也稱為「微光模式」。

作業系統會控管這些狀態之間的轉換。

「一律啟用的應用程式」是指在「互動」和「微光」狀態下都會顯示內容的應用程式。

如果應用程式在裝置處於低功耗的微光狀態時，持續顯示自己的 UI，則稱為處於微光啟動模式。

系統轉換和預設行為

應用程式在前台執行時，系統會根據使用者閒置觸發的兩個逾時，管理電源狀態轉換。

• 逾時 #1：互動式到微光狀態：使用者閒置一段時間後，裝置會進入微光狀態。
• 逾時 #2：返回錶面：如果裝置持續閒置，系統可能會隱藏目前應用程式並顯示錶面。

系統第一次轉換為「微光」狀態後，預設行為會因 Wear OS 版本和應用程式設定而異：

• 在 Wear OS 5 以下版本，系統會顯示暫停應用程式的模糊螢幕截圖，並在上方疊加時間。
• 在 Wear OS 6 以上版本，如果應用程式指定 SDK 36 以上版本，系統會視為「一律開啟」。螢幕會調暗，但應用程式會繼續執行並保持顯示狀態。(更新頻率可能低至每分鐘一次)。

自訂微光狀態的行為

無論系統預設行為為何，在所有 Wear OS 版本上，您都可以使用 AmbientLifecycleObserver 監聽狀態轉換的回呼，在微光狀態下自訂應用程式的外觀或行為。

使用 AmbientLifecycleObserver

如要對微光模式事件做出反應，請使用 AmbientLifecycleObserver 類別：

1. 實作 AmbientLifecycleObserver.AmbientLifecycleCallback 介面。使用 onEnterAmbient() 方法調整使用者介面，以適應低功耗狀態，並使用 onExitAmbient() 將使用者介面還原為全互動式顯示模式。

   val ambientCallback = object : AmbientLifecycleObserver.AmbientLifecycleCallback {
       override fun onEnterAmbient(ambientDetails: AmbientLifecycleObserver.AmbientDetails) {
           // ... Called when moving from interactive mode into ambient mode.
           // Adjust UI for low-power state: dim colors, hide non-essential elements.
       }
   
       override fun onExitAmbient() {
           // ... Called when leaving ambient mode, back into interactive mode.
           // Restore full UI.
       }
   
       override fun onUpdateAmbient() {
           // ... Called by the system periodically (typically once per minute)
           // to allow the app to update its display while in ambient mode.
       }
   }
   

2. 建立 AmbientLifecycleObserver，並向活動或可組合項的生命週期註冊。

   private val ambientObserver = AmbientLifecycleObserver(activity, ambientCallback)
   
   override fun onCreate(savedInstanceState: Bundle) {
       super.onCreate(savedInstanceState)
       lifecycle.addObserver(ambientObserver)
   
       // ...
   }
   

3. 呼叫 removeObserver() 即可移除 onDestroy() 中的觀察器。

對於使用 Jetpack Compose 的開發人員，Horologist 程式庫提供實用的 AmbientAware 可組合項公用程式，可簡化這個模式的實作方式。

可感知環境的 TimeText

在 Wear OS 6 中，TimeText 小工具可感知微光模式，因此不需要自訂觀察器。裝置處於微光狀態時，系統會每分鐘自動更新一次，無須額外編寫程式碼。

控制螢幕開啟時間

以下各節說明如何管理應用程式在螢幕上停留的時間。

避免在持續性活動期間返回錶面

經過一段時間後，系統通常會從「微光」狀態 (逾時 #2) 返回錶面。使用者可以在系統設定中設定逾時時間長度。在某些情況下，應用程式可能需要長時間保持顯示狀態，例如使用者追蹤健身活動時。

在 Wear OS 5 以上版本中，您可以導入持續性活動，防止系統執行這項操作。如果應用程式顯示使用者正在進行的工作相關資訊 (例如健身活動)，您可以使用 Ongoing Activity API，讓應用程式保持顯示狀態，直到工作結束為止。如果使用者手動返回錶面，持續性活動指標會提供一鍵返回應用程式的方式

如要實作這項功能，持續性通知的觸控意圖必須指向常時運作活動，如下列程式碼片段所示：

private fun createNotification(): Notification {
    val activityIntent =
        Intent(this, AlwaysOnActivity::class.java).apply {
            flags = Intent.FLAG_ACTIVITY_SINGLE_TOP
        }

    val pendingIntent =
        PendingIntent.getActivity(
            this,
            0,
            activityIntent,
            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE,
        )

    val notificationBuilder =
        NotificationCompat.Builder(this, CHANNEL_ID)
            // ...
            // ...
            .setOngoing(true)

    // ...

    val ongoingActivity =
        OngoingActivity.Builder(applicationContext, NOTIFICATION_ID, notificationBuilder)
            // ...
            // ...
            .setTouchIntent(pendingIntent)
            .build()

    ongoingActivity.apply(applicationContext)

    return notificationBuilder.build()
}
AlwaysOnService.kt

讓螢幕保持開啟，避免進入微光模式

在極少數情況下，您可能需要完全禁止裝置進入微光狀態。也就是避免發生逾時 #1。如要這麼做，可以使用 FLAG_KEEP_SCREEN_ON 視窗標記。這項功能會做為喚醒鎖定，讓裝置保持在「互動」狀態。請務必謹慎使用這項功能，因為這會大幅影響電池續航力。

微光模式建議

為提供最佳使用者體驗，並在微光模式下節省電力，請遵循這些設計指南。這些建議會優先確保使用者體驗清晰明瞭，避免誤導資訊並減少視覺混亂，同時盡量提升顯示效果。

• 減少視覺雜亂感並降低螢幕耗電量。簡潔的極簡風 UI 會向使用者表示應用程式處於低耗電狀態，並限制亮像素，大幅節省電量。
  • 讓至少 85% 的畫面保持黑色。
  • 只顯示最重要的資訊，將次要詳細資料移至互動式螢幕。
  • 大型圖示或按鈕請使用外框，不要使用實心填滿。
  • 避免使用大面積的純色區塊，以及無實際用途的品牌宣傳或背景圖片。
• 處理過時的動態資料
  • 為節省電力，系統只會定期 (通常每分鐘一次) 叫用 onUpdateAmbient() 回呼。因此，任何經常變更的資料 (例如碼錶、心率或運動距離) 在更新之間都會過時。為避免顯示誤導和不正確的資訊，請監聽 onEnterAmbient 回呼，並將這些即時值替換為靜態預留位置內容，例如 --。
• 維持一致的版面配置
  • 在「互動」和「微光」模式中，將元素保持在相同位置，打造流暢的轉換效果。
  • 一律顯示時間。
• 瞭解情境
  • 如果裝置進入微光模式時，使用者正在設定或配置畫面，請考慮顯示應用程式中更相關的畫面，而非設定檢視畫面。
• 處理裝置專屬需求
  • 在傳遞至 onEnterAmbient() 的 AmbientDetails 物件中：
    • 如果 deviceHasLowBitAmbient 為 true，請盡可能停用反鋸齒功能。
    • 如果 burnInProtectionRequired 為 true，請定期稍微移動 UI 元素，並避免顯示實心白色區域，以免螢幕烙印。

偵錯和測試

開發或測試應用程式在微光模式下的行為時，這些 adb 指令可能很有用：

# put device in ambient mode if the always on display is enabled in settings
# (and not disabled by other settings, such as theatre mode)
$ adb shell input keyevent KEYCODE_SLEEP

# put device in interactive mode
$ adb shell input keyevent KEYCODE_WAKEUP

範例：健身應用程式

以運動應用程式為例，這類應用程式需要在整個運動期間向使用者顯示指標。應用程式必須在微光狀態轉換期間保持可見，避免被錶面取代。

為此，開發人員應採取下列做法：

1. 導入 AmbientLifecycleObserver，處理「互動」和「微光」狀態之間的 UI 變化，例如調暗螢幕和移除非必要資料。
2. 為「微光」狀態建立新的低耗電版面配置，並遵循最佳做法。
3. 在運動期間使用 Ongoing Activity API，避免系統返回錶面。

如需完整實作方式，請參閱 GitHub 上以 Compose 為基礎的運動範例。這個範例也示範如何使用 Horologist 程式庫中的 AmbientAware 可組合函式，簡化 Compose 中的微光模式處理程序。