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

يوضِّح مثال الردّ 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 متوافقة مع المتطلبات الواردة في متطلبات المزامنة.