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

正規のショッピングモールの場合、ユーザーがアプリを操作する主な方法はスマートフォン アプリです。

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

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

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

インストール レスポンス

有効化フェーズを容易にするため、インストールフェーズでは、スマートウォッチからスマートフォンに次の情報を返す必要があります。

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

アクティベーション

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

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

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

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

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

  • ユーザーがすでに権限を付与している場合は、setWatchFaceAsActive() の呼び出しに進みます。
  • ユーザーが以前に権限を拒否した場合、スマートウォッチはこれをスマートフォンに通知します。スマートフォンでは、権限の必要性と手動で権限を付与する方法について説明する情報画面が表示されます。

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

    • ユーザーが権限を付与すると、スマートウォッチは setWatchFaceAsActive() を呼び出します。
    • 許可されない場合は、スマートウォッチからスマートフォンに、権限の必要性と手動で権限を付与する方法について説明する情報画面を表示するよう指示する必要があります。