클라우드 간 및 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. matterUniqueIdUniqueId 속성의 문자열 형식입니다.
  2. matterOriginalVendorId: 16진수 문자열 형식의 VendorId 속성입니다.
  3. matterOriginalProductId: 16진수 문자열 형식의 ProductId 속성입니다.
  4. roomHint - 이 기기가 있는 방입니다.

SYNC와 같은 인텐트에 관한 문서는 Cloud-to-Cloud 입문서에서 확인할 수 있습니다.

아래의 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에서 중복 삭제가 발생할 수 있습니다.