이 페이지는 Cloud Translation API를 통해 번역되었습니다.

VS Code용 Google Home 확장 프로그램

Google Home Extension for Visual Studio Code는 Google Home Platform 개발자를 위해 설계되고 제작되었습니다. 이 확장 프로그램을 사용하면 Google Assistant Simulator, Google Cloud Logging, Home 그래프 뷰어, 기타 도구에 액세스하여 Matter 및 스마트 홈 개발 프로세스를 간소화할 수 있습니다.

Google Home 확장 프로그램 기능

Google 어시스턴트 시뮬레이터

스마트 홈 기기가 Google Home 생태계와 제대로 작동하는지 테스트하려면 VS Code를 종료하지 않고 언제든지 Assistant Simulator와 상호작용할 수 있습니다.

Assistant Simulator를 사용하면 '조명 켜 줘'와 같은 쿼리를 입력하여 기기를 쉽게 제어할 수 있습니다. VS Code 내에서 Assistant Simulator는 명령어에 따라 텍스트 메시지로 응답합니다(예: '좋습니다. 불을 켜겠습니다.'). 자세한 내용은 Google 어시스턴트 시뮬레이터 사용을 참고하세요.

일괄 발화

자동화처럼 Google Home 통합을 테스트하려면 음성 스크립트를 실행하여 Google 어시스턴트 시뮬레이터에 일괄 음성을 전송하면 됩니다. 자세한 내용은 일괄 발화 실행을 참고하세요.

Matter 로깅 도구

Matter Logging Tools는 Google Home app (GHA) 로그 및 Google Play 서비스 (GMS Core) 로그를 비롯하여 Matter 디버깅과 관련된 모든 로그를 수집할 수 있습니다. 로그는 필터 및 키워드 검색을 사용하여 VS Code에서 볼 수 있습니다. 로그는 Android 및 앱 버전과 같은 추가 디버그 정보와 함께 다운로드하여 문제를 신고하기 위해 Google에 전송할 수 있습니다.

Cloud Logging

Cloud Logging는 디버깅 정보와 주요 측정항목을 제공하여 작업 사용에 대한 유용한 정보를 제공합니다. 개발을 간소화하기 위해 Google Home Extension는 문제 해결 중에 코드 바로 옆에 실시간 Google Cloud Logging 메시지를 표시합니다. 자세한 내용은 Cloud Logging 보기를 참고하세요.

Home 그래프 뷰어

이제 Google Home Extension에서 직접 Home Graph 뷰어를 사용할 수 있으므로 VS Code 내의 Home Graph에서 기기 상태를 확인할 수 있습니다. 자세한 내용은 홈 그래프 보기 및 테스트 실행을 참고하세요.

VS Code용 Google Home 확장 프로그램 설치

Google Home Extension를 설치하려면 VS Code 내에서 다음 단계를 따르세요.

작업 표시줄에서 확장 프로그램 아이콘을 클릭합니다.
google home를 검색한 다음 설치를 클릭합니다.

VS Code Marketplace에서 직접 Google Home Extension를 다운로드할 수도 있습니다.

Google Home Extension 다운로드

VS Code용 Google Home 확장 프로그램 설정

Google Home Extension를 설치하고 VS Code를 새로고침한 후에는 로그인하고 프로젝트를 선택해야 Assistant Simulator를 사용하고 Cloud Logging을 볼 수 있습니다.

Google 계정으로 로그인하고 클라우드 프로젝트 선택

Google Home Extension에서 개발자 계정에 로그인하여 VS Code가 나를 대신하여 Google 서비스와 통신하도록 승인할 수 있습니다.

작업 표시줄에서 Google Home 아이콘을 클릭하여 Google Home Extension을 엽니다.
Google 계정으로 로그인을 클릭하여 브라우저에서 로그인 보기를 실행합니다.
스마트 홈 기기에 연결된 계정을 선택합니다.
Google 계정으로 로그인 승인 페이지에서 허용을 클릭합니다.
브라우저 탭이 열리고 Visual Studio Code 열기 대화상자가 표시됩니다. 계속하려면 Visual Studio Code 열기를 클릭합니다.
Google Home 확장 프로그램이 URI를 열 수 있도록 허용하려면 권한이 필요한 VS Code로 리디렉션됩니다. 열기를 클릭하여 로그인 절차를 완료합니다.
로그인하면 Google Home Extension에서 프로젝트를 로드합니다. 완료되면 프로젝트 선택을 클릭합니다.
프로젝트 검색 및 선택 드롭다운 창이 표시되면 스마트 홈 프로젝트를 선택합니다.

Android 디버그 브리지 (ADB) 도구 설치

Android 휴대전화에서 Matter 로그를 보려면 ADB를 설치해야 합니다.

컴퓨터에 ADB를 설치합니다.
Android 휴대전화에서 개발자 옵션과 USB 디버깅을 사용 설정합니다.

Matter 기기 SoC 도구 설치

Matter 기기의 디버그 로그를 보려면 다음 단계를 따르세요.

