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

ユーザーがスマートウォッチを使用しなくなった場合、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() を呼び出してオブザーバーを削除します。たとえば、Terraform でこのメソッドを呼び出して、 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。

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

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

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

これを行う方法の例については、Compose ベースの GitHub の演習サンプルでは、AmbientAware Horologist ライブラリのコンポーザブルを使用します。