ซิงค์ข้อมูล

เอกสารนี้อธิบายวิธีซิงค์ข้อมูลระหว่างอุปกรณ์ Wear OS กับ มือถือ

ส่งและซิงค์ข้อมูลโดยตรงจากเครือข่าย

สร้างแอป Wear OS เพื่อสื่อสารกับเครือข่ายโดยตรง ใช้ API ที่คุณใช้สำหรับการพัฒนาบนอุปกรณ์เคลื่อนที่ แต่เก็บบางรายการสำหรับ Wear-OS ไว้ ให้คำนึงถึงความแตกต่าง

ซิงค์ข้อมูลโดยใช้ API ชั้นข้อมูลของ Wear OS

DataClient แสดง API สำหรับคอมโพเนนต์ให้อ่านหรือเขียนไปยัง DataItem หรือ Asset

คุณอาจตั้งค่ารายการข้อมูลและเนื้อหาในขณะที่ไม่ได้เชื่อมต่อกับอุปกรณ์ใดๆ ได้ โดยจะซิงค์ข้อมูลเมื่ออุปกรณ์สร้างการเชื่อมต่อเครือข่าย ข้อมูลนี้ เป็นแบบส่วนตัวและเข้าถึงได้เฉพาะแอปของคุณในอุปกรณ์อื่นเท่านั้น

  • DataItem ซิงค์ข้อมูลในอุปกรณ์ทุกเครื่องในเครือข่าย Wear OS แล้ว โดยทั่วไปแล้วจะมีขนาดเล็ก

  • ใช้ Asset เพื่อโอนวัตถุขนาดใหญ่ เช่น รูปภาพ ระบบ ติดตามว่ามีการโอนและดำเนินการกับเนื้อหาใดบ้าง การกรองข้อมูลที่ซ้ำกันออกโดยอัตโนมัติ

ฟังเหตุการณ์ในบริการต่างๆ

ขยายชั้นเรียน WearableListenerService ระบบจะจัดการ วงจรชีวิตของฐาน WearableListenerService ซึ่งผูกกับบริการเมื่อ ต้องส่งรายการข้อมูลหรือข้อความและยกเลิกการเชื่อมโยงบริการเมื่อไม่มีการดำเนินการ ที่จำเป็น

ฟังเหตุการณ์ในกิจกรรม

ใช้อินเทอร์เฟซ OnDataChangedListener ใช้อินเทอร์เฟซนี้แทน ของWearableListenerServiceเมื่อคุณต้องการฟังการเปลี่ยนแปลงเฉพาะเมื่อ ผู้ใช้กำลังใช้แอปของคุณอยู่

โอนข้อมูล

เพื่อส่งวัตถุขนาดใหญ่ไบนารีผ่านการรับส่งข้อมูลบลูทูธ เช่น การบันทึกเสียง จากอุปกรณ์อีกเครื่องหนึ่ง คุณสามารถแนบ Asset ไปยังรายการข้อมูล แล้ววางรายการข้อมูลลงในพื้นที่เก็บข้อมูลที่จำลอง

ชิ้นงานจะจัดการการแคชข้อมูลโดยอัตโนมัติเพื่อป้องกันการส่งซ้ำและ เพื่อประหยัดแบนด์วิดท์ของบลูทูธ รูปแบบที่พบได้บ่อยสำหรับให้แอปมือถือดาวน์โหลดรูปภาพ แล้วย่อรูปให้มีขนาดที่เหมาะสม สำหรับแสดงบนอุปกรณ์ที่สวมใส่ได้ และส่งไปยังแอปสำหรับอุปกรณ์ที่สวมใส่ได้เป็นเนื้อหา ตัวอย่างต่อไปนี้ ที่สาธิตลายนี้

หมายเหตุ: แม้ว่าในทางทฤษฎีแล้วขนาดของรายการข้อมูลจะจำกัดอยู่ที่ 100 KB แต่ในทางปฏิบัติ สามารถใช้รายการข้อมูลที่มีขนาดใหญ่กว่าได้ สำหรับ รายการข้อมูลที่ใหญ่กว่า แยกข้อมูลตามเส้นทางที่ไม่ซ้ำ และหลีกเลี่ยง โดยใช้เส้นทางเดียว สำหรับข้อมูลทั้งหมด การโอนเนื้อหาขนาดใหญ่ส่งผลต่อประสบการณ์ของผู้ใช้ในหลายๆ ดังนั้น โปรดทดสอบแอปเพื่อให้มั่นใจว่าแอปทำงานได้ดีเมื่อโอนเนื้อหาขนาดใหญ่

โอนเนื้อหา

สร้างเนื้อหาโดยใช้วิธีใดวิธีหนึ่งใน create...() ใน Asset ชั้นเรียน แปลงบิตแมปเป็นสตรีมไบต์แล้วเรียกใช้ 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());
}

จากนั้นแนบชิ้นงานไปกับรายการข้อมูลโดยใช้เมธอด putAsset() ใน DataMap หรือ PutDataRequest จากนั้นวางรายการข้อมูลลงในพื้นที่เก็บข้อมูลโดยใช้ 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);

รับเนื้อหา

เมื่อสร้างเนื้อหาแล้ว คุณอาจต้องการอ่านและแตกข้อมูล ที่อีกด้านหนึ่งของการเชื่อมต่อ ต่อไปนี้เป็นตัวอย่างวิธีใช้ Callback เพื่อตรวจหาการเปลี่ยนแปลงชิ้นงานและดึงข้อมูลชิ้นงาน โดยทําดังนี้

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);
}

สำหรับข้อมูลเพิ่มเติม โปรดดูโปรเจ็กต์ตัวอย่าง DataLayer ใน GitHub