jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Blink documentation update (#2293)

Browse Source 
* Blink documentation update

Added force_update service and increased time between server calls

* Fixed double ticks and bad sentence
This commit is contained in:
Kevin Fronczak 2017-05-05 01:10:55 -04:00 committed by Paulus Schoutsen
parent 98618fa6ec
commit 15bab812ea
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
source/_components/blink.markdown
View File

@ -33,15 +33,16 @@ Once loaded, your front end will have the following components:
* A sensor per camera that reports battery level. * A sensor per camera that reports battery level.
* A sensor per camera that reports unread notification (ie. detected motion events). * A sensor per camera that reports unread notification (ie. detected motion events).
Since the cameras are battery operated, the images are only updated in Home Assistant when the user manually forces a new photo. The image can only be updated in Home Assistant every 60 seconds in order to not overwhelm Blink's servers with API requests. 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 `blink.snap_picture` service followed by a `blink.force_update` service call to force Home Assistant to request an update from Blink's servers. If the `blink.force_update` 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.
Services: Services:
There are three services availiabe for the blink platform: There are three services availiabe for the blink platform:
- arm_system - arm_system
- arm_camera - arm_camera
- snap_picture - snap_picture
- force_update
For arm_system, the value sent can be either "True" or "False" and will arm and disarm the whole blink system, respectively For `blink.arm_system`, the value sent can be either "True" or "False" and will arm and disarm the whole blink system, respectively
Arm system example Arm system example
```json ```json
@ -50,7 +51,7 @@ Arm system example
} }
``` ```
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 blink.arm_camera service with the following payload: 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 `blink.arm_camera` service with the following payload:
```json ```json
{ {
"friendly_name": "Living Room", "friendly_name": "Living Room",
@ -58,13 +59,15 @@ Arm camera follows a similar structure, but each indidivual camera can have moti
} }
``` ```
The blink.snap_picture service takes the camera name as the payload and with take a new picture with your camera. The `blink.snap_picture` service takes the camera name as the payload and with take a new picture with your camera.
``` ```
{ {
"friendly_name": "Living Room" "friendly_name": "Living Room"
} }
``` ```
The `blink.force_update` service can simply be called with no payload to force a server update.
Configuration variables: Configuration variables:
- **username** (*Required*): Your username to login to Blink - **username** (*Required*): Your username to login to Blink