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

Android 스튜디오용 Google Home 플러그인

Google Home Plugin for Android Studio은(는) Google을 위해 디자인되고 제작되었습니다 Google Home Platform 개발자입니다. 이 플러그인을 사용하면 Google Assistant Simulator, Cloud Logging, 기타 도구에 액세스하여 스마트 홈 개발 프로세스를 간소화할 수 있습니다.

보안 알림

Android Studio에서 보안 비밀을 저장하고 다음 단계를 완료하세요.

파일과 설정...을 차례로 클릭합니다.
디자인 및 동작으로 이동하여 시스템 설정을 펼친 다음 클릭합니다. 비밀번호.
저장하지 않음, 다시 시작한 후 비밀번호 삭제를 선택합니다.

기능

어시스턴트 시뮬레이터

스마트 홈 기기가 Google Home과 제대로 호환되는지 테스트하기 위해 언제든지 Assistant Simulator과(와) 상호작용하지 않고도 Android Studio에서 나가고 있습니다.

기존 어시스턴트와 유사 시뮬레이터 제공 Actions on Google Console 콘솔에서 Assistant Simulator를 사용하면 검색어 입력 등을 이용해 기기를 쉽게 제어할 수 있습니다. "조명 켜 줘." Android Studio 내부, Assistant Simulator에서 사용자의 데이터를 기반으로 문자 메시지로 응답합니다. 명령(예: "알겠습니다. 조명 켜 줘.")

Cloud Logging 보기

Google Cloud Logging 드림 는 디버깅 정보와 주요 측정항목을 제공하여 작업의 사용입니다. 개발을 간소화하기 위해 Google Home Plugin는 다음과 같이 작동합니다. 코드 바로 옆에 실시간으로 Cloud Logging 메시지를 문제를 해결할 수 있습니다.

실시간 로그를 표시하거나 기간을 선택할 수 있습니다.

일괄 발언

단일 발화에 대한 Assistant Simulator 응답이 계산되지 않음 결정론적입니다. 예를 들어 응답은 다음 문구 중 하나일 수 있습니다.

알겠습니다. 조명 2개를 켭니다.
물론입니다. 조명 2개를 켭니다.
알겠습니다. 조명 2개를 켭니다.
알겠습니다. 조명 2개를 켭니다.

자동 테스트를 실행하고 Google 통합이 일괄 음성을 사용하여 발화 스크립트를 실행하여 Assistant Simulator 스크립트가 응답을 수집하고 쿼리에 대해 여러 테스트를 실행할 수 있습니다.

홈 그래프 뷰어

Home Graph Viewer를 사용하면 기기의 상태를 표시하고 브라우저에서 Google Home 테스트 모음을 실행할 수 있습니다.

Android 디버그 브리지 (adb) 로그 뷰어

Adb 로그 뷰어는 로그 파일을 보고 분석하는 도구입니다. 예를 들면 다음과 같습니다. 기기 로그 파일 Matter개, Google Home 로그, Android 할 수 있습니다

설치

Android Studio에 Google Home Plugin를 설치하려면 다음 단계를 따르세요.

Android Studio를 다운로드하거나 업데이트합니다.
중요: 사용하려면 Android Studio - Chipmunk (2021.2.1) 이상이 있어야 합니다. 있습니다. 자세한 내용은 호환성 범위
Android 스튜디오 다운로드
File > Settings(MacOS의 경우 Android Studio > Preferences)로 이동합니다.
Plugins 섹션에서 Marketplace로 이동하여 google home입니다.
도구를 설치하고 Android Studio를 다시 시작합니다.

또한 JetBrains Marketplace

설정

플러그인을 설치한 후에는 다음 작업을 수행해야 합니다. Assistant Simulator 및 Cloud Logging 보기:

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

Google 계정으로 로그인

Google Home 패널에서 개발자 계정에 로그인하고 Android Studio이(가) Google과 통신하도록 승인 중 사용자를 대신하여 구독 서비스를 제공합니다

왼쪽의 세로 탭 열에서 Google Home 탭을 클릭합니다. Android Studio 창의 측면으로 이동하세요.
로그인에서 Google을 클릭하여 브라우저를 실행합니다.
스마트 홈 기기와 연결된 계정을 선택합니다.
Google 계정으로 로그인 승인 페이지에서 허용을 클릭합니다.
브라우저 창을 닫고 Android Studio로 돌아갑니다.

