Site updated at 2017-07-23 21:47:49 UTC
This commit is contained in:
Travis CI
parent
1905927b56
commit
2aef88847d
30 changed files with 108 additions and 85 deletions
|
|
@ -8,7 +8,7 @@
|
|||
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
||||
<title>Google Assistant - Home Assistant</title>
|
||||
<meta name="author" content="Home Assistant">
|
||||
<meta name="description" content="Enhance your Hass.io installation with google assistant.">
|
||||
<meta name="description" content="Enhance your Hass.io installation with Google Assistant.">
|
||||
<meta name="viewport" content="width=device-width">
|
||||
<link rel="canonical" href="https://home-assistant.io/addons/google_assistant/">
|
||||
<meta property="fb:app_id" content="338291289691179">
|
||||
|
|
@ -16,12 +16,12 @@
|
|||
<meta property="og:site_name" content="Home Assistant">
|
||||
<meta property="og:url" content="https://home-assistant.io/addons/google_assistant/">
|
||||
<meta property="og:type" content="article">
|
||||
<meta property="og:description" content="Enhance your Hass.io installation with google assistant.">
|
||||
<meta property="og:description" content="Enhance your Hass.io installation with Google Assistant.">
|
||||
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:site" content="@home_assistant">
|
||||
<meta name="twitter:title" content="Google Assistant">
|
||||
<meta name="twitter:description" content="Enhance your Hass.io installation with google assistant.">
|
||||
<meta name="twitter:description" content="Enhance your Hass.io installation with Google Assistant.">
|
||||
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
|
||||
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
|
||||
<link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
|
||||
|
|
@ -75,15 +75,16 @@
|
|||
</h1>
|
||||
</header>
|
||||
<hr class="divider">
|
||||
<p><a href="https://assistant.google.com/">Google Assistant</a> is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms and interact over <a href="https://api.ai/">api.ai</a> with Home-Assistant. You can also use <a href="https://actions.google.com/">Google Actions</a> to make extended functionality.</p>
|
||||
<p><a href="https://assistant.google.com/">Google Assistant</a> is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms and interact over <a href="https://api.ai/">api.ai</a> with Home-Assistant. You can also use <a href="https://actions.google.com/">Google Actions</a> to extend its functionality.</p>
|
||||
<p>To enable access to the Google Assistant API, do the following:</p>
|
||||
<ol>
|
||||
<li>In the Cloud Platform Console, go to the Projects page. Select an existing project or create a new <a href="https://console.cloud.google.com/project">project</a></li>
|
||||
<li>Enable the Google Assistant <a href="https://console.developers.google.com/apis/api/embeddedassistant.googleapis.com/overview">API</a> on the project you selected</li>
|
||||
<li>Create an <a href="https://console.developers.google.com/apis/credentials/oauthclient">OAuth Client ID</a> as type “others” and download the json file with arrow done on the right site.</li>
|
||||
<li>In the <a href="https://console.cloud.google.com/project">Cloud Platform Console</a>, go to the Projects page. Select an existing project or create a new project</li>
|
||||
<li>Open the project. In the top of the page search for Google Assistant API or use <a href="https://console.developers.google.com/apis/api/embeddedassistant.googleapis.com/overview">this link</a> and enable it.</li>
|
||||
<li>Create an <a href="https://console.developers.google.com/apis/credentials/oauthclient">OAuth Client ID</a>, pick type “Other”, click “Create” and download the JSON file by clicking the Download JSON button on the right side.</li>
|
||||
</ol>
|
||||
<p>Now install and activate the <a href="/addons/samba/">Samba</a> add-on so you can upload your credential file. Connect to the “share” Samba share and copy your training data over. Name the file <code class="highlighter-rouge">google_assistant.json</code>.</p>
|
||||
<p>Now it’s time to start Google Assistant for the first time. When the Google Assistant add-on starts, it will output your audio devices:</p><pre><code class="language-plain">**** List of PLAYBACK Hardware Devices ****
|
||||
<p>Now install and activate the <a href="/addons/samba/">Samba</a> add-on so you can upload your credential file. Connect to the “share” Samba share and copy your credentials over. Name the file <code class="highlighter-rouge">google_assistant.json</code>.</p>
|
||||
<p>Now it’s time to start Google Assistant for the first time. When the Google Assistant add-on starts, it will output your audio devices in the “Logs” card. You might have to hit “refresh” to get the latest logs:</p>
|
||||
<div class="language-text highlighter-rouge"><pre class="highlight"><code>**** List of PLAYBACK Hardware Devices ****
|
||||
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
|
||||
Subdevices: 8/8
|
||||
Subdevice #0: subdevice #0
|
||||
|
|
@ -97,14 +98,19 @@ card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
|
|||
card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
|
||||
Subdevices: 1/1
|
||||
Subdevice #0: subdevice #0
|
||||
card 1: Microphone [Yeti Stereo Microphone], device 0: USB Audio [USB Audio]
|
||||
Subdevices: 1/1
|
||||
Subdevice #0: subdevice #0
|
||||
</code></pre>
|
||||
<p>You need to use this information to configure the <code class="highlighter-rouge">mic</code> and <code class="highlighter-rouge">speaker</code> configuration options. The format is <code class="highlighter-rouge"><card #>,<device #></code>. On a Raspberry Pi 3, <code class="highlighter-rouge">0,0</code> is the built-in headset port, <code class="highlighter-rouge">0,1</code> is the HDMI port.</p>
|
||||
<p>We need also connect our Google Assistant with google account. Try open the oauth2 interface with http://hassio.local:9324 and follow the steps on that page.</p>
|
||||
<p>Now that you’ve found the microphone and speaker addresses, it’s time to configure Google Assistant and restart the add-on.</p>
|
||||
</div>
|
||||
<p>You need to use this information to point the add-on at the right speakers and microphone. The information describes different cards and devices. On a Raspberry Pi 3, card 0 - device 0 is the built-in headset port, card 0 - device 1 is the HDMI port. In the example above, the USB microphone showed up as card 1 - device 0.</p>
|
||||
<p>Find the microphone and speakers that you want to use and note down their device and card number. We will need that to configure the add-on options <code class="highlighter-rouge">mic</code> (microphone to use) and <code class="highlighter-rouge">speaker</code> (speaker to use). The format for these options is <code class="highlighter-rouge"><card #>,<device #></code>. Change the configuration options and click save.</p>
|
||||
<p>The next step is to authenticate your Google account with Google Assistant. Start the add-on and click on the “OPEN WEB UI” button to start authentication.</p>
|
||||
<h3>Add-On configuration</h3>
|
||||
<p>Configuration example that uses the USB microphone and use the built-in headset audio output on the Raspberry Pi. Note that card and device numbers can differ on your device.</p>
|
||||
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
|
||||
</span><span class="nt">"mic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1,0"</span><span class="p">,</span><span class="w">
|
||||
</span><span class="nt">"speaker"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1,0"</span><span class="p">,</span><span class="w">
|
||||
</span><span class="nt">"speaker"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0,0"</span><span class="p">,</span><span class="w">
|
||||
</span><span class="nt">"client_secrets"</span><span class="p">:</span><span class="w"> </span><span class="s2">"google_assistant.json"</span><span class="p">,</span><span class="w">
|
||||
</span><span class="err">}</span><span class="w">
|
||||
</span></code></pre>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue