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

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

متطلبات SYNC

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

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

يمكنك الاطّلاع على مستندات حول الأهداف، مثل SYNC، في المقدمة حول Cloud-to-Cloud.

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

SYNC Response 
{
  "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 تتوافق مع المتطلبات المذكورة في متطلبات المزامنة.