현재 사용 중인 기기 (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
와 같은 인텐트에 관한 문서는 클라우드 간 기본 지침서를 참고하세요.
아래의 SYNC
응답 예는 새 필드 3개와 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 기기로 변환되면 파트너의 클라우드는 REQUEST SYNC
를 즉시 Google에 전송하여 이러한 필드를 최대한 빠르게 업데이트하여 지연된 중복 삭제를 방지해야 합니다.
이러한 문자열은 지정된 기기에 제공된 후에는 절대 변경되지 않습니다. 고유 ID는 초기화 시에만 변경되어야 하므로 모든 통합에서 기기가 완전히 새로운 기기로 표시됩니다.
자동 구조 연결
Cloud-to-cloud 기기는 특정 구조와 자동으로 연결되지 않을 수 있습니다. 자동 구조 연결이 불가능한 상황에서는 관련 Cloud-to-cloud 기기가 GHA 기본 화면의 전용 섹션(연결된 기기 섹션 아래)에 방 밖에 표시됩니다. 이러한 기기는 중복 삭제되지 않습니다. 사용자의 GHA에 구조 (집)가 두 개 이상 있는 경우 기기는 집에 자동으로 배치되지 않습니다. 다른 이유로 기기가 구조화되지 않을 수 있습니다.
사용자가 자동 구조 연결에 실패한 Cloud-to-cloud 기기를 구조로 수동으로 이동하면 SYNC
응답이 SYNC 요구사항에 명시된 요구사항을 준수하는 한 다음 SYNC
에서 중복 삭제가 발생할 수 있습니다.