현재 (Cloud-to-cloud)를 사용하는 기기를 Matter로 변환할 때는 기기가 Matter가 아닌 API를 사용하여 연결할 때 사용하는 것과 동일한 ID를 Matter에서 사용해야 합니다. 이렇게 하면 기기가 사용자의 Google Home Graph에 한 번만 표시됩니다. Cloud-to-cloud 기기는 Google Home app (GHA)에서 특정 구조 (홈)와 연결된 경우에만 중복 삭제할 수 있습니다.
SYNC
요구사항
Home Graph에 중복이 표시되지 않도록 하려면 파트너의 클라우드에서 Google에 대한 SYNC
응답에서 각 기기에 대해 세 개의 새 문자열 필드를 전송해야 합니다. 이 필드는 Matter 기기의 기본 정보 클러스터에 정의된 속성과 일치해야 합니다. 또한 SYNC
응답에는 roomHint
이 포함되어야 합니다.
matterUniqueId
:UniqueId
속성의 문자열 형식입니다.matterOriginalVendorId
: 16진수 문자열 형식의VendorId
속성입니다.matterOriginalProductId
: 16진수 문자열 형식의ProductId
속성입니다.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 기기로 변환되면 파트너의 클라우드는 지연된 중복 삭제를 방지하기 위해 가능한 한 빨리 이러한 필드를 업데이트하기 위해 Google에 REQUEST SYNC
를 즉시 전송해야 합니다.
이러한 문자열은 특정 기기에 제공된 후에는 변경되어서는 안 됩니다. 고유 ID는 초기화 시만 변경되어야 하며, 이 경우 기기가 모든 통합에 완전히 새로운 기기로 표시됩니다.
자동 구조 연결
Cloud-to-cloud 기기가 특정 구조와 자동으로 연결되는 것은 아닙니다. 자동 구조 연결이 불가능한 경우 관련 Cloud-to-cloud 기기는 GHA 기본 화면의 전용 섹션인 연결됨 섹션 아래에 방 외부에 표시됩니다. 이러한 기기는 중복 삭제되지 않습니다. 사용자가 GHA에 두 개 이상의 구조 (집)를 보유한 경우 기기가 구조에 자동으로 배치되지 않습니다. 다른 이유로 기기가 구조화되지 않을 수도 있습니다.
사용자가 자동 구조 연결에 실패한 Cloud-to-cloud 기기를 구조로 직접 이동하는 경우 SYNC
응답이 SYNC 요구사항에 명시된 요구사항을 준수하는 한 다음 SYNC
에서 중복 삭제가 발생할 수 있습니다.