ابر به ابر و حذف دستگاه Matter

هنگام تبدیل دستگاهی که در حال حاضر از ( Cloud-to-cloud ) استفاده می کند به Matter ، باید مطمئن شوید که دستگاه از همان شناسه ای در Matter استفاده می کند که هنگام اتصال با استفاده از API های غیر Matter استفاده می کند. انجام این کار باعث می شود دستگاه فقط یک بار در Google Home Graph کاربر نمایش داده شود. دستگاه‌های Cloud-to-cloud تنها زمانی می‌توان حذف کرد که با ساختار خاصی (خانه) در Google Home app (GHA) مرتبط باشند.

الزامات SYNC

برای جلوگیری از نمایش موارد تکراری در Home Graph ، ابر شریک باید سه فیلد رشته جدید را برای هر دستگاه در پاسخ SYNC به Google ارسال کند. این فیلدها باید با ویژگی های تعریف شده در Basic Information Cluster برای دستگاه 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 مطابقت داشته باشند، ممکن است حذف مجدد در SYNC بعدی انجام شود.