jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2017-06-04 20:28:34 UTC

Browse source
This commit is contained in:
Travis CI 2017-06-04 20:28:34 +00:00
parent 376d7e5993
commit bb01d58bc3
26 changed files with 65 additions and 53 deletions
Download patch file Download diff file Expand all files Collapse all files

27
components/blink/index.html
View file

@ -75,6 +75,11 @@
<span class="s">password</span><span class="pi">:</span> <span class="s">YOUR_PASSWORD</span>
</code></pre>
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>username</strong> (<em>Required</em>): Your username to login to Blink.</li>
<li><strong>password</strong> (<em>Required</em>): Your password to login to Blink.</li>
</ul>
<p>Once loaded, your front end will have the following components:</p>
<ul>
<li>A camera image for each camera in your system.</li>
@ -84,41 +89,33 @@
<li>A sensor per camera that reports battery level.</li>
<li>A sensor per camera that reports unread notification (ie. detected motion events).</li>
</ul>
<p>Since the cameras are battery operated, the images are only updated in Home Assistant when the user manually forces a new photo. This image can be updated with the <code class="highlighter-rouge">blink.snap_picture</code> service followed by a <code class="highlighter-rouge">blink.force_update</code> service call to force Home Assistant to request an update from Blink’s servers. If the <code class="highlighter-rouge">blink.force_update</code> service is not called, the image will be updated within a 180 second interval, set so that automatic server requests don’t overwhelm the Blink API. As a note, all of the camera-specific sensors are only polled when a new image is requested from the camera. This means that relying on any of these sensors to provide timely and accurate data is not recommended.</p>
<p>Services:
There are three services availiabe for the blink platform:</p>
<p>Since the cameras are battery operated, the images are only updated in Home Assistant when the user manually forces a new photo. This image can be updated with the <code class="highlighter-rouge">snap_picture</code> service to force Home Assistant to request an update from Blink’s servers. As a note, all of the camera-specific sensors are only polled when a new image is requested from the camera. This means that relying on any of these sensors to provide timely and accurate data is not recommended.</p>
<p>Services:</p>
<p>This services are available for the <code class="highlighter-rouge">blink</code> component:</p>
<ul>
<li>arm_system</li>
<li>arm_camera</li>
<li>snap_picture</li>
<li>force_update</li>
</ul>
<p>For <code class="highlighter-rouge">blink.arm_system</code>, the value sent can be either “True” or “False” and will arm and disarm the whole blink system, respectively</p>
<p>Arm system example</p>
<p>For <code class="highlighter-rouge">arm_system</code>, the value sent can be either <code class="highlighter-rouge">True</code> or <code class="highlighter-rouge">False</code> and will arm and disarm the whole Blink system. Arm system example:</p>
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"device_armed"</span><span class="p">:</span><span class="w"> </span><span class="s2">"True"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
<p>Arm camera follows a similar structure, but each indidivual camera can have motion detection enabled or disabled. Because of this, you also need to supply a name. For example, if I have a camera named “Living Room” and I want to turn off motion detection on that camera, I’d call the <code class="highlighter-rouge">blink.arm_camera</code> service with the following payload:</p>
<p>Arm camera follows a similar structure, but each indidivual camera can have motion detection enabled or disabled. Because of this, you also need to supply a name. For example, if you have a camera named “Living Room” and you want to turn off motion detection on that camera, you would call the <code class="highlighter-rouge">arm_camera</code> service with the following payload:</p>
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"friendly_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Living Room"</span><span class="p">,</span><span class="w">
</span><span class="nt">"device_armed"</span><span class="p">:</span><span class="w"> </span><span class="s2">"False"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
<p>The <code class="highlighter-rouge">blink.snap_picture</code> service takes the camera name as the payload and with take a new picture with your camera.</p>
<div class="highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
<p>The <code class="highlighter-rouge">snap_picture</code> service takes the camera name as the payload and with take a new picture with your camera.</p>
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"friendly_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Living Room"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
<p>The <code class="highlighter-rouge">blink.force_update</code> service can simply be called with no payload to force a server update.</p>
<p>Configuration variables:</p>
<ul>
<li><strong>username</strong> (<em>Required</em>): Your username to login to Blink</li>
<li><strong>password</strong> (<em>Required</em>): Your password to login to Blink</li>
</ul>
<p class="img">
<img src="/images/screenshots/blink_example_frontend.png" />
</p>