Anroid Wear OS 手錶應用開發 - 微光模式 AmbientMode

微光模式

智能手錶的電池容量都比較低，致使續航也比較短。爲了延長手錶的續航，Wear OS 手錶在沒有操做一段時間後，會進入微光模式 AmbientMode。

微光模式就是一個省電模式，這個模式會在低功耗下運行，默認狀況下，手錶會離開當前的應用，返回到錶盤的界面。

但有時候，咱們但願開發的應用在某些狀況下，能夠一直保持可見的狀態，這就須要咱們使用支持微光模式的 Activity 了。

項目配置

• build.gradle 配置

添加如下依賴項：

dependencies {
    ...
    implementation 'com.google.android.support:wearable:2.4.0'
    compileOnly 'com.google.android.wearable:wearable:2.4.0'
}
複製代碼

• manifest 配置

添加穿戴設備共享庫（僅支持 Android 5.1 及以上版本）：

<application>
    <uses-library 
        android:name="com.google.android.wearable"
        android:required="true" />
    ...
</application>
複製代碼

添加保持喚醒權限：

<uses-permission android:name="android.permission.WAKE_LOCK" />
複製代碼

支持微光模式的 Activity

修改須要支持微光模式的 Activity，讓它繼承 WearableActivity，並在 onCreate 中調用 setAmbientEnabled()：

class MainActivity : WearableActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setAmbientEnabled()
    }
}
複製代碼

處理模式切換

如今，咱們的 Activity 在進入微光模式後，會仍然保持可見。但隨着系統功耗的下降，定時器、屏幕刷新率等都會受到影響。

爲了用戶體驗、也爲了節省電量，咱們須要在進入微光模式的時候作一些處理。

在微光模式下，建議隱藏全部非必要內容，將頁面背景換成黑色，字體顏色換成白色。再更進一步，能夠停用全部文字的抗鋸齒。而後在離開微光模式的時候，恢復成原來的樣子。

WearableActivity 的 onEnterAmbient 和 onExitAmbient 方法會在進入和離開微光模式時調用。舉個簡單的例子，咱們能夠這樣來處理：

/** * 進入微光模式 */
override fun onEnterAmbient(ambientDetails: Bundle?) {
    // 隱藏不重要內容
    image_view.visibility = View.GONE
    // 黑色背景
    frame_layout.setBackgroundColor(Color.BLACK)
    // 白色字體
    text_view.setTextColor(Color.WHITE)
    // 停用抗鋸齒
    text_view.paint.isAntiAlias = false
}

/** * 退出微光模式 */
override fun onExitAmbient() {
    // 恢復顯示
    image_view.visibility = View.VISIBLE
    // 恢復背景
    frame_layout.setBackgroundColor(Color.RED)
    // 恢復字體
    text_view.setTextColor(Color.GREEN)
    // 啓用抗鋸齒
    text_view.paint.isAntiAlias = true
}
複製代碼

頻繁更新界面也會必定程度上影響電池續航，官方建議咱們在微光模式下，每分鐘更新一次界面。WearableActivity 提供了一個方法 onUpdateAmbient() ，它會以每分鐘一次的頻率回調這個方法：

/** * 微光模式下，更新數據 */
fun onUpdateAmbient() {
    refreshData()
}
複製代碼

若是界面上有時間顯示，能夠考慮在正常狀況下顯示到秒，在微光模式下只顯示到分鐘。

兼容 FragmentActivity

以上就完成了一個 Activity 微光模式的適配，但它有個缺點，必需要繼承 WearableActivity。不少時候咱們要用到 Fragment，必需要繼承 FragmentActivity 才能夠。

如今，官方也給出了一種兼容方案，咱們繼承 FragmentActivity 後實現 AmbientModeSupport.AmbientCallbackProvider 這個接口，在 onCreate 中調用 AmbientModeSupport.attach(this)，像這樣：

class MainActivity : FragmentActivity(),
    AmbientModeSupport.AmbientCallbackProvider {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        AmbientModeSupport.attach(this)
    }

    override fun getAmbientCallback(): AmbientModeSupport.AmbientCallback {
        return object : AmbientModeSupport.AmbientCallback() {

            override fun onEnterAmbient(ambientDetails: Bundle) {}

            override fun onExitAmbient() {}
            
            override fun onUpdateAmbient() {}
        }
    }
}
複製代碼

這樣，咱們就能在 AmbientCallback 拿到微光模式的相關回調了。

此外，AmbientModeSupport.attach(this) 會返回一個 AmbientController，經過它咱們能夠主動去獲取當前是否處於微光模式。

離開 Activity 時的狀態監聽

當 Activity 退到後臺時，上述的幾個回調方法將不會再收到回調。

大部分狀況下，在 Activity 不可見的時候，咱們也不須要監聽微光模式作處理，在 Activity 返回前臺的時候，必然是退出了微光模式的。

但在某些狀況下仍是有這樣的需求，好比微光模式下要對通知欄作一些特殊處理。這時候只能另闢蹊徑獲取到回調：

val handler = Handler(Looper.getMainLooper())
val displayManager = getSystemService(Context.DISPLAY_SERVICE) as DisplayManager
displayManager.registerDisplayListener(object : DisplayManager.DisplayListener {
    override fun onDisplayAdded(displayId: Int) {

            }

    override fun onDisplayRemoved(displayId: Int) {

            }

    override fun onDisplayChanged(displayId: Int) {
        if (displayManager.getDisplay(displayId).state == Display.STATE_DOZE) {
            // 進入微光模式

        } else {
            // 退出微光模式

        }
    }
}, handler)
複製代碼

這個方法的本質是監聽屏幕進入省電模式。因爲進入微光模式伴隨着進入屏幕的省電模式，能夠認爲它們的監聽方法是等效的。

實測在返回桌面後，這個方法一樣能收到回調。要記得在 onDestroy 裏反註冊。

妥妥的。