ウォッチフェイス プッシュ用にスマートフォン アプリを設定

正規のマーケットプレイスでは、ユーザーがアプリを操作する主な方法は電話アプリです。

ウォッチフェイスを設定する

ユーザーがスマートフォン アプリでウォッチフェイスを選択すると、ウォッチフェイスを設定する後続のフローは次の 2 つの部分に分かれます。

  1. インストール: MessageClient から開始される Watch Face Push を使用して、ウォッチフェイスをインストールします。このステップは簡単で、addWatchFace または updateWatchFace のいずれかを使用し、スマートフォンからスマートウォッチへの MessageClient を使用してトリガーします。
  2. アクティベーション: インストール済みのウォッチフェイスをアクティブに設定します。このステップには、権限の状態に応じて複数のパスがあります。
    • 対応は不要な場合があります。マーケットプレイスがアクティブなウォッチフェイスをすでに制御している可能性があります。
    • ユーザーの介入が必要ない場合があります。アプリにはアクティブなウォッチフェイスを設定するために必要な権限があり、setWatchFaceAsActive() を使用して直接設定できます。
    • 権限リクエストの承認方法、または長押しジェスチャーやコンパニオン アプリを使用してウォッチフェイスを手動で設定する方法について、ガイダンスが必要になる場合があります。

インストール レスポンス

アクティベーション フェーズを容易にするため、インストール フェーズでは、スマートウォッチからスマートフォンに次の情報を返す必要があります。

  • インストール試行の結果
  • isWatchFaceActive() の結果 - アプリにアクティブなウォッチフェイスがすでに存在するかどうかを判断します。
  • setWatchFaceAsActive() が過去に呼び出されたかどうか - Wear OS アプリは、この情報をローカルで追跡して保持する必要があります。この API 呼び出しは 1 回しか使用できません。

有効化

インストール後、アプリにアクティブなウォッチフェイスがすでに設定されていることを示すレスポンスが返されることがあります。ただし、そうでない場合は、アプリでウォッチフェイスをアクティブに設定するボタンを表示することを選択できます。

シナリオ 1: アクティブなウォッチフェイスを設定する試行がすべて完了した

インストールからのレスポンスで setWatchFaceAsActive() が過去に呼び出されたことがあることが示された場合、ボタンはスマートフォンの説明画面に移動し、ユーザーがウォッチフェイスを長押しして手動で希望のウォッチフェイスに設定する方法が表示される必要があります。

シナリオ 2 - アクティブなウォッチフェイスを設定しようとする

スマートフォンは、必要な SET_PUSHED_WATCH_FACE_AS_ACTIVE 権限を確認するようスマートウォッチに指示する必要があります。

  • ユーザーがすでに権限を付与している場合は、setWatchFaceAsActive() の呼び出しに進みます。
  • ユーザーが以前に権限を拒否している場合、スマートウォッチはこれをスマートフォンに伝え、スマートフォンで権限の必要性と手動で付与する方法を説明する教育画面を表示できるようにする必要があります。

  • 以前に権限がリクエストされていない場合、スマートウォッチはスマートフォンに、スマートウォッチで権限を承認する方法をユーザーに説明する教育用モーメントを表示するよう指示し、スマートウォッチは権限のリクエストに進む必要があります。

    • ユーザーが権限を付与した場合、スマートウォッチは setWatchFaceAsActive() を呼び出す必要があります。
    • それ以外の場合、スマートウォッチは、権限の必要性と手動で権限を付与する方法を説明する教育画面を表示するようスマートフォンに指示する必要があります。