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 được kết nối bằng các API không phải Matter. Làm như vậ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. Chỉ có thể loại bỏ các thiết bị Cloud-to-cloud trùng lặp khi những thiết bị đó đượ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 trường hợp 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 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, phản hồi SYNC phải chứa roomHint:
matterUniqueId– Thuộc tínhUniqueIdở định dạng chuỗi.matterOriginalVendorId– Thuộc tínhVendorId, ở định dạng chuỗi thập lục phân.matterOriginalProductId– Thuộc tínhProductId, ở định dạng chuỗi thập lục phân.roomHint– Phòng chứa thiết bị này.
Bạn có thể tìm thấy tài liệu về các ý định như SYNC trong Tài liệu cơ bản về đám mây với đám mây.
Phản hồi SYNC trong ví dụ bên dưới cho thấy cách sử dụng 3 trường mới cũng như roomHint:
SYNC Phản hồ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 sang thiết bị Matter, nền tảng đám mây của đối tác phải ngay lập tức gửi 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 sau thời gian quy định.
Các chuỗi này sẽ không bao giờ 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 bạn đặt lại về trạng thái ban đầu. Điều này sẽ khiến thiết bị xuất hiện trong tất cả các thành phần 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 với nhà
Các thiết bị Cloud-to-cloud không được đảm bảo sẽ được 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 có liên quan sẽ xuất hiện trong một phần dành 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 bất kỳ phòng nào. Các thiết bị này sẽ không được loại bỏ trùng lặp. Các 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. Các thiết bị có thể không lập được cấu trúc 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ì việc loại bỏ trùng lặp có thể diễn ra trên SYNC tiếp theo, miễn là các 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.