이제 로그인되고 로그아웃 옵션이 표시됩니다.

Cloud 프로젝트 선택

로그인한 후 드롭다운에서 프로젝트를 선택합니다. 필터를 사용하려면 필터 표현식(예: matter)을 입력한 후 Enter입니다.

프로젝트 드롭다운은 Filter를 상속하는 클래스를 만들 수 없습니다. 종료해도 선택사항은 유지됩니다. Android Studio

프로젝트 필터에 관한 도움말은 Google Cloud 참조의 쿼리 매개변수를 참고하세요.

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

Android Studio에서 Assistant Simulator를 열려면 다음 안내를 따르세요. Google Home Plugin 패널에서 발화 패널을 클릭합니다.

Assistant Simulator에 쿼리를 전송하는 방법에는 여러 가지가 있습니다. 다음으로 각 옵션을 살펴보겠습니다

쿼리 입력 및 응답 수집

Assistant Simulator와 상호작용하려면 쿼리를 입력하고 Enter 키를 누르세요.

쿼리 끝에 있는 재전송 아이콘을 클릭하여 쿼리를 다시 보낼 수 있습니다.

쿼리를 하나 이상 제출한 후 재생을 클릭하여 쿼리를 다시 실행하고 응답을 확인합니다. 발언 패널에서는 쿼리 및 응답을 캐시합니다 다시보기는 새로운 응답만 추가합니다. 새 쿼리를 클릭할 때마다 쿼리가 중복되지 않게 하고 버튼을 클릭합니다.

저장을 클릭하여 쿼리를 저장하고 입력한 응답을 발언 패널 상호작용은 다음에서 JSON으로 변환됩니다. 형식:

ask: 검색어입니다.
answers: 가능한 Assistant Simulator 응답의 배열입니다.

Android Studio에서 이 JSON 파일을 수정할 수 있습니다.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

일괄 응답 수집

Google Home Plugin 패널에서 발언 파일을 클릭하여 엽니다. 저장된 JSON 파일이 새 탭에 표시됩니다. 경로 선택에서 파일 또는 폴더를 선택합니다. 폴더를 선택하면 수집 및 테스트가 해당 폴더의 모든 발화 .json 파일에서 작동합니다.

동일한 파일 또는 다른 파일(예: lights, lights(1), plug)의 탭을 여러 개 열 수 있습니다.

상태 표시줄에 마지막 테스트의 결과가 표시됩니다 (해당하는 경우). 노란색 또는 녹색 점이 파일이 수집되었음을 나타냅니다. 발화 .json 파일 경로 클릭 후 수집, Assistant Simulator가 쿼리를 실행합니다. 새 응답이 수집되면 알림이 전송되며 상태 표시줄이 쿼리가 처리되는 동안 카운터가 표시됩니다.

수집이 완료되면 상태 표시줄이 녹색 체크표시로 업데이트됩니다. .json 경로 앞에 추가하면 발화 파일은 예측이 가능합니다.

