VS Code용 Google Home 확장 프로그램

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 및 스마트 홈 개발 프로세스를 간소화할 수 있습니다.

VS Code용 Google Home 확장 프로그램

Google Home 확장 프로그램 기능

Google 어시스턴트 시뮬레이터

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

Actions 콘솔에 제공된 기존 시뮬레이터와 마찬가지로 Assistant Simulator를 사용하면 "조명 켜기"와 같이 쿼리를 입력하여 기기를 쉽게 제어할 수 있습니다. VS Code 내에서 Assistant Simulator는 명령어에 따라 텍스트 메시지로 응답합니다(예: "Alright, on the lights."). 자세한 내용은 Google 어시스턴트 시뮬레이터 사용을 참고하세요.

일괄 발화

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

법적 사안 로깅 도구

Matter 로깅 도구는 Google Home app (GHA) 로그 및 Google Play 서비스 (GMS 코어) 로그를 포함하여 Matter 디버깅과 관련된 모든 로그를 수집할 수 있습니다. 로그는 VS Code에서 필터 및 키워드 검색을 통해 확인할 수 있습니다. Android, 앱 버전과 같은 추가 디버그 정보와 함께 로그를 다운로드하고 문제 보고를 위해 Google에 전송할 수 있습니다.

Google Home 확장 프로그램 법적 사안 로깅

Cloud Logging

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

Home 그래프 뷰어

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

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

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

  1. 활동 표시줄에서 확장 프로그램 아이콘을 클릭합니다.
  2. google home를 검색한 다음 Install을 클릭합니다.

    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 서비스와 통신하도록 승인할 수 있습니다.

  1. 활동 표시줄에서 Google Home 아이콘을 클릭하여 Google Home Extension를 엽니다.

    Google Home 확장 프로그램 아이콘
  2. Google 계정으로 로그인을 클릭하여 브라우저에서 로그인 보기를 실행합니다.

    VS Code Google 로그인
  3. 스마트 홈 기기와 연결된 계정을 선택합니다.

  4. Google 계정으로 로그인 승인 페이지에서 허용을 클릭합니다.

  5. 브라우저 탭이 열리고 Open Visual Studio Code 대화상자가 표시됩니다. Open Visual Studio Code를 클릭하여 계속 진행합니다.

    VS Code 대화상자 열기
  6. VS Code로 리디렉션됩니다. 여기서 Google Home 확장 프로그램이 URI를 열 수 있도록 허용해야 합니다. 열기를 클릭하여 로그인 프로세스를 완료합니다.

    Google Home 확장 프로그램에서 URI를 열도록 허용
  7. 로그인하면 Google Home Extension에서 프로젝트를 로드합니다. 완료되면 프로젝트 선택을 클릭합니다.

    프로젝트 선택하기
  8. 프로젝트 검색 및 선택 드롭다운 창이 나타나면 스마트 홈 프로젝트를 선택합니다.

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

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

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

Matter 기기 SoC 도구 설치

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

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

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

개발자 리소스 보기

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

Google Home 생태계를 위한 리소스

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

VS Code에서 Assistant Simulator을 열려면 사이드바에서 Google 어시스턴트 SIMULATOR를 클릭합니다. 메시지 상자에 쿼리를 입력하고 Enter를 누릅니다.

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

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

일괄 발언 실행

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

  • 를 클릭하여 기존 발화 스크립트를 엽니다.

  • 를 클릭하여 기록을 *.utterance 스크립트에 저장합니다.

    일괄 발언 메뉴 아이콘

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

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

    일괄 발언 실행 아이콘

Cloud Logging 보기

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

Cloud Logging 사용

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

심각도 및 시간별 로그 필터링

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

로그 더보기

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

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

Home 그래프 뷰어

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

Google Home 테스트 모음

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

테스트 결과

Matter 디버깅에 Google Home 확장 프로그램 사용하기

Android 로깅

머티리얼 로깅 도구에서 Android 로그를 클릭하여 Android 로그 페이지를 열고 연결하려는 Android 휴대폰을 선택하여 로그를 표시하기 시작합니다.

Android 로깅

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

Android 로깅 필터링됨

Matter 기기 로깅

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

Matter 기기 로깅

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

Matter 기기 로깅 기기 선택

그런 다음 기기에서 모든 기기 로그를 가져오고 심각도검색과 같은 필터를 사용하여 관심 있는 정보를 찾을 수 있습니다.

Matter 기기 필터링 로깅

모든 Matter 로그 다운로드

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

Matter 로그 다운로드

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

법적 사안 로그 저장

그런 다음 로그가 대상 폴더에 저장됩니다.

법적 사안 로그 대상 폴더

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

Matter 로그 ZIP 파일

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

Matter 로그 디버그

의견 보내기

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

  • 도움말 및 의견 패널에서 의견 보내기를 클릭하여 의견을 보내주세요.
  • 도움말 및 의견 패널에서 문제 신고를 클릭하여 Google Home Extension에서 발견한 문제를 신고합니다.
의견 보내기 아이콘
  • 리소스 페이지에도 의견 아이콘이 표시됩니다.