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

データを同期する

このドキュメントでは、Wear OS デバイスとアクセスできるようになります。

ネットワークから直接データを送信、同期する

ネットワークと直接通信する Wear OS アプリを作成します。同じものを使用するモバイル開発に使用する API（一部は Wear OS 固有のもの）念頭に置いてください

Wear OS Data Layer API を使用してデータを同期する

DataClient は、コンポーネントが DataItem または Asset。

どのデバイスにも接続していないときでも、データアイテムとアセットを設定できます。デバイスがネットワーク接続を確立すると同期されます。このデータはは自分のアプリにのみ公開され、他のデバイスの自分のアプリからのみアクセスできます。

DataItem は、Wear OS ネットワーク内のすべてのデバイスで同期されます。一般的に小さいサイズです。

注: スマートフォンからアプリをアンインストールすると、リセットできます。
画像などの大きなオブジェクトを転送するには、Asset を使用します。システムどのアセットがすでに転送されたかを追跡し自動的に行われます。

サービスのイベントをリッスンする

WearableListenerService クラスを拡張します。システムはベース WearableListenerService のライフサイクル（変更時にサービスにバインド）処理がない場合に、データアイテムまたはメッセージを送信し、サービスをバインド解除する必要がある必要ありません。

アクティビティ内のイベントをリッスンする

OnDataChangedListener インターフェースを実装します。代わりにこのインターフェースを使用変更された場合のみリッスンする場合は、WearableListenerService の把握するのに役立ちます

データを移行する

音声録音など、バイナリラージオブジェクトを Bluetooth 経由で送信するため別のデバイスから転送する場合は、 <ph type="x-smartling-placeholder"></ph> Asset をデータアイテムに追加してから、そのデータアイテムを複製されたデータストアに配置します。

アセットは、再送信を防止し、Bluetooth の帯域幅を節約するために、データのキャッシュ保存を自動的に処理します。よくあるパターンとして、ハンドヘルドアプリで画像をダウンロードし、それをウェアラブルで表示するために適切なサイズに縮小して、ウェアラブルアプリにアセットとして送信するというものがあります。以下の例で、このパターンについて説明します。

注: データアイテムのサイズは、理論的には 100 KB に制限されていますが、実際には、より大きなデータアイテムを使用できます。大規模なデータアイテムの場合、デベロッパーは一意のパスでデータを分離し、すべてのデータに単一のパスを使用しないようにします。大規模なアセットを転送すると、多くの場合、ユーザーエクスペリエンスに影響します。そのため、アプリをテストして、大規模なアセットを転送しても良好なパフォーマンスが得られることを確認してください。

アセットを転送する

Asset クラスで create...() メソッドのいずれかを使用してアセットを作成します。以下のサンプルに示すように、ビットマップをバイトストリームに変換し、createFromBytes() を呼び出してアセットを作成します。

Kotlin

private fun createAssetFromBitmap(bitmap: Bitmap): Asset =
    ByteArrayOutputStream().let { byteStream ->
        bitmap.compress(Bitmap.CompressFormat.PNG, 100, byteStream)
        Asset.createFromBytes(byteStream.toByteArray())
    }

Java

private static Asset createAssetFromBitmap(Bitmap bitmap) {
    final ByteArrayOutputStream byteStream = new ByteArrayOutputStream();
    bitmap.compress(Bitmap.CompressFormat.PNG, 100, byteStream);
    return Asset.createFromBytes(byteStream.toByteArray());
}

次に、DataMap または PutDataRequest で putAsset() メソッドを使用して、アセットをデータアイテムにアタッチします。次に、 <ph type="x-smartling-placeholder"></ph> putDataItem() メソッドを使用します。

次のサンプルでは PutDataRequest を使用します。

Kotlin

val asset: Asset = BitmapFactory.decodeResource(resources, R.drawable.image).let { bitmap ->
    createAssetFromBitmap(bitmap)
}
val request: PutDataRequest = PutDataRequest.create("/image").apply {
    putAsset("profileImage", asset)
}
val putTask: Task<DataItem> = Wearable.getDataClient(context).putDataItem(request)

Java

Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.image);
Asset asset = createAssetFromBitmap(bitmap);
PutDataRequest request = PutDataRequest.create("/image");
request.putAsset("profileImage", asset);
Task<DataItem> putTask = Wearable.getDataClient(context).putDataItem(request);

次のサンプルでは PutDataMapRequest を使用します。

Kotlin

val asset: Asset = BitmapFactory.decodeResource(resources, R.drawable.image).let { bitmap ->
    createAssetFromBitmap(bitmap)
}
val request: PutDataRequest = PutDataMapRequest.create("/image").run {
    dataMap.putAsset("profileImage", asset)
    asPutDataRequest()
}
val putTask: Task<DataItem> = Wearable.getDataClient(context).putDataItem(request)

Java

Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.image);
Asset asset = createAssetFromBitmap(bitmap);
PutDataMapRequest dataMap = PutDataMapRequest.create("/image");
dataMap.getDataMap().putAsset("profileImage", asset);
PutDataRequest request = dataMap.asPutDataRequest();
Task<DataItem> putTask = Wearable.getDataClient(context).putDataItem(request);

アセットを受け取る

アセットを作成したら、接続の反対側でアセットの読み取りや抽出を行います。以下の例は、アセットの変更を検出してそのアセットを抽出するコールバックの実装方法を示しています。

Kotlin

override fun onDataChanged(dataEvents: DataEventBuffer) {
    dataEvents
            .filter { it.type == DataEvent.TYPE_CHANGED && it.dataItem.uri.path == "/image" }
            .forEach { event ->
                val bitmap: Bitmap? = DataMapItem.fromDataItem(event.dataItem)
                        .dataMap.getAsset("profileImage")
                        .let { asset -> loadBitmapFromAsset(asset) }
                // Do something with the bitmap
            }
}

fun loadBitmapFromAsset(asset: Asset): Bitmap? {
    // Convert asset into a file descriptor and block until it's ready
    val assetInputStream: InputStream? =
            Tasks.await(Wearable.getDataClient(context).getFdForAsset(asset))
            ?.inputStream

    return assetInputStream?.let { inputStream ->
        // Decode the stream into a bitmap
        BitmapFactory.decodeStream(inputStream)
    } ?: run {
        Log.w(TAG, "Requested an unknown Asset.")
        null
    }
}

Java

@Override
public void onDataChanged(DataEventBuffer dataEvents) {
  for (DataEvent event : dataEvents) {
    if (event.getType() == DataEvent.TYPE_CHANGED &&
        event.getDataItem().getUri().getPath().equals("/image")) {
      DataMapItem dataMapItem = DataMapItem.fromDataItem(event.getDataItem());
      Asset profileAsset = dataMapItem.getDataMap().getAsset("profileImage");
      Bitmap bitmap = loadBitmapFromAsset(profileAsset);
      // Do something with the bitmap
    }
  }
}

public Bitmap loadBitmapFromAsset(Asset asset) {
    if (asset == null) {
        throw new IllegalArgumentException("Asset must be non-null");
    }
    // Convert asset into a file descriptor and block until it's ready
    InputStream assetInputStream =
        Tasks.await(Wearable.getDataClient(context).getFdForAsset(asset))
            .getInputStream();
    if (assetInputStream == null) {
        Log.w(TAG, "Requested an unknown Asset.");
        return null;
    }
    // Decode the stream into a bitmap
    return BitmapFactory.decodeStream(assetInputStream);
}

詳しくは、GitHub の DataLayer サンプルプロジェクトをご覧ください。