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

SouthernBox發表於2018-12-17
模式

微光模式

智慧手錶的電池容量都比較低，導致續航也比較短。為了延長手錶的續航，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 DisplayManagerdisplayManager.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 裡反註冊。

妥妥的。

來源：https://juejin.im/post/5c17a1996fb9a049a570d0c6

相關文章