Loại bỏ đám mây sang đám mây và thiết bị Matter

Khi chuyển đổi một thiết bị hiện đang sử dụng (Cloud-to-cloud) thành Matter, bạn phải đảm bảo rằng thiết bị sử dụng cùng một mã trên Matter mà thiết bị sử dụng khi được kết nối bằng các API không phải Matter. Việc này đảm bảo rằng thiết bị chỉ hiển thị một lần trên Google Home Graph của người dùng. Bạn chỉ có thể loại bỏ các thiết bị Cloud-to-cloud trùng lặp khi được liên kết với một cấu trúc (nhà) cụ thể trong Google Home app (GHA).

SYNC yêu cầu

Để tránh hiển thị nội dung trùng lặp trên Home Graph, đám mây của đối tác phải gửi 3 trường chuỗi mới cho mỗi thiết bị trong phản hồi SYNC cho Google. Các trường này phải khớp với các thuộc tính được xác định trong cụm Thông tin cơ bản của thiết bị Matter. Ngoài ra, các phản hồi SYNC phải chứa roomHint:

1. matterUniqueId – Thuộc tính UniqueId ở định dạng chuỗi.
2. matterOriginalVendorId – Thuộc tính VendorId, ở định dạng chuỗi thập lục phân.
3. matterOriginalProductId – Thuộc tính ProductId, ở định dạng chuỗi thập lục phân.
4. roomHint – Phòng chứa thiết bị này.

Bạn có thể xem tài liệu về các ý định như SYNC trong Tài liệu cơ bản về chuyển đổi từ đám mây sang đám mây.

Phản hồi SYNC mẫu bên dưới cho thấy cách sử dụng 3 trường mới cũng như 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",
          }
        ]
      }
    ]
  }
}

Khi một thiết bị trước đây từng hoạt động trên mạng gia đình của người dùng bằng đám mây của đối tác được chuyển đổi thành thiết bị Matter, thì đám mây của đối tác phải gửi ngay REQUEST SYNC cho Google để cập nhật các trường này nhanh nhất có thể nhằm tránh việc loại bỏ trùng lặp muộn.

Những chuỗi này tuyệt đối không được thay đổi sau khi được cung cấp cho một thiết bị cụ thể. Mã nhận dạng duy nhất chỉ được thay đổi khi đặt lại về trạng thái ban đầu, điều này khiến thiết bị xuất hiện trong tất cả chế độ tích hợp dưới dạng một thiết bị hoàn toàn mới.

Tự động liên kết cấu trúc

Các thiết bị Cloud-to-cloud không đảm bảo sẽ tự động liên kết với một cấu trúc cụ thể. Trong trường hợp không thể tự động liên kết cấu trúc, các thiết bị Cloud-to-cloud liên quan sẽ xuất hiện trong một phần chuyên dụng trên màn hình chính của GHA, trong một phần có tiêu đề Đã liên kết với bạn, bên ngoài bất kỳ phòng nào. Các thiết bị như vậy sẽ không được loại bỏ trùng lặp. Thiết bị sẽ không được tự động đặt vào một cấu trúc khi người dùng có nhiều cấu trúc (nhà) trong GHA. Thiết bị có thể không cấu trúc được vì các lý do khác.

Nếu người dùng di chuyển một thiết bị Cloud-to-cloud không liên kết được cấu trúc tự động sang một cấu trúc theo cách thủ công, thì quá trình loại bỏ trùng lặp có thể diễn ra vào SYNC tiếp theo, miễn là phản hồi SYNC tuân thủ các yêu cầu nêu trong các yêu cầu về SYNC.