스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.

기기 검색 지원

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

로컬 처리 경로는 Google이 클라우드 처리의 SYNC 응답에서 반환된 기기와 로컬로 제어 가능한 기기를 일치시킬 때 설정됩니다.

Google이 로컬 네트워크에서 기기를 검색하고 로컬 처리 경로를 설정할 수 있게 하려면 Actions 콘솔에서 검색 정보를 추가해야 합니다. 또한 클라우드 처리에서 SYNC 응답을 업데이트하여 로컬에서 제어할 수 있는 기기를 Google에 알려야 합니다.

스캔 구성 정보 설정

검색 정보를 지정하려면 다음 단계를 따르세요.

  1. Actions 콘솔에서 스마트 홈 프로젝트를 엽니다.
  2. 왼쪽 탐색 메뉴에서 작업을 클릭합니다.
  3. 로컬 홈 SDK 구성 (선택사항) > 기기 스캔 구성 추가에서 새 스캔 구성을 클릭합니다.
  4. 드롭다운에서 스캔 일치 프로토콜 유형을 선택하고 Google에서 스캔할 값을 입력합니다.

다음 표는 Google에서 기기 검색에 사용할 프로토콜에 따라 추가할 수 있는 속성을 보여줍니다.

mDNS
속성 설명 예시 값
서비스 이름 필수 항목입니다. 기기에서 게시한 서비스 이름으로, service.domain 형식입니다. _http._tcp.local
이름

필수 항목입니다. instance.service.domain 형식으로 고유한 서비스 인스턴스를 필터링합니다.

플랫폼은 이 값을 정규 표현식으로 취급하고 일치하는 기기를 반환합니다.
my-device-[0-9]{4}\._http\._tcp\.local
UPnP
속성 설명 예시 값
서비스 유형 필수 항목입니다. UPnP 서비스의 정규화된 식별자로, domain:service:type:version 형식입니다. schemas-upnp-org:service:SwitchPower:1
UI

선택사항. 조직 고유 식별자.

기기 제조업체를 식별하는 24비트 값입니다. 일반적으로 기기 MAC 주소의 처음 8개의 옥텟입니다.
1A:2B:3C
UDP
속성 설명 예시 값
방송 주소 필수 항목입니다. UDP 브로드캐스트의 대상 IP 주소입니다. 255.255.255.255
브로드캐스트 포트 필수 항목입니다. UDP 브로드캐스트의 대상 포트입니다. 5555
수신 포트 필수 항목입니다. UDP 검색 응답의 포트를 리슨합니다. 5556
검색 패킷

필수 항목입니다. UDP 브로드캐스트에서 전송할 페이로드입니다.

16진수로 인코딩된 바이트 문자열로 표시됩니다.
48454C4C4F

클라우드 처리에서 SYNC 응답 업데이트

SYNC 인텐트는 사용자가 제어하는 기기와 그 기능을 어시스턴트에 보고합니다.

로컬 처리를 지원하기 위해 로컬 홈 플랫폼은 스마트 홈 작업의 클라우드 처리에서 SYNC 응답을 확인하고 otherDeviceIds 필드의 기기 ID를 IDENTIFY 핸들러가 반환한 인증 ID와 일치시키려고 시도합니다. otherDeviceIds 필드가 없는 기기 항목은 로컬 처리에서 제외됩니다.

SYNC 응답의 otherDeviceIds 필드에서 로컬로 제어할 수 있는 스마트 홈 기기의 기기 ID를 설정해야 합니다. 이 필드는 응답의 device 수준에서 표시됩니다. Google은 지정된 ID가 있는 모든 기기에서 로컬 처리 경로를 설정할 수 있습니다.

Google에서 독립형 기기에 연결하거나 허브를 통해 최종 기기를 타겟팅하는 데 필요한 추가 데이터(예: 포트 번호 및 기타 프로토콜별 정보)를 지정하려면 customData 필드를 사용합니다.

다음 스니펫은 SYNC 핸들러를 만드는 방법을 보여줍니다.

독립형/허브
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}