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