Google의 Home 개발자 프로그램을 사용하면 기기 제조업체가 스마트 홈 기기를 Google Home 생태계에 연결할 수 있습니다. Google Home app (GHA)를 사용하여 설정에 Matter 지원 기기를 추가하고 Google Assistant, GHA 또는 Google Nest Hub (2nd gen)과 같은 스마트 디스플레이를 사용하여 이를 제어할 수 있는 기능을 통해 스마트 홈 작업 로컬 처리 경로를 확장하고 있습니다.
이 문서에서는 Google Home 생태계에서 Matter 지원 플랫폼을 빌드하고 통합하는 방법을 설명합니다.
면책조항
Matter 문서에 설명된 절차와 관련하여 다음 사항에 유의하세요.
- 개발에 사용되는 계정에는 테스트를 위해 연결된 Matter 지원 허브가 하나만 있는 것이 좋습니다. 테스트 중에 동시에 연결되거나 동일한 구조에 연결된 여러 개의 Matter 지원 허브로 인해 예기치 않은 동작이 발생할 수 있습니다.
- 모든 절차는 Google에서 테스트한 Matter 샘플을 빌드하고 플래시하기 위해 Ubuntu 20.04를 실행하는 Linux 머신을 사용한다고 가정합니다. macOS 머신도 지원되지만 Linux를 사용하는 것이 좋습니다. Mac 관련 안내는 필요에 따라 절차에서 설명합니다.
빌드 방법
Google Home 생태계와 통합되는 Matter 지원 기기를 빌드하려면 Matter 호환 개발 보드와 Matter SDK를 사용합니다.
시작하는 가장 쉬운 방법은 Codelab을 사용하는 것입니다. 다음 Codelab 중 하나 이상을 완료하는 것이 좋습니다.
클라우드 간 통합을 위한 로컬 처리 사용 설정
49분
Updated 2024년 12월 21일
Local Home SDK로 로컬 처리를 사용 설정하여 스마트 홈과 어시스턴트의 통합을 강화하는 방법을 알아보세요.
스마트 홈 디버깅
25분
Updated 2024년 11월 23일
GCP 측정항목 및 Logging을 사용하여 프로덕션 문제를 파악하고 해결하는 방법을 알아봅니다. 테스트 모음을 사용하여 기능 및 API 문제를 파악하는 방법을 알아보세요.
Google 어시스턴트에 스마트 홈 기기 연결하기
35분
Updated 2024년 11월 23일
클라우드 간 통합을 빌드하고 배포하여 어시스턴트에 가상 스마트 세탁기를 통합하세요.
스마트 홈의 로그 기반 측정항목
16분
Updated 2024년 11월 23일
Google Cloud에서 로그 기반 측정항목을 사용하여 패턴을 추적하고 스마트 홈 통합 오류 로그를 분석하는 방법을 알아보세요.
로컬 홈 디버깅
50분
Updated 2024년 11월 23일
GCP 측정항목 및 Logging을 사용하여 프로덕션 문제를 파악하고 해결하는 방법을 알아봅니다. 테스트 모음을 사용하여 기능 및 API 문제를 파악하는 방법을 알아보세요. 로컬 홈 앱을 개발하는 동안 Chrome 개발자 도구를 사용하는 방법을 알아봅니다.
WebRTC로 CameraStream 구현
23분
Updated 2024년 11월 23일
CameraStream 특성 및 WebRTC를 사용하여 웹캠에서 Google Nest 디스플레이 기기로 스트리밍하는 방법을 알아봅니다.
클라우드 간 통합 강화 및 보안
50분
Updated 2024년 11월 23일
맞춤설정 가능한 기기 특성을 통해 클라우드 간 통합을 개선하고 보안을 강화하며, 2단계 인증을 통해 보안을 강화하는 방법을 알아보세요.
스마트 홈 서비스 중단 모니터링
31분
Updated 2024년 11월 21일
이 Codelab에서는 스마트 홈 통합에 자동 알림을 설정하여 서비스 중단을 감지하는 방법을 알아봅니다.
웹 수신기에 Ad Breaks API 지원 추가
56분
Updated 2024년 11월 9일
이 Codelab에서는 Cast Ad Breaks API를 사용하는 맞춤 웹 수신기 애플리케이션을 빌드합니다.
Cast 수신기 앱 디버깅
59분
Updated 2024년 11월 9일
이 Codelab에서는 기존 커스텀 웹 수신기 앱에 Cast 디버그 로거를 추가합니다.
Cast 수신기에 실시간 지원 추가
30분
Updated 2024년 11월 9일
이 Codelab에서는 Cast Live API를 사용하는 커스텀 웹 수신기 애플리케이션을 빌드합니다.
Cast 지원 Android 앱
2시간 48분
Updated 2024년 11월 9일
이 Codelab에서는 기존 Android 동영상 앱을 수정하여 Google Cast 지원 기기에서 콘텐츠를 전송합니다.
맞춤 웹 수신기 빌드
1시간 37분
Updated 2024년 11월 9일
이 Codelab에서는 Cast 지원 기기에서 콘텐츠를 재생하는 커스텀 웹 수신기 앱을 빌드합니다.
웹 앱에서 Cast 지원 사용
1시간 18분
Updated 2024년 11월 9일
이 Codelab에서는 기존 웹 동영상 앱을 수정하여 Google Cast 지원 기기에서 콘텐츠를 전송합니다.
Android TV 앱 Cast 지원 사용 설정
1시간 8분
Updated 2024년 11월 9일
이 Codelab에서는 기존 Cast 전송기 앱의 전송 및 통신을 지원하도록 기존 Android TV 앱을 수정합니다.
Matter 통합 디버깅
36분
Updated 2024년 11월 6일
분석 도구를 사용하여 Matter 통합 문제를 해결하는 방법을 알아보고 개발자 지원 리소스에 관해 자세히 알아보세요.
기기 액세스 웹 애플리케이션 빌드
1시간
Updated 2024년 10월 13일
이 Codelab에서는 기기 액세스의 작동 방식을 알아보고 Nest Thermostat에 관한 인증과 Smart Device Management API 호출을 처리하는 웹 애플리케이션을 빌드합니다.
법적 사안용 Android 앱 빌드
1시간 17분
Updated 2024년 9월 20일
법적 사안용 Google Home 샘플 앱을 맞춤설정하여 기기를 의뢰하고 관리합니다.
iOS 앱에서 Cast 지원 사용
2시간 28분
Updated 2024년 9월 11일
이 Codelab에서는 기존 iOS 동영상 앱을 수정하여 Google Cast 지원 기기에서 콘텐츠를 전송합니다.
Matter 기기 빌드
1시간 17분
Updated 2024년 8월 22일
이 Codelab에서는 법적 사안 기기를 빌드하고 의뢰하며 사용합니다.
중요 가상 기기 빌드
1시간 12분
Updated 2024년 8월 22일
이 Codelab에서는 가상 법적 사안 기기를 빌드하고 의뢰하여 사용합니다.
기본 Cast 수신기 빌드
Updated 2022년 7월 29일
이 Codelab에서는 Google Cast 애플리케이션 프레임워크를 사용하여 Cast 지원 수신기 앱을 빌드합니다.
그런 다음 지원되는 기기 목록을 확인하여 통합하려는 기기가 Google Home 생태계에서 지원되는지 확인하세요. 그런 다음 개발자 체크리스트를 읽고 프로젝트 생성부터 출시까지의 전체 개발 흐름을 이해합니다.
정의
이 문서에서는 다음 용어가 사용됩니다.
- 보더 라우터
- Thread 지원 기기용 범용 Thread 보더 라우터를 구현하는 허브입니다.
- 허브
- 지원되는 Google Nest 기기(예: Google Nest Hub (2nd gen)) Assistant, GHA, 스마트 디스플레이와 같은 다른 표시 경로를 통해 Matter 지원 기기를 제어하려면 허브가 필요합니다.
- Matter 지원 기기
- Matter 지원 빌드 또는 샘플 앱으로 플래시된 기기 또는 개발 보드입니다.
- 휴대기기
- 페어링을 지원하는 데 사용된 테스트 휴대전화입니다. 현재는 Android 휴대전화입니다.
기본 요건
Matter 지원 기기를 Google Home 생태계와 완전히 통합하려면 개발자가 다음을 갖추어야 합니다.
- 스레드 지원 Google 허브: 스레드 지원 기기의 보더 라우터와 스마트 홈 인텐트 라우팅을 위한 로컬 처리 경로 역할을 합니다.
- 최소 요구사항을 충족하는 휴대기기 (테스트 전화)
- Android O (8.1, API 수준 27 이상)
- iOS (v16.5 이상)
- BLE 기능
- Matter 지원 기기의 공급업체 ID (VID) 및 제품 ID (PID)
- Matter 지원 기기 이 기기는 Google Home 생태계에서 지원되는 Matter 기기 유형 중 하나여야 하며 다음과 같은 유형일 수 있습니다.
- Matter 지원 펌웨어가 포함된 자체 제품
- 엔드 투 엔드 인증에 사용할 다음 Matter 기기 중 하나:
공급업체 | 플랫폼 | Thread 지원 | 가이드 |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | OTA 테스트 | |
Nordic Semiconductor | nRF52840 DK | OTA 테스트 | |
NXP | IOTZTB-DK006 개발 키트 | ||
Realtek | Ameba D 시리즈 | ||
Silicon Labs | EFR32MG24 Dev Kit | ||
EFR32MG Zigbee 및 Thread 스타터 키트 | |||
Telink | TLSR9518 | ||
Texas Instruments | CC2652R7 LaunchPad 개발 키트 |
공급업체 ID
기본적으로 테스트 목적으로 CSA에서 할당한 VID 중 하나를 사용할 수 있습니다. 0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
중 하나를 선택합니다.
통합을 인증하고 출시할 수 있도록 프로덕션 VID를 사용하려면 먼저 Google에서 VID가 CSA에서 발급되었는지 확인해야 합니다.
이 VID는 기기의 펌웨어에 구현되어야 합니다.
Matter 기기는 특정 공급업체 ID 및 기기 유형 시나리오에서만 Google Home 생태계에서 페어링할 수 있습니다.
- 테스트 VID는 소비자 기기에서 사용할 수 없습니다.
- 프로덕션 VID는 Connectivity Standards Alliance (Alliance)에서 발급해야 합니다. Google Home Developer Console에서 VID를 사용하려면 먼저 Google에서 VID의 소유자임을 확인해야 합니다. 그러면 해당 VID에 대한 통합을 만들 수 있습니다.
- 개발 및 Field Trial 목적으로 프로젝트와 해당 VID 및 PID 조합과의 통합을 Developer Console에서 만들어야 합니다. 기기를 커미셔닝하는 사용자는 프로젝트의 구성원이거나 Field Trial 사용자 목록에 포함되어 있어야 합니다.
- 소비자 사용자는 Alliance에서 인증한 후에만 제품을 사용할 수 있습니다.
VID 및 PID는 하나의 통합에 한 번만 사용할 수 있습니다. 통합에서 동일한 VID 또는 PID를 사용하려면 다음 중 하나를 실행해야 합니다.
- VID 또는 PID를 사용하여 통합을 다른 VID 또는 PID로 수정합니다.
- VID 또는 PID를 사용하여 통합을 삭제합니다.
어떤 유형의 사용자가 Google Home 생태계에서 기기를 커미셔닝할 수 있나요? | |||
---|---|---|---|
VID 유형 | VID 인증 및 콘솔 통합 상태 | 프로덕션
(일반 사용자) |
개발
(개발자, Field Trial 사용자) |
테스트 | Developer Console에 통합이 없음 (인증할 수 없음) | ||
테스트 | Developer Console에 통합이 있습니다 (인증 불가). | ||
프로덕션 | 인증되지 않음, Developer Console에 통합이 없음 | ||
프로덕션 | 인증되지 않음, Developer Console에 통합이 있음 | ||
프로덕션 | Alliance DCL에서 인증되었으나 Developer Console에 통합이 없음 | ||
프로덕션 | Alliance DCL에서 인증을 받았으며 Developer Console에 통합이 있음 |
제품 ID
기기 정보는 Matter 기본 정보 클러스터에서 읽습니다. 기기의 펌웨어에 인코딩된 제품 ID가 개발자 콘솔의 Matter 통합 제품 ID와 일치해야 합니다.
지원되지 않는 기능
일부 Matter 클러스터는 시스템에서 사용될 수 있지만 아직 사용자에게 노출되지 않습니다. 대부분의 경우 이러한 클러스터에 노출된 속성은 최종 사용자에게 표시되지 않습니다.
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ 전원 스위치에 미치는 영향은 전원 스위치를 참고하세요.