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 裡反註冊。
妥妥的。