Data Layer API を使用してネットワーク上のデバイスを検出する

デバイスは、Wi-Fi 接続またはモバイル接続を使用して直接、またはペア設定された Bluetooth デバイスを介して間接的に、インターネットへの接続を確立できます。

到達可能なノードと近くのノード

デバイスがオンラインで、Bluetooth を介して直接、またはクラウドを仲介して間接的に別のデバイスと通信できる場合、そのデバイスは到達可能とみなされます。

デバイスが近くにあると見なされるのは、クラウドを使用せずに Bluetooth 経由で直接接続できる場合です。

再接続時間に影響するアクティビティ

状況によっては、デバイスが接続を再確立するまでに最大 4 分かかることがあります。たとえば、次のような場合です。

  • Wear OS デバイスが非アクティブな場合: Wear OS デバイスがユーザーの手首から外された場合や、長時間使用されていない場合は、再接続時間が長くなる可能性があります。
  • Doze 状態: ハンドヘルドの省電力 Doze 状態では、バックグラウンド プロセスが制限され、デバイスの再接続時間が長くなる可能性があります。
  • ユーザー操作: ユーザーがハンドヘルド デバイスと Wear OS デバイスの両方をほぼ同時に操作し始めると、再接続プロセスが迅速化されることがよくあります。

ノード クライアントを使用してすべてのデバイスを検出する

NodeClient オブジェクトは、各デバイスの機能に関係なく、ネットワークに接続されている Android 搭載デバイスのリストを識別してブロードキャストします。デバイス上のすべてのアプリは、新しいデバイスがネットワークに参加した、既存のデバイスがオフラインになったなどのアクティビティ通知を受け取ります。

NodeClient クラスは、アプリがインストールされていないデバイスを検出する場合に特に役立ちます。

デバイスの接続イベントと切断イベントを登録するには、Horologist の DataLayerAppHelper クラスを使用します。接続状態を監視するための connectedAndInstalledNodes Flow が用意されています。また、connectedNodes() メソッドは、NodeClient と CapabilityClient の両方の情報を 1 つのオブジェクトに結合して、接続済みデバイスのリストを返します。

機能クライアントを使用して特定のデバイスを検出する

CapabilityClient オブジェクトは、Wear OS ネットワーク上のどのデバイスが特定のアプリ機能をサポートしているかに関する情報を提供します。機能とは、アプリがビルド時に定義するか、実行時に動的に構成する機能のことです。

たとえば、モバイルの Android アプリは、動画再生のリモート コントロールをサポートしていることをアドバタイズできます。そのアプリの Wear OS バージョンは、CapabilityClient を使用して、アプリのモバイル バージョンが付近のデバイスにインストールされているかどうか、またその機能がサポートされているかどうかを確認できます。サポートしている場合、Wear OS アプリによって再生ボタンと一時停止ボタンが表示され、ユーザーはモバイル デバイスで再生中の動画を Wear OS デバイスから操作できます。機能ブロードキャストは逆方向にも機能します。Wear OS アプリは、サポートする機能を一覧表示できます。

ビルド時に機能を定義するには、アプリの検出に使用する機能の名前を指定するに記載されているように、res/values/wear.xml で android_wear_capabilities という名前の string-array リソースを宣言します。リソースの圧縮によって android_wear_capabilities が未使用として削除されないようにするには、res/values/wear.xml ではなく、res/raw/ ディレクトリ内の別の保持ファイル(res/raw/keep.xml など)で tools:keep="@array/android_wear_capabilities" を指定します。keep ファイルの構文については、保持するリソースのカスタマイズをご覧ください。

アプリの新機能を確認する

CapabilityClient を使用して、通信する必要があるデバイスのノード ID を特定します。たとえば、ハンドヘルド デバイス上のアプリに新機能が存在するかどうかを確認する必要がある場合は、ハンドヘルド側でその新機能のケーパビリティを作成します。Wear OS アプリは、その機能をサポートするデバイスをクエリできます。すべてのデバイスでこの機能が欠落している場合は、この機能をサポートするバージョンのアプリがユーザーにインストールされていないことを意味します。この状況は、アプリのロジックで適切に処理する必要があります。ハンドヘルド デバイスが常に通信する正しいノードであると想定すると、電話アプリがこの機能をサポートしていないため、メッセージが配信されない可能性があります。

Wear OS デバイスがネットワーク上の唯一のデバイスかどうかを判断する

CapabilityClient を使用すると、近くに他の Android 搭載デバイスがないため、アプリをスタンドアロン モードで動作させる必要があるかどうかを確認できます。FILTER_ALL を渡すと、他のデバイスは結果に表示されません。