현재 (Cloud-to-cloud) 을 사용하는 기기를 Matter로 변환할 때는 기기가 Matter에서 비 Matter API를 사용하여 연결할 때 사용하는 것과 동일한 ID를 사용해야 합니다. 이렇게 하면 기기가 사용자의 Google Home Graph에 한 번만 표시됩니다. Cloud-to-cloud 기기는 특정 집과 연결된 경우에만 Google Home app (GHA)에서 중복 삭제할 수 있습니다.
에서만 지원됩니다.SYNC 요구사항
Home Graph에 중복 항목이 표시되지 않도록 하려면 파트너의
클라우드가
SYNC
응답에서 각 기기에 대해 세 개의 새 문자열 필드를 Google에 전송해야 합니다. 이러한 필드는 Matter 기기의 기본
정보 클러스터에 정의된 속성과 일치해야 합니다. 또한 SYNC 응답에는 roomHint가 포함되어야 합니다.
matterUniqueId- 기본 정보 클러스터의UniqueId속성(문자열 형식)matterOriginalVendorId- 기본 정보 클러스터의VendorId속성(16진수 문자열 형식)matterOriginalProductId- 기본 정보 클러스터의ProductId속성(16진수 문자열 형식)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 요구사항에 설명된 요구사항을 준수해야 합니다.