常時オンアプリとシステムのアンビエント モード

キーワード: wear、ambient、alwayson

ユーザーがスマートウォッチを使用しなくなった場合、Wear OS はアクティブなアプリの省電力モードへの移行を自動的に処理します。これを、システムの「常に画面表示モード」と呼びます。ユーザーが一定の期間内にスマートウォッチを再度操作すると、Wear OS は中断した箇所からアプリの表示を再開します。

たとえば、ランニング中に心拍数とペースを確認する場合のような特定のユースケースでは、省電力の常に画面表示モードで表示する内容を制御することもできます。常に画面表示モードとインタラクティブ モードの両方で実行される Wear OS アプリは、常時オンアプリと呼ばれます。

アプリを常に表示すると電池寿命に影響するため、この機能をアプリに追加する場合は電池寿命への影響を考慮してください。

プロジェクトを構成する

常に画面表示モードをサポートする手順は次のとおりです。

  1. ウェアラブル アプリの作成と実行ページの設定に基づいて、プロジェクトを作成または更新します。
  2. WAKE_LOCK 権限を Android マニフェスト ファイルに追加します。
<uses-permission android:name="android.permission.WAKE_LOCK" />

常時オンモードを有効にする

AmbientLifecycleObserver クラスを使用するには、次の操作を行います。

  1. 次の例のように、 AmbientLifecycleObserver.AmbientLifecycleCallback インターフェースを実装します。この段階では各メソッドは空ですが、このガイドの後半では「常に画面表示モード」の開始と終了の視覚効果に加える必要がある変更について詳しく説明します。

    Kotlin

    val ambientCallback = object : AmbientLifecycleObserver.AmbientLifecycleCallback {
    override fun onEnterAmbient(ambientDetails: AmbientLifecycleObserver.AmbientDetails) {
    // ... Called when moving from interactive mode into ambient mode.
    }

    override fun onExitAmbient() {
    // ... Called when leaving ambient mode, back into interactive mode.
    }

    override fun onUpdateAmbient() {
    // ... Called by the system in order to allow the app to periodically
    // update the display while in ambient mode. Typically the system will
    // call this every 60 seconds.
    }
}
  2. AmbientLifecycleObserver を作成し、オブザーバーを登録します。通常、Wear OS 用 Compose を使用している場合は、onCreate() またはトップレベル コンポーザブルで使用して、アクティビティのライフサイクル全体で常時オン動作を有効にできるようにします。

    Kotlin

    private val ambientObserver = AmbientLifecycleObserver(activity, callback)

override fun onCreate(savedInstanceState: Bundle) {
  super.onCreate(savedInstanceState)
  lifecycle.addObserver(observer)

  // ...
}
  3. 常時オン動作が不要になったら、removeObserver() を呼び出してオブザーバーを削除します。たとえば、アクティビティの onDestroy() メソッドで呼び出します。

常時オンアプリをバックグラウンドに移動できる

Wear OS 5 以降、常時オンアプリは、アンビエント モードで一定の時間が経過するとバックグラウンドに移動します。ユーザーはシステム設定でタイムアウトを構成できます。

常時オンのアプリで、音楽の再生やワークアウト セッションなど、進行中のユーザー タスクに関する情報を表示する場合は、タスクが終了するまで進行中のアクティビティを表示しておくことができます。そのためには、Ongoing Activity API を使用して、常時アクティブなアクティビティにリンクされた進行中の通知を投稿します。

システムが進行中のアクティビティを認識するには、進行中の通知のタップ インテントを常時アクティブなアクティビティに指すようにする必要があります。次のコード スニペットをご覧ください。

// Create a pending intent that point to your always-on activity
val touchIntent =
    PendingIntent.getActivity(
        context,
        0,
        Intent(context, MyAlwaysOnActivity::class.java),
        PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )

val notificationBuilder =
    NotificationCompat.Builder(this, CHANNEL_ID)
    // ...
    .setOngoing(true)

val ongoingActivity =
    OngoingActivity.Builder(
        applicationContext, NOTIFICATION_ID, notificationBuilder
    )
    // ...
    .setTouchIntent(touchIntent)
    .build()

ongoingActivity.apply(applicationContext)

notificationManager.notify(
    NOTIFICATION_ID,
    notificationBuilder.build()
)

「常に画面表示モード」での外観を変更する

デフォルトでは、常時オンを実装しても、スマートウォッチが「常に画面表示モード」になったときの画面の外観は変わりません。この動作を変更するには、AmbientLifecycleCallback のメソッドをオーバーライドします。

バッテリーを節約するには、次のようにします。

  • 明るいピクセルを減らし、画面の大部分を黒にします。「常に画面表示モード」では重要な情報のみを表示することを検討し、インタラクティブ モードに入ったときに詳細な情報を表示します。
  • 更新頻度が低くなるようコンテンツを調整します。たとえば、タイマーを秒単位ではなく分単位で表示します。
  • onEnterAmbient() に渡される AmbientDetails オブジェクトで、次のようにします。
    • deviceHasLowBitAmbient が設定されている場合、可能であればアンチ エイリアスを無効にします。
    • burnInProtectionRequired が設定されている場合、表示を定期的にシフトし、白く塗りつぶされた領域がないようにします。

Wear OS 用 Compose を使用する場合は、これらのコールバック メソッドを使用して「状態」を更新することをおすすめします。そうすることによって、システムが UI を適切に再コンポーズできるようになります。

これを実現する方法の例については、GitHub の Compose ベースの Exercise サンプルをご覧ください。このサンプルでは、Horologist ライブラリの AmbientAware コンポーザブルを使用しています。