Wear OS का डेटा, नए मोबाइल डिवाइस पर ट्रांसफ़र करें

जब उपयोगकर्ता Wear OS डिवाइस को सेट अप करते हैं, तो वे Wear OS डिवाइस को किसी मोबाइल डिवाइस पर. उपयोगकर्ता बाद में नया मोबाइल डिवाइस खरीदने का फ़ैसला ले सकता है और उनके मौजूदा Wear OS डिवाइस को इस नए मोबाइल डिवाइस से कनेक्ट करें. कुछ डेटा Wear OS डिवाइस से जुड़ी जानकारी, कनेक्ट किए गए मौजूदा मोबाइल डिवाइस में सेव होती है.

Wear OS 4 की शुरुआत से, जब उपयोगकर्ता किसी नए मोबाइल डिवाइस से कनेक्ट करते हैं, तो वे Wear OS का डेटा नए मोबाइल डिवाइस पर ट्रांसफ़र करें. डेटा अपने-आप सिंक हो जाता है उसे ट्रांसफ़र कर देते हैं.

जब उपयोगकर्ता, ट्रांसफ़र का अनुरोध करता है, तो पहने जाने वाला डेटा लेयर DataItem ऑब्जेक्ट, जो मूल रूप से एक मोबाइल डिवाइस पर सेव किए जाते हैं और दूसरे डिवाइस में सेव होते हैं मोबाइल डिवाइस. इससे आपके ऐप्लिकेशन के उपयोगकर्ताओं को बेहतरीन अनुभव मिलता है.

इस दस्तावेज़ में बताया गया है कि Wear OS ऐप्लिकेशन को कैसे कॉन्फ़िगर किया जा सकता है और के मोबाइल ऐप्लिकेशन का इस्तेमाल करें.

वीडियो की रणनीति

डेटा ट्रांसफ़र की प्रोसेस, DataItem ऑब्जेक्ट को अलग-अलग तरीके से हैंडल करती है. यह प्रोसेस, इन चीज़ों पर निर्भर करती है किस ऐप्लिकेशन के पास डेटा का मालिकाना हक है:

Wear OS ऐप्लिकेशन के मालिकाना हक वाले ऑब्जेक्ट
ये ऑब्जेक्ट, Wear OS डिवाइस पर सेव रहते हैं.
मोबाइल ऐप्लिकेशन के मालिकाना हक वाले ऑब्जेक्ट

ये ऑब्जेक्ट पुराने डिवाइस पर संग्रहित किए जाते हैं. इसके बाद, सिस्टम डेटा को DataItemBuffer ऑब्जेक्ट में संग्रहित किया जाता है और इस डेटा को नए मोबाइल डिवाइस पर इंस्टॉल किया गया मोबाइल ऐप्लिकेशन.

संग्रह डिलीवर होने के तुरंत बाद, पहने जाने वाला डेटा लेयर शुरू हो जाता है onNodeMigrated() लिसनर, इसी तरह से आपके ऐप्लिकेशन को सूचना दी जाती है जब डेटा को Wear OS डिवाइस से लिखा जाता है.

ट्रांसफ़र किए गए डेटा को सुरक्षित रखना

ट्रांसफ़र किए गए DataItem ऑब्जेक्ट को सुरक्षित रखने की ज़िम्मेदारी आपके ऐप्लिकेशन की है. नए मोबाइल डिवाइस पर डेटा के डिलीवर होने के कुछ ही समय बाद, पुराने डिवाइस से मिटा दिया गया.

पक्का करें कि यहां दी गई हर शर्त सही हो:

  1. आपका ऐप्लिकेशन उन दोनों मोबाइल डिवाइसों पर इंस्टॉल होता है जो ट्रांसफ़र.
  2. प्रत्येक मोबाइल डिवाइस पर इंस्टॉल किए गए मोबाइल ऐप्लिकेशन में एक पैकेज हस्ताक्षर होने चाहिए.

ऐसा नहीं करने पर, संग्रहित किए गए DataItem ऑब्जेक्ट डिलीवर नहीं किए जाते. इसके बजाय, ये ऑब्जेक्ट डिलीवर नहीं किए जाते खारिज कर दिया गया है.

