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

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