대부분의 기기 SoC는 Linux의 /dev/ttyUSBx, macOS의 /dev/tty.SLAB_USBtoUART 또는 /dev/tty.usbserial와 같은 직렬 포트를 내보냅니다. LogViewer는 기기에서 로그를 직접 읽을 수 있습니다.
NXP 또는 Silicon Labs와 같은 일부 SoC 유형의 경우 외부 도구 (예: JLink)를 설치해야 할 수 있습니다. 자세한 내용은 지원되는 기기를 참고하세요.

VS Code용 Google Home 확장 프로그램 사용

개발자 리소스 보기

도움말 및 의견에서 시작하기 및 리소스를 클릭하여 리소스 페이지를 엽니다. 이 페이지에서는 Google Home 생태계로 개발하는 데 도움이 되는 정보를 확인할 수 있습니다.

Google 어시스턴트 시뮬레이터 사용

VS Code에서 Assistant Simulator를 열려면 측면 패널에서 Google 어시스턴트 시뮬레이터를 클릭합니다. 메시지 상자에 검색어를 입력하고 Enter 키를 누릅니다.

Assistant Simulator 응답을 확인하고 쿼리 후 버튼을 클릭하여 다시 전송할 수 있습니다.

일괄 발화 실행

마우스를 GOOGLE ASSISTANT SIMULATOR 메뉴 바 위로 가져가 다음 옵션 중에서 선택하여 스크립트를 설정합니다.

아이콘을 클릭하여 기존 발화 스크립트를 엽니다.
아이콘을 클릭하여 *.utterance 스크립트에 기록을 저장합니다.

일괄 음성 전송을 시작하려면 다음 옵션 중에서 선택합니다.

아이콘을 클릭하여 드롭다운 창에서 음성 스크립트를 선택합니다.
*.utterance 파일을 직접 열고 를 클릭합니다.

Cloud Logging 보기

빠른 액세스에서 Cloud Logs를 클릭하여 Cloud Logs 페이지를 엽니다. 여기에서 선택한 프로젝트에 속한 로그를 확인할 수 있습니다.

사용자는 심각도 및 기간을 기준으로 로그를 필터링할 수 있습니다.

기본적으로 로그는 50행으로 제한됩니다. 사용자가 더 많은 로그를 보려면 하단으로 스크롤하여 더보기를 클릭하여 더 많은 로그를 확인합니다.

홈 그래프 보기 및 테스트 실행

빠른 액세스에서 홈 그래프 뷰어를 클릭하여 홈 그래프 뷰어 패널을 엽니다. 이 패널에서 선택한 프로젝트에 속한 기기를 확인할 수 있습니다. 테스트 실행을 클릭하여 기기의 테스트를 실행할 수도 있습니다.

그러면 브라우저에서 기기가 선택되고 테스트할 준비가 된 테스트 모음이 실행됩니다. 시작을 클릭하고 테스트 결과를 기다립니다.

Google Home 테스트 모음

모든 테스트가 완료되면 테스트 세부정보를 확인하고 로그를 볼 수 있습니다.

Matter 디버깅을 위한 Google Home 확장 프로그램 사용

Android 로깅

MATTER 로깅 도구에서 Android 로그를 클릭하여 Android 로그 페이지를 열고 연결할 Android 휴대전화를 선택한 후 로그 표시를 시작합니다.

Android 휴대전화가 연결되면 로그가 한 줄씩 표시됩니다. 로그가 필터링되므로 GHA 및 Google Play services Matter 모듈과 관련된 로그만 표시됩니다. 심각도를 설정하여 로그를 필터링하거나 로그에서 키워드를 검색할 수도 있습니다.

Matter 기기 로깅

MATTER LOGGING TOOLS에서 Device Logs를 클릭하여 Resources 페이지를 열고 먼저 SoC Type을 선택합니다.

그런 다음 Matter 기기를 선택합니다.

그런 다음 기기에서 모든 기기 로그를 가져와 Severity 및 Search와 같은 필터를 사용하여 관심 있는 정보를 찾을 수 있습니다.

모든 케이스 로그 다운로드

빠른 액세스에서 로그 다운로드를 클릭하여 로그 다운로드 대화상자를 열고 다운로드할 로그를 선택한 다음 확인을 누릅니다.

로그를 다운로드할 폴더를 선택하고 저장을 클릭합니다.

그러면 로그가 대상 폴더에 저장됩니다.

저장된 zip 파일의 압축을 풀면 기기 정보와 로그 파일이 표시됩니다.

기기 정보 파일에는 문제 디버깅에 필요한 모든 버전 정보가 포함됩니다.

의견 보내기

Google Home Extension의 개발 환경을 개선하는 방법에 관한 의견이나 의견을 제출하려면 다음 옵션 중에서 선택하세요.

고객센터 패널에서 의견 보내기를 클릭하여 제안사항을 보내주세요.
고객센터 및 의견 패널에서 문제 신고를 클릭하여 Google Home Extension에서 발견한 문제를 신고합니다.

리소스 페이지에도 의견 아이콘이 제공됩니다.