पुराने मोबाइल डिवाइस से डेटा पाएं

नए मोबाइल डिवाइस पर डेटा पाने के लिए, जिसे पुराने मोबाइल पर संग्रहित किया गया था डिवाइस पर, आपके मोबाइल ऐप्लिकेशन को onNodeMigrated() कॉलबैक लागू करना होगा, WearableListenerService क्लास का हिस्सा है. ऐसा करने के लिए, नीचे दिए गए काम करें चरण:

  1. अपने मोबाइल ऐप्लिकेशन की बिल्ड फ़ाइल में, सबसे नए वर्शन की डिपेंडेंसी शामिल करें के लिए:

    dependencies {
        ...
        implementation 'com.google.android.gms:play-services-wearable:18.2.0'
    }
  2. अपने ऐप्लिकेशन केWearableListenerService मेनिफ़ेस्ट फ़ाइल:

    <service
    android:name=".MyWearableListenerService"
    android:exported="true">
    <intent-filter>
        ...
        <action android:name="com.google.android.gms.wearable.NODE_MIGRATED" />
        <data android:scheme="wear" />
    </intent-filter>
    </service>
    
  3. ऐसी सेवा क्लास बनाएं जो WearableListenerService का दायरा बढ़ाए और ओवरराइड करे onNodeMigrated().

    Kotlin

    class MyWearableListenerService : WearableListenerService() {
        val dataClient: DataClient = Wearable.getDataClient(this)
    
        private fun shouldHandleDataItem(nodeId: String,
                                        dataItem: DataItem): Boolean {
            // Your logic here
            return dataItem.uri.path?.startsWith("/my_feature_path/") == true
        }
    
        private fun handleDataItem(nodeId: String, dataItem: DataItem) {
            val data = dataItem.data ?: return
            val path = dataItem.uri.path ?: return
            // Your logic here
            if (data.toString().startsWith("Please restore")) {
                dataClient.putDataItem(
                    PutDataRequest.create(path).setData(data)
                )
            }
        }
    
        override fun onNodeMigrated(nodeId: String, archive: DataItemBuffer) {
            val dataItemsToHandle = mutableListOf<DataItem>()
    
            for (dataItem in archive) {
                if (shouldHandleDataItem(nodeId, dataItem)) {
                    dataItemsToHandle.add(dataItem.freeze())
                }
            }
    
            // Callback stops automatically after 20 seconds of data processing.
            // If you think you need more time, delegate to a coroutine or thread.
            runBlocking {
                for (dataItem in dataItemsToHandle) {
                    handleDataItem(nodeId, dataItem)
                }
            }
        }
    }

    Java

    public class MyWearableListenerService extends WearableListenerService {
        private final DataClient dataClient = Wearable.getDataClient(this);
    
        private boolean shouldHandleDataItem(String nodeId, DataItem dataItem) {
            // Your logic here
            return Objects.requireNonNull(dataItem.getUri().getPath())
                    .startsWith("/my_feature_path/");
        }
    
        private Task<DataItem> handleDataItem(String nodeId, DataItem dataItem) {
            byte[] data = dataItem.getData();
            String path = dataItem.getUri().getPath();
            // Your logic here
            if (data != null && path != null && Arrays.toString(data)
                    .startsWith("Please restore")) {
                assert path != null;
                return dataClient.putDataItem(
                            PutDataRequest.create(path).setData(data));
        }
    
        @Override
        public void onNodeMigrated(@NonNull String nodeId, DataItemBuffer archive) {
            List<DataItem> dataItemsToHandle = new ArrayList<>();
    
            for (DataItem dataItem : archive) {
                if (shouldHandleDataItem(nodeId, dataItem)) {
                    dataItemsToHandle.add(dataItem.freeze());
                }
            }
    
            for (dataItem in dataItemsToHandle) {
                handleDataItem(nodeId, dataItem);
            }
    
            // Callback stops automatically after 20 seconds of data processing.
            // If you think you need more time, delegate to another thread.
        }
    }