Google Assistant


구글홈 또는 스마트폰의 구글 어시스턴트와 연결하려면 [구글 어시스턴트 컴포넌트][AssistantIntergration]를 사용합니다.

구글 어시스턴트는 AI로 동작하는 보이스 어시스턴트로서 라즈베리파이나 x86 플랫폼에서 홈어시스턴와 DialogFlow 또는 구글 어시스턴트 컴포넌를 사용해 인터랙션을 합니다. 이들 기능을 확장하기 위해 구글 액션을 추가할 수도 있습니다.

구글 어시스턴트 API를 사용하려면 다음 과정을 거쳐야 합니다:

  1. Google Actions Console로 접속해서 create a new project를 선택하세요.
  2. 프로젝트를 생성한 다음 페이지에서 웹 페이지 하단에 있는 “Device registration”을 찾아 대기합니다. 이 페이지를 닫지 마세요. 아래 과정에서 다시 진행할 것입니다.
  3. 우선 이 곳에서 구글 어시스턴트 API 사용을 확인해야 합니다. Make sure you have the right project selected (shown in the middle of the screen in the top bar). If you can’t select the right project, it may help to open the link in an incognito window.
  4. Configure the OAuth consent screen. Also again check that you have the right project and don’t forget to hit “Save” at the bottom of the page. You only have to fill in a project name and your e-mail.
  5. You back to you device registration tab and click “Device registration”. Or open you project in the Google Actions Console start the Quick setup, and in the left bar click “Device registration”.
  6. Give you project a name, think of a nice manufacturer and for device type select “speaker”.
  7. Edit you “model id”, if you want to and copy it for later use.
  8. Download the credentials.
  9. Click “Next” and click “Skip”.
  10. Upload your credentials as “google_assistant.json” to the “hassio/share” folder, for example by using the Samba add-on.
  11. In the Add-on configuration field fill-in you “project id” and your “model-id” and hit “Save”. Your project id can be found in the Google Actions console by clicking on the top right menu button and selecting “Project settings”. This id may differ from the project name that you choose!
  12. Below the “Config” window select the microphone and speaker that you want to use. On a Raspberry Pi 3, ALSA device 0 is the built-in headset port and ALSA device 1 is the HDMI port. Also don’t forget to click “Save”.
  13. Start the add-on. Check the log and click refresh till it says: “ENGINE Bus STARTED”.
  14. Now click “Open Web UI” and follow the authentication process. You will get an empty response after you have send your token.

That’s it. You should now be able to use the Google Voice assistant.

Add-on configuration

{
  "client_secrets": "google_assistant.json",
  "project_id": "you-project-id",
  "model_id": "your-model-id"
}

Configuration Variables

client_secrets

(string)(Required)

The file downloaded from the Google Actions Console, you can redownload them under the “Develop - Device registration” tab. By default the add-on look in the “hassio/share” folder.

project_id

(string)(Required)

The project id can be found in your “google_assistant.json” file or under project settings in the Google Actions Console.

model_id

(string)(Required)

The model id can also be found under the “Develop - Device registration tab” in the Google Actions Console.

Home Assistant configuration

Use the Home Assistant DialogFlow component to integrate the add-on into Home Assistant or combine it with the Google Assistant component.