{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

수집을 일찍 중지하면 .json 경로가 수집된 것으로 표시되지 않습니다.

일괄 발화 테스트

응답을 수집한 후 쿼리를 재생하기 위한 테스트 응답과 로그를 확인합니다 일괄 발화를 테스트할 때 Assistant Simulator은 JSON에 저장된 응답을 기대합니다. 파일에서 참조됩니다. 테스트에서 수집되지 않은 응답이 반환되면 다음 응답과 비슷한 알림을 표시합니다.

Expected one of: "Got it, turning on 2 lights."

이 시나리오는 테스트가 실패했음을 나타냅니다. 그렇지 않으면 Assistant Simulator에서 각 쿼리를 실행하고 응답을 반환합니다. 검사가 테스트가 성공한 경우 상태 표시줄

Cloud Logging 보기

Cloud 로그 도구 창에서 프로젝트 탭을 열려면 Cloud 로그를 클릭합니다. Google Home Plugin 패널에서 선택합니다. 별도의 Cloud 로그 탭을 열 수 있습니다. 확인할 수 있습니다

검색어

선택한 프로젝트의 경우 쿼리 필드를 사용하여 로그를 필터링할 수도 있습니다. 예를 들어 light 키워드의 로그를 필터링하려면 다음을 실행합니다.

QL 사용을 선택하여 사용합니다. Logging 쿼리 언어.

다음은 시작하는 데 도움이 되는 QL 쿼리의 몇 가지 예시입니다.

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

날짜 및 시간 쿼리

날짜별 로그 쿼리도 선택사항이며 다음을 클릭하여 사용 설정할 수 있습니다. After 및 Before 텍스트에 날짜 및 시간 형식을 입력할 수 있습니다. 필드(예: 5/11/22, 12:37 PM)가 제공되거나 날짜 선택 도구를 사용할 수 있습니다. 날짜를 선택한 다음 텍스트 입력란에 시간을 입력하세요.

5/1/22 이후의 날짜를 선택하려면 이후를 선택하고 날짜 아이콘 을 클릭합니다.
5/1/22 이전 날짜를 선택하려면 이전을 선택하고 날짜를 클릭합니다. 아이콘 을 클릭합니다.
5/1/22~6/30/22 사이의 날짜를 선택하려면 이전 및 이후를 탭하고 날짜 아이콘에서 날짜를 선택합니다. 입니다.

실시간을 선택하여 실시간 프로젝트 로그를 가져옵니다. 중지를 클릭하여 실시간 피드를 종료합니다.

심각도 수준

드롭다운에서 최소 심각도를 선택할 수도 있습니다.

쿼리 결과

가져오기를 클릭하여 제출합니다. 쿼리 매개변수를 추가할 수 있습니다.

로그가 로드되면 기록 을 클릭하여 전체 JSON 페이로드를 펼칩니다. 다시 클릭 전체 메시지를 표시합니다.

필요한 경우 필터 상자에 키워드를 입력하여 로그 범위를 좁힐 수 있습니다. 있습니다. 필터를 삭제하고 원래 상태로 돌아가려면 x를 클릭하세요. 결과를 가져올 수 있습니다

Home Graph 보기 및 테스트 실행

기기를 표시하려면 Google Home Plugin 패널에서 Home 그래프를 선택합니다.

클릭 새로고침하여 기기의 기기 이름, 기기 ID, 기기 유형 서비스 계정 키를 선택할 수 있습니다 여러 개의 별도의 프로젝트를 위해 Google Home Graph 패널이 열립니다.

기기가 로드되면 아무 기록이나 클릭하세요. : 전체 펼치기 JSON 페이로드.

펼치기 및 접기를 사용하여 JSON을 표시하거나 숨길 수도 있습니다. 페이로드가 포함되어 있습니다

특정 기기의 테스트 모음을 실행하려면 다음 단계를 따르세요. 테스트를 클릭합니다. 그러면 브라우저에서 테스트 모음이 기기가 선택되었으며 테스트할 준비가 되었습니다. 시작을 클릭하고 테스트 결과를 기다립니다.

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

Android 디버그 브리지 (adb) 로그 뷰어

Adb 로그 도구 창에서 프로젝트 탭을 열려면 Adb Log 명령어를 클릭합니다. 을 클릭합니다. 별도의 Adb 로그를 열 수 있습니다. 각 로그 파일의 탭을 클릭합니다. 탭을 삭제하려면 아이콘

Select 필드를 사용하여 표시할 특정 로깅 구성요소를 선택하고 Severity 드롭다운을 사용하여 일치하는 로그 심각도가 있는 항목만 표시합니다.

선택한 adb 로그의 경우 Filter 선택사항인 대소문자 구분 또는 Regex 수정자를 포함하는 필드입니다.

또한 다음을 수행할 수 있습니다.

Find(찾기) 필드와 Find Next(다음 찾기)( 아이콘) 및 Find Previous(이전 찾기)( 아이콘) 명령어를 사용하여 특정 항목을 찾습니다.
선택사항으로 대소문자 구분 또는 정규식 수정자를 사용하세요.
줄로 이동을 클릭하여 로그에서 지정된 줄(번호로)로 이동합니다.

번호 매기기를 선택하여 줄 번호가 추가된 로그 줄을 확인합니다. 원본을 선택합니다. 원시 로그 항목을 볼 수 있습니다

리소스 및 의견

개발자 도구 및 리소스 목록을 보려면 리소스를 클릭합니다.

서비스 개선을 위한 의견이나 아이디어 제출 Google Home Plugin 사용 경험에 대한 자세한 내용은 의견을 클릭하세요.