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

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

  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 기기로 전환되면 파트너의 클라우드는 즉시 REQUEST SYNC를 Google에 전송하여 이러한 필드를 최대한 빨리 업데이트함으로써 중복 삭제가 지연되지 않도록 해야 합니다.

이러한 문자열은 특정 기기에 제공된 후에는 변경해서는 안 됩니다. 고유 ID는 초기화 시에만 변경되어야 하며, 이 경우 기기가 모든 통합에 완전히 새로운 기기로 표시됩니다.

자동 구조 연결

Cloud-to-cloud 기기가 특정 구조와 자동으로 연결된다고 보장할 수 없습니다. 자동 구조 연결이 불가능한 경우 관련 Cloud-to-cloud 기기는 GHA의 기본 화면에 있는 전용 섹션의 연결된 기기라는 섹션 아래에 표시되며, 방 외부에 표시됩니다. 이러한 기기는 중복 삭제되지 않습니다. 사용자가 GHA에 구조 (홈)를 두 개 이상 가지고 있는 경우 기기가 구조에 자동으로 배치되지 않습니다. 다른 이유로 기기가 구조화되지 않을 수 있습니다.

사용자가 자동 집 연결에 실패한 Cloud-to-cloud 기기를 수동으로 집으로 이동하는 경우 SYNC 응답이 동기화 요구사항에 명시된 요구사항을 준수하는 한 다음 SYNC에서 중복 삭제가 발생할 수 있습니다.