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

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

자동 구조 연결

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

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