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

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