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

クライアントの種類の選択

Wear OS のデータレイヤー API は、いくつかの異なるタイプのクライアントで構成されています。さまざまな種類のデータに対して、またあります。

このページでは各クライアントタイプについて紹介し、それぞれのタイプを比較した表も掲載しています。異なるクライアントの機能を提供します。この情報を使ってアプリに最適なクライアントタイプのセットです。

データクライアント

DataClient オブジェクトを使用すると、DataItem または Asset:

各 DataItem は、ブロードキャストおよび同期される情報の単位です。ユーザーが所有する付近のすべてのデバイスで自動的に配信されますDataItem は永続的に保存されます。そのデータアイテムが削除されるまで、デバイスはその内容を読み取ることができます。
Asset は、画像やメディアファイルなど、より大きなデータペイロードに適しています。

MessageClient オブジェクトはメッセージを送信でき、リモートプロシージャに適しています。呼び出し（RPC）（Wear OS デバイスを使用してアプリのバージョンを制御するなど）モバイルデバイスにインストールされる場合です。

メッセージは、sendMessage() を使用した一方向のリクエストや、 sendRequest() を使用したリクエスト / レスポンス通信モデル。データの場合と異なり接続するにはノードをネットワークに接続する必要があります。メッセージを送信できます。

sendMessage() メソッドは、リモートノードに配信するベストエフォートです。組み込みの再試行メカニズムはありません。対象デバイスがネットワーク転送の開始前に切断されると、メソッドは TARGET_NODE_NOT_CONNECTED。

ChannelClient オブジェクトは、ネットワーク間でのストリーム指向の通信をできます。チャネルは、2 つのノード間の双方向通信パイプです。これは、次のようなユースケースに役立ちます。

インターネットに接続している 2 台以上のデバイス間でデータファイルを転送できる使用できませんChannelClient は、DataClient と同期する前に、ローカルデバイスにアセットのコピーを作成します。接続します。
サイズが大きすぎて MessageClient では送信できないファイルを確実に送信できます。
マイクから入力された音声データなどのストリーミングデータを転送します。

チャネルを開くと、連続バイトでデータを送受信できます。データクライアントが必要とする個別の DataItem 単位ではなく、ストリームを使用します。

データフローの管理とデータの整合性の維持は、お客様の責任となります。チャネルクライアントには同じレベルの自動データ同期がない同じです

次の表は、各クライアントの機能を比較したものです。

クライアントの種類	データの永続化	100 KB を超えるデータに対応	使用するネットワーク	オフラインでの動作
データクライアント	データは無期限に保持される	○（ `Asset` オブジェクト）	Bluetooth を推奨。データがクラウドにバックアップされる。Bluetooth がこのバックアップは非同期で行われます。	○（読み取りと書き込みの両方）
メッセージクライアント	永続性なし、再試行なし	×	Bluetooth が推奨されますが、Wi-Fi が唯一のタイプの Wi-Fi であれば使用できます接続が利用可能	×
チャネルクライアント	永続性なし（接続指向）	○	Bluetooth が推奨されますが、Wi-Fi が唯一のタイプの Wi-Fi であれば使用できます接続が利用可能	×