Matter 클라우드 간 Local Home SDK 기기 SDK
Google Home Extension for Visual Studio Code는 Google Home Platform 개발자를 위해 설계 및 제작되었습니다. 이 확장 프로그램을 사용하면 Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer, 기타 도구에 액세스하여 Matter 및 스마트 홈 개발 프로세스를 간소화할 수 있습니다.
Google Home 확장 프로그램 기능
Google 어시스턴트 시뮬레이터
스마트 홈 기기가 Google Home 생태계에서 제대로 작동하는지 테스트하려면 VS Code를 닫지 않고 언제든지 Assistant Simulator와 상호작용하면 됩니다.
Actions Console에서 제공되는 기존 시뮬레이터와 마찬가지로 Assistant Simulator를 사용하면 '조명 켜기'와 같은 쿼리를 입력하여 기기를 쉽게 제어할 수 있습니다. VS Code 내에서 Assistant Simulator는 사용자의 명령어에 따라 문자 메시지로 다시 응답합니다(예: "Alright, off thelight."). 자세한 내용은 Google 어시스턴트 시뮬레이터 사용을 참고하세요.
일괄 발언
Google Home 통합을 자동화처럼 테스트하려면 발화 스크립트를 실행하여 Google 어시스턴트 시뮬레이터에 일괄 음성을 전송할 수 있습니다. 자세한 내용은 일괄 발언 실행을 참고하세요.
법적 사안 로깅 도구
Matter 로깅 도구는 Google Home app (GHA) 로그 및 Google Play 서비스 (GMS 코어) 로그를 포함하여 Matter 디버깅과 관련된 모든 로그를 수집할 수 있습니다. 로그는 필터 및 키워드 검색을 통해 VS Code에서 볼 수 있습니다. Android 및 앱 버전과 같은 추가 디버그 정보와 함께 로그를 다운로드하고 문제를 보고하기 위해 Google로 전송할 수 있습니다.
Cloud Logging
Cloud Logging는 작업의 사용량에 관한 유용한 정보를 제공하는 디버깅 정보와 주요 측정항목을 제공합니다. 개발을 간소화하기 위해 Google Home Extension에서는 문제 해결 중에 코드 바로 옆에 실시간 Google Cloud Logging 메시지를 표시합니다. 자세한 내용은 Cloud Logging 보기를 참조하세요.
홈 그래프 뷰어
이제 Google Home Extension에서 직접 Home Graph Viewer를 사용할 수 있으므로 VS Code 내의 Home Graph에서 기기 상태를 확인할 수 있습니다. 자세한 내용은 홈 그래프 보기 및 테스트 실행을 참고하세요.
VS Code용 Google Home 확장 프로그램 설치
Google Home Extension를 설치하려면 VS Code 내에서 다음 단계를 따르세요.
- 활동 표시줄에서 확장 프로그램 아이콘을 클릭합니다.
google home를 검색한 후 설치를 클릭합니다.
VS Code Marketplace에서 직접 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 열기 대화상자가 표시됩니다. Open Visual Studio Code를 클릭하여 계속 진행합니다.
VS Code로 리디렉션됩니다. 여기서 Google Home 확장 프로그램이 URI를 열도록 허용하려면 권한이 필요합니다. 열기를 클릭하여 로그인 프로세스를 완료합니다.
로그인하면 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 어시스턴트 SIMULATOR를 클릭합니다. 메시지 상자에 쿼리를 입력하고 Enter를 누릅니다.
Assistant Simulator 응답을 확인하고 쿼리 다음에 오는 버튼을 클릭하여 다시 전송할 수 있습니다.
일괄 발언 실행
Google 어시스턴트 SIMULATOR 메뉴 바로 위로 마우스를 가져간 후 다음 옵션 중에서 선택하여 스크립트를 설정합니다.
를 클릭하여 기존 발화 스크립트를 엽니다.
를 클릭하여 기록을
*.utterance스크립트에 저장합니다.
일괄 발화를 보내려면 다음 옵션 중에서 선택하세요.
- 를 클릭하여 드롭다운 창에서 발화 스크립트를 선택합니다.
*.utterance파일을 직접 열고 를 클릭합니다.
Cloud Logging 보기
빠른 액세스에서 Cloud 로그를 클릭하여 Cloud 로그 페이지를 엽니다. 이 페이지에서 선택한 프로젝트에 속한 로그를 찾을 수 있습니다.
사용자는 심각도와 기간을 기준으로 로그를 필터링할 수 있습니다.
기본적으로 로그는 50행으로 제한됩니다. 사용자가 더 많은 로그를 보려면 아래로 스크롤하고 More를 클릭하여 더 많은 로그를 봅니다.
Home Graph 보기 및 테스트 실행
빠른 액세스에서 홈 그래프 뷰어를 클릭하여 홈 그래프 뷰어 패널을 엽니다. 이 패널에서 선택한 프로젝트에 속한 기기를 찾을 수 있습니다. Run Test를 클릭하여 기기 테스트를 실행할 수도 있습니다.
이렇게 하면 기기가 선택되어 테스트 준비가 된 상태로 브라우저에서 테스트 모음이 실행됩니다. 시작을 클릭하고 테스트 결과를 기다립니다.
모든 테스트가 완료된 후 테스트 세부정보를 확인하고 로그를 볼 수 있습니다.
Matter 디버깅에 Google Home 확장 프로그램 사용하기
Android 로깅
MATTER LOGGING Tools(MATTER 로깅 도구)에서 Android Logs(로그)를 클릭하여 Android Logs(로그) 페이지를 열고 연결할 Android 휴대폰을 선택하여 로그를 표시하기 시작합니다.
Android 휴대전화가 연결되면 로그를 한 줄씩 볼 수 있습니다. 로그가 필터링되어 GHA 및 Google Play services Matter 모듈과 관련된 로그만 표시됩니다. 심각도를 설정하여 로그를 필터링하거나 로그에서 키워드를 검색할 수도 있습니다.
Matter 기기 로깅
MATTER LOGGING Tools(중요 로깅 도구)에서 Device Logs(기기 로그)를 클릭하여 Resources 페이지를 열고 먼저 SoC Type을 선택합니다.
그런 다음 Matter 기기를 선택합니다.
그런 다음 기기에서 모든 기기 로그를 가져오고 심각도 및 검색과 같은 필터를 사용하여 관심 있는 정보를 찾을 수 있습니다.
모든 Matter 로그 다운로드
빠른 액세스에서 로그 다운로드를 클릭하여 로그 다운로드 대화상자를 열고 다운로드할 로그를 선택한 후 확인을 누릅니다.
로그를 다운로드할 폴더를 선택하고 저장을 클릭합니다.
그러면 로그가 대상 폴더에 저장됩니다.
저장된 ZIP 파일의 압축을 풀면 기기 정보와 로그 파일이 표시됩니다.
기기 정보 파일에는 문제를 디버그하는 데 필요한 모든 버전 정보가 포함됩니다.
의견 보내기
Google Home Extension의 개발 환경 개선 방법에 관한 생각이나 의견을 제출하려면 다음 옵션 중에서 선택하세요.
- 도움말 및 의견 패널에서 의견 보내기를 클릭하여 의견을 보내주세요.
- 도움말 및 의견 패널에서 문제 신고를 클릭하여 Google Home Extension에서 발견한 문제를 신고합니다.
- 리소스 페이지에 의견 아이콘도 제공됩니다.