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