ซิงค์ข้อมูล

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

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

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

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

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

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

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

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

  หมายเหตุ: เมื่อถอนการติดตั้งแอปในโทรศัพท์ รายการข้อมูลและเนื้อหาจะถูก รีเซ็ต

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

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

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

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

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

โอนข้อมูล

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

หมายเหตุ: Data Layer API จะส่งข้อความและซิงค์ข้อมูลกับโทรศัพท์ Android เท่านั้น หรือ นาฬิกา Wear OS หากอุปกรณ์ Wear OS จับคู่กับอุปกรณ์ iOS ชั้นข้อมูล API ไม่ทำงาน

ด้วยเหตุนี้ อย่าใช้ Data Layer API เป็นวิธีหลักในการ สื่อสารกับเครือข่าย แต่ให้ใช้รูปแบบเดียวกันในแอป Wear อย่างเช่น ของแอปบนอุปกรณ์เคลื่อนที่ ซึ่งมีความแตกต่างอยู่บ้างตามที่อธิบายไว้ใน การเข้าถึงเครือข่ายและการซิงค์ใน Wear OS

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

หมายเหตุ: แม้ว่าในทางทฤษฎีแล้วขนาดของรายการข้อมูลจะจำกัดอยู่ที่ 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