클라우드 간 및 Matter 기기 중복 삭제

현재 (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가 포함되어야 합니다.

  1. matterUniqueId - 기본 정보 클러스터의 UniqueId 속성(문자열 형식)
  2. matterOriginalVendorId - 기본 정보 클러스터의 VendorId 속성(16진수 문자열 형식)
  3. matterOriginalProductId - 기본 정보 클러스터의 ProductId 속성(16진수 문자열 형식)
  4. 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 요구사항에 설명된 요구사항을 준수해야 합니다.