حذف تکراری‌های دستگاه Matter و Cloud-to-cloud

هنگام تبدیل دستگاهی که درحال‌حاضر از (Cloud-to-cloud) به Matter استفاده می‌کند، باید مطمئن شوید که دستگاه از همان شناسه در Matter استفاده می‌کند که هنگام اتصال بااستفاده از غیرMatter API استفاده می‌کند. انجام این کار تضمین می‌کند که دستگاه فقط یک‌بار در 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 با الزامات ذکرشده در الزامات همگام‌سازی مطابقت داشته باشد، حذف تکراری‌ها انجام شود.