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 里反注册。

妥妥的。