このページは Cloud Translation API によって翻訳されました。

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

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

特定のユースケース（例: ユーザーがエクササイズ中に心拍数とペースを確認したい場合）ランニング - あなたまた、常に画面表示モードで表示する情報も管理できます。実行される Wear OS アプリ常に画面表示モードとインタラクティブモードの両方を常時オンアプリと呼びます。

アプリを常に表示するとバッテリー駆動時間に影響するため、追加する際はその影響を考慮してください追加できます

プロジェクトを構成する

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

プロジェクトの構成に基づいて、プロジェクトを作成または更新します。作成ウェアラブルアプリのページをご覧ください。
Android マニフェストファイルに WAKE_LOCK 権限を追加します。

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

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

<ph type="x-smartling-placeholder"></ph>を使用するには AmbientLifecycleObserver クラスを使用して、次の操作を行います。

を実装する 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.
    }
}

AmbientLifecycleObserver を作成し、オブザーバーを登録します。通常、この Wear OS 向け Compose を使用している場合は、onCreate() またはトップレベルコンポーザブルで使用します。これにより、アクティビティのライフサイクル全体で常時オン動作を有効にできます。
Kotlin
```
private val ambientObserver = AmbientLifecycleObserver(activity, callback)

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

  // ...
}
```
オブザーバーを削除するには、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">
- deviceHasLowBitAmbient が設定されている場合、可能であればアンチエイリアスを無効にします。
- burnInProtectionRequired が設定されている場合、表示をシフトする白く点灯しないようにします。

Wear OS 向け Compose を使用する場合は、次のコールバックメソッドを使用することをおすすめします。更新して状態を更新し、システムが UI を適切に構成する必要があります。

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

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

プロジェクトを構成する

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

Kotlin

Kotlin

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

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

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