Site updated at 2016-10-22 22:37:41 UTC
This commit is contained in:
Travis CI
parent
ab857e95a7
commit
860912100c
408 changed files with 11332 additions and 1691 deletions
|
|
@ -89,9 +89,15 @@
|
|||
<hr class="divider">
|
||||
|
||||
|
||||
<p>There are two ways that you can use Amazon Echo and Home Assistant together.</p>
|
||||
<p>There are a few ways that you can use Amazon Echo and Home Assistant together.</p>
|
||||
|
||||
<p>No matter which method(s) you decide to use, please remember that Amazon Echo requires an active Internet connection to function. If your Internet is down or experiencing issues (or Amazon’s infrastructure is having issues), neither of these methods will work.</p>
|
||||
<ul>
|
||||
<li><a href="#i-just-want-to-turn-devices-on-and-off-using-echo">Turning devices on and off</a></li>
|
||||
<li><a href="#i-want-to-build-custom-commands-to-use-with-echo">Build custom commands to use</a></li>
|
||||
<li><a href="#flash-briefing-skills">Create a new Flash Briefing source</a></li>
|
||||
</ul>
|
||||
|
||||
<p>No matter which method(s) you decide to use, please remember that Amazon Echo requires an active Internet connection to function. If your Internet is down or experiencing issues (or Amazon’s infrastructure is having issues), none of these methods will work.</p>
|
||||
|
||||
<p>Amazon has released <a href="https://echosim.io/">Echosim</a>, a website that simulates the Alexa service in your browser. That way it is easy to test your skills without having access to a physical Amazon Echo.</p>
|
||||
|
||||
|
|
@ -143,9 +149,10 @@
|
|||
|
||||
<ul>
|
||||
<li>Log in to <a href="https://developer.amazon.com">Amazon developer console</a></li>
|
||||
<li>Go to Apps & Services => Alexa => Alexa Skill Kit - Get Started</li>
|
||||
<li>Add a new skill
|
||||
<li>Click the Alexa button at the top of the console</li>
|
||||
<li>Click the yellow “Add a new skill” button in the top right
|
||||
<ul>
|
||||
<li>Skill Type: Custom Interaction Model (default)</li>
|
||||
<li>Name: Home Assistant</li>
|
||||
<li>Invocation name: home assistant (or be creative, up to you)</li>
|
||||
<li>Version: 1.0</li>
|
||||
|
|
@ -159,6 +166,8 @@
|
|||
</li>
|
||||
</ul>
|
||||
|
||||
<p>You can use this <a href="/images/components/alexa/alexa-512x512.png">specially sized Home Assistant logo</a> as the large icon and <a href="/images/components/alexa/alexa-108x108.png">this one</a> as the small one.</p>
|
||||
|
||||
<h3><a class="title-link" name="configuring-your-amazon-alexa-skill" href="#configuring-your-amazon-alexa-skill"></a> Configuring your Amazon Alexa skill</h3>
|
||||
|
||||
<p>Alexa works based on intents. Each intent has a name and variable slots. For example, a <code class="highlighter-rouge">LocateIntent</code> with a slot that contains a <code class="highlighter-rouge">User</code>. Example intent schema:</p>
|
||||
|
|
@ -383,6 +392,70 @@ Custom slot type for script support.
|
|||
|
||||
<p>Alexa will now respond with a random phrase each time. You can use the include for as many different intents as you like so you only need to create the list once.</p>
|
||||
|
||||
<h2><a class="title-link" name="flash-briefing-skills" href="#flash-briefing-skills"></a> Flash Briefing Skills</h2>
|
||||
|
||||
<p>As of version <a href="/blog/2016/10/22/flash-briefing-updater-hacktoberfest/">0.31</a> Home Assistant supports the new <a href="https://developer.amazon.com/alexa-skills-kit/flash-briefing">Alexa Flash Briefing Skills API</a>. A Flash Briefing Skill adds a new Flash Briefing source that is generated by Home Assistant.</p>
|
||||
|
||||
<h3><a class="title-link" name="configuring-a-flash-briefing-skill-in-home-assistant" href="#configuring-a-flash-briefing-skill-in-home-assistant"></a> Configuring a Flash Briefing skill in Home Assistant</h3>
|
||||
|
||||
<p>You can use <a href="/topics/templating/">templates</a> for the <code class="highlighter-rouge">title</code>, <code class="highlighter-rouge">audio</code>, <code class="highlighter-rouge">text</code> and <code class="highlighter-rouge">display_url</code> configuration parameters.</p>
|
||||
|
||||
<p>Here’s an example configuration of a Flash briefing skill that will tell you who is at home:</p>
|
||||
|
||||
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
|
||||
<span class="s">alexa</span><span class="pi">:</span>
|
||||
<span class="s">flash_briefings</span><span class="pi">:</span>
|
||||
<span class="s">whoishome</span><span class="pi">:</span>
|
||||
<span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s">Who's at home?</span>
|
||||
<span class="s">text</span><span class="pi">:</span> <span class="pi">></span>
|
||||
<span class="no">{%- if is_state('device_tracker.paulus', 'home') and</span>
|
||||
<span class="no">is_state('device_tracker.anne_therese', 'home') -%}</span>
|
||||
<span class="no">You are both home, you silly</span>
|
||||
<span class="no">{%- else -%}</span>
|
||||
<span class="no">Anne Therese is at {{ states("device_tracker.anne_therese") }}</span>
|
||||
<span class="no">and Paulus is at {{ states("device_tracker.paulus") }}</span>
|
||||
<span class="no">{% endif %}</span>
|
||||
</code></pre>
|
||||
</div>
|
||||
|
||||
<p>You can add multiple items for a feed if you want. The Amazon required uid and timestamp will be randomly generated at startup and change at every restart of Home Assistant.</p>
|
||||
|
||||
<p>Please refer to the <a href="https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/flash-briefing-skill-api-feed-reference">Amazon documentation</a> for more information about allowed configuration parameters and formats.</p>
|
||||
|
||||
<h3><a class="title-link" name="configuring-your-flash-briefing-skill" href="#configuring-your-flash-briefing-skill"></a> Configuring your Flash Briefing skill</h3>
|
||||
|
||||
<ul>
|
||||
<li>Log in to <a href="https://developer.amazon.com">Amazon developer console</a></li>
|
||||
<li>Click the Alexa button at the top of the console</li>
|
||||
<li>Click the yellow “Add a new skill” button in the top right
|
||||
<ul>
|
||||
<li>Skill Information
|
||||
<ul>
|
||||
<li>For Skill Type select Flash Briefing Skill API</li>
|
||||
<li>You can enter whatever name you want</li>
|
||||
<li>Hit next</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Interaction Model
|
||||
<ul>
|
||||
<li>Nothing to do here</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Configuration
|
||||
<ul>
|
||||
<li>Add new feed
|
||||
<ul>
|
||||
<li>For URL, enter <code class="highlighter-rouge">https://YOUR_HOST/api/alexa/flash_briefings/BRIEFING_ID?api_password=YOUR_API_PASSWORD</code> where <code class="highlighter-rouge">BRIEFING_ID</code> is the key you entered in your configuration (such as <code class="highlighter-rouge">whoishome</code> in the above example)</li>
|
||||
<li>You can use this <a href="/images/components/alexa/alexa-512x512.png">specially sized Home Assistant logo</a> as the Feed Icon</li>
|
||||
<li>All other settings are up to you</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
</article>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue