إزالة التكرار من السحابة الإلكترونية إلى السحابة الإلكترونية وإزالة تكرار أجهزة 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 تتوافق مع المتطلبات المذكورة في متطلبات المزامنة.