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 mà thiết bị đó sử dụng 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. Chỉ có thể loại bỏ trùng lặp các thiết bị Cloud-to-cloud khi chúng đượ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 xuất hiện các bản sao 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 cho thiết bị Matter. Ngoài ra, SYNC câu trả lời 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 đặt 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ề Cloud-to-Cloud.

Ví dụ về phản hồi SYNC dưới đây cho thấy cách sử dụng ba trường mới cũng như roomHint:

SYNC Câu trả lời 
{
  "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ị 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, đám mây của đối tác phải gửi ngay một REQUEST SYNC đến Google để cập nhật các trường này càng nhanh càng tốt nhằm tránh việc loại bỏ trùng lặp muộn.

Những 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ỉ nên thay đổi khi đặt lại về trạng thái ban đầu, khiến thiết bị xuất hiện trong tất cả các hoạt động 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

Cloud-to-cloud thiết bị không được đảm bảo sẽ tự động được 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 có liên quan sẽ xuất hiện trong một phần riêng trên màn hình chính của GHA, trong phần có tiêu đề Đã liên kết với bạn, bên ngoài mọi phòng. Những 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 cấu trúc vì những lý do khác.

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