إزالة التكرار من السحابة الإلكترونية إلى السحابة الإلكترونية وإزالة تكرار أجهزة Matter

عند تحويل جهاز يستخدم حاليًا (Cloud-to-cloud) إلى Matter، يجب التأكّد من أنّ الجهاز يستخدم المعرّف نفسه على Matter الذي يستخدمه عند الاتصال باستخدام واجهات برمجة التطبيقات غير Matter. يضمن ذلك ظهور الجهاز مرة واحدة فقط على Google Home Graph المستخدم. لا يمكن إزالة تكرار أجهزة Cloud-to-cloud إلا عندما تكون مرتبطة ببنية معيّنة (منزل) في Google Home app (GHA).

متطلبات SYNC

لتجنُّب ظهور نُسخ طبق الأصل في Home Graph، يجب أن تُرسِل سحابة شركاء Google السحابية ثلاثة حقول سلاسل جديدة لكل جهاز في ردّ SYNC على Google. يجب أن تتطابق هذه الحقول مع السمات المحدّدة في مجموعة ข้อมูล العميل الأساسية لجهاز Matter. بالإضافة إلى ذلك، يجب أن تحتوي ردود SYNC على roomHint:

  1. matterUniqueId: السمة UniqueId بتنسيق سلسلة
  2. matterOriginalVendorId: سمة VendorId بتنسيق سلسلة سداسية عشرية
  3. matterOriginalProductId: سمة ProductId بتنسيق سلسلة سداسية عشرية
  4. roomHint - الغرفة التي يقع فيها هذا الجهاز

يمكن العثور على مستندات حول الأهداف، مثل SYNC، في المستند التمهيدية من السحابة الإلكترونية إلى السحابة الإلكترونية.

يوضّح مثال ردّ SYNC أدناه استخدام الحقول الثلاثة الجديدة بالإضافة إلى roomHint:

ردّ SYNC 
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "456",
        "type": "action.devices.types.LIGHT",
        "traits": [
          "action.devices.traits.OnOff",
          "action.devices.traits.Brightness",
          "action.devices.traits.ColorSetting",
        ],
        "willReportState": true,
        "roomHint": "office",
        "deviceInfo": { ... },
        "matterUniqueId": "00112233aabbccddeeff",
        "matterOriginalVendorId": "0xfff1",
        "matterOriginalProductId": "0x1234",
        "otherDeviceIds": [
          {
            "deviceId": "local-device-id",
          }
        ]
      }
    ]
  }
}

عند تحويل جهاز كان يعمل سابقًا على الشبكة المنزلية للمستخدم باستخدام سحابة شريك إلى جهاز Matter، يجب أن ترسل سحابة الشريك على الفور REQUEST SYNC إلى Google لتعديل هذه الحقول في أسرع وقت ممكن لتجنُّب التأخير في إزالة تكرار البيانات.

يجب ألا تتغير هذه السلاسل بمجرد تقديمها لجهاز معين. من المفترض ألا يتغيّر المعرّف الفريد إلا عند إعادة ضبط الجهاز على الإعدادات الأصلية، ما يجعل الجهاز يظهر لجميع عمليات الدمج كجهاز جديد تمامًا.

ربط البنية تلقائيًا

لا يمكن ضمان ربط أجهزة Cloud-to-cloud تلقائيًا ببنية معيّنة. في الحالات التي يتعذّر فيها ربط البنية تلقائيًا، ستظهر أجهزة Cloud-to-cloud ذات الصلة في قسم مخصّص من شاشة GHA الرئيسية، ضمن قسم بعنوان مرتبطة بحسابك، خارج أي غرف. ولن تتم إزالة تكرار هذه الأجهزة. لن يتم وضع الأجهزة تلقائيًا في بنية عندما يكون لدى المستخدم أكثر من بنية واحدة (منزل) في GHA. قد يتعذّر تنظيم الأجهزة لأسباب أخرى.

إذا نقل مستخدم جهاز Cloud-to-cloud لم يتم تنفيذ عملية الربط التلقائي للبنية بهيكلة معيّنة يدويًا، قد تتم إزالة التكرار في العملية SYNC التالية طالما أنّ استجابات SYNC تتوافق مع المتطلبات المذكورة في متطلبات المزامنة.