현재 사용 중인 기기 (Cloud-to-cloud)를 Matter로 변환할 때는 기기가 Matter 이외의 API를 사용하여 연결할 때 사용하는 것과 동일한 ID를 Matter에서 사용하는지 확인해야 합니다. 이렇게 하면 기기가 사용자의 Google Home Graph에 한 번만 표시됩니다. Cloud-to-cloud 기기는 Google Home app (GHA)의 특정 구조 (홈)와 연결된 경우에만 중복 삭제할 수 있습니다.
SYNC 요구사항
Home Graph에 중복이 표시되지 않도록 하려면 파트너의 클라우드는 SYNC 응답에서 기기마다 세 개의 새로운 문자열 필드를 Google에 전송해야 합니다. 이 필드는 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에 중복 삭제가 발생할 수 있습니다.