NanBox

Anroid Wear OS 手表应用开发 - 微光模式 AmbientMode

智能手表的电池容量都比较低,导致续航也比较短。为了延长手表的续航,Wear OS 手表在没有操作一段时间后,会进入微光模式 AmbientMode。

微光模式就是一个省电模式,这个模式会在低功耗下运行,默认情况下,手表会离开当前的应用,返回到表盘的界面。

但有时候,我们希望开发的应用在某些情况下,可以一直保持可见的状态,这就需要我们使用支持微光模式的 Activity 了。

项目配置

  • build.gradle 配置

添加以下依赖项:

1
2
3
4
5
dependencies {
...
implementation 'com.google.android.support:wearable:2.4.0'
compileOnly 'com.google.android.wearable:wearable:2.4.0'
}
  • manifest 配置

添加穿戴设备共享库(仅支持 Android 5.1 及以上版本):

1
2
3
4
5
6
<application>
<uses-library
android:name="com.google.android.wearable"
android:required="true" />
...
</application>

添加保持唤醒权限:

1
<uses-permission android:name="android.permission.WAKE_LOCK" />

支持微光模式的 Activity

修改需要支持微光模式的 Activity,让它继承 WearableActivity,并在 onCreate 中调用 setAmbientEnabled():

1
2
3
4
5
6
7
class MainActivity : WearableActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setAmbientEnabled()
}
}

处理模式切换

现在,我们的 Activity 在进入微光模式后,会仍然保持可见。但随着系统功耗的降低,定时器、屏幕刷新率等都会受到影响。

为了用户体验、也为了节省电量,我们需要在进入微光模式的时候做一些处理。

在微光模式下,建议隐藏所有非必要内容,将页面背景换成黑色,字体颜色换成白色。再更进一步,可以停用所有文字的抗锯齿。然后在离开微光模式的时候,恢复成原来的样子。

WearableActivity 的 onEnterAmbient 和 onExitAmbient 方法会在进入和离开微光模式时调用。举个简单的例子,我们可以这样来处理:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
/**
* 进入微光模式
*/
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() ,它会以每分钟一次的频率回调这个方法:

1
2
3
4
5
6
/**
* 微光模式下,更新数据
*/
fun onUpdateAmbient() {
refreshData()
}

如果界面上有时间显示,可以考虑在正常情况下显示到秒,在微光模式下只显示到分钟。

兼容 FragmentActivity

以上就完成了一个 Activity 微光模式的适配,但它有个缺点,必须要继承 WearableActivity。很多时候我们要用到 Fragment,必须要继承 FragmentActivity 才可以。

现在,官方也给出了一种兼容方案,我们继承 FragmentActivity 后实现 AmbientModeSupport.AmbientCallbackProvider 这个接口,在 onCreate 中调用 AmbientModeSupport.attach(this),像这样:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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 返回前台的时候,必然是退出了微光模式的。

但在某些情况下还是有这样的需求,比如微光模式下要对通知栏做一些特殊处理。这时候只能另辟蹊径获取到回调:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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 里反注册。

妥妥的。