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