Create google_assistant.markdown

This commit is contained in:
Pascal Vizeli 2017-07-20 14:46:08 +02:00 committed by GitHub
parent c5adab37b6
commit eaadfc46da

View File

@ -0,0 +1,74 @@
---
layout: page
title: "Google Assistant"
description: "Enhance your Hass.io installation with google assistant."
date: 2017-04-30 13:28
sidebar: true
comments: false
sharing: true
footer: true
---
[Google Assistant] is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms. It runs on-device and is Private by Design.
To enable access to the Google Assistant API, do the following:
1) In the Cloud Platform Console, go to the Projects page. Select an existing project or create a new [project]
2) Enable the Google Assistant [API] on the project you selected
3) Create a [service account] and download the json credentials.
Now install and activate the [Samba] add-on so you can upload your training data. Connect to the "share" Samba share and copy your training data over. Name the file `assistant.zip`.
Now it's time to start Snips for the first time. When the Snips add-on starts, it will output your audio devices:
```plain
**** List of PLAYBACK Hardware Devices ****
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
Subdevices: 8/8
Subdevice #0: subdevice #0
Subdevice #1: subdevice #1
Subdevice #2: subdevice #2
Subdevice #3: subdevice #3
Subdevice #4: subdevice #4
Subdevice #5: subdevice #5
Subdevice #6: subdevice #6
Subdevice #7: subdevice #7
card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
Subdevices: 1/1
Subdevice #0: subdevice #0
```
You need to use this information to configure the `mic` and `speaker` configuration options. The format is `<card #>,<device #>`. On a Raspberry Pi 3, `0,0` is the built-in headset port, `0,1` is the HDMI port.
Now that you've found the microphone and speaker addresses, it's time to configure Google Assistant and restart the add-on.
### Add-On configuration
```json
{
"mic": "1,0",
"speaker": "1,0",
"service_account": "service_account.json",
}
```
Configuration variables:
- **mqtt_bridge** (*Optional*): Snips uses MQTT to communicate and defaults to their own broker. Use this config option to bridge their broker to your own.
- **mic**: This is the hardware address of your microphone. Look at the Snips
### {% linkable_title Home Assistant configuration %}
Use the Home Assistant [Snips.ai component][comp] to integrate the add-on into Home Assistant.
```yaml
snips:
```
[Google Assistant]: https://assistant.google.com/
[Samba]: /addons/samba/
[comp]: /components/snips/
[project]: https://console.cloud.google.com/project
[API]: https://console.developers.google.com/apis/api/embeddedassistant.googleapis.com/overview
[service account]: https://console.developers.google.com/apis/credentials/serviceaccountkey