현재 사용 중인 기기 (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 응답 예시에서는 세 가지 새 필드와 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에서 중복 삭제가 발생할 수 있습니다.