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) sang Matter, bạn phải đảm bảo rằng thiết bị đó sử dụng cùng một mã nhận dạng trên Matter như khi 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ỉ xuất hiện 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-cloudtrùng lặp khi các thiết bị đó được liên kết với một cấu trúc cụ thể (nhà) trong Google Home app (GHA).

Yêu cầu về SYNC

Để tránh các thiết bị trùng lặp xuất hiện 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 SYNCphản hồi 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 cho thiết bị Matter. Ngoài ra, phản hồi SYNC phải chứa roomHint:

1. matterUniqueId – Thuộc tính UniqueId ở định dạng chuỗi từ cụm Thông tin cơ bản.
2. matterOriginalVendorId – Thuộc tính VendorId ở định dạng chuỗi thập lục phân từ cụm Thông tin cơ bản.
3. matterOriginalProductId – Thuộc tính ProductId ở định dạng chuỗi thập lục phân từ cụm Thông tin cơ bản.
4. roomHint – Phòng mà thiết bị này đặt.

Bạn có thể tìm thấy tài liệu về các ý định như SYNC trong phần Giới thiệu về Cloud-to-Cloud.

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 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, đá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.

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

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

Các thiết bị Cloud-to-cloud không được đảm bảo sẽ được liên kết tự động với một cấu trúc cụ thể. Trong những trường hợp không thể liên kết cấu trúc tự động, các thiết bị có liên quan sẽ xuất hiện trong một phần riêng biệt của màn hình chính GHA, trong phần có tiêu đề Đã liên kết với bạn, bên ngoài bất kỳ phòng nào.Cloud-to-cloud Các thiết bị như vậy sẽ không được loại bỏ trùng lặp. Các thiết bị sẽ không được tự động đặt trong một cấu trúc khi người dùng có nhiều cấu trúc (nhà) trong GHA. Các thiết bị có thể không được cấu trúc hoá vì những 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 vào 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 trên SYNC tiếp theo miễn là phản hồi SYNC tuân thủ các yêu cầu được nêu trong Yêu cầu về SYNC.