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-14 04:46:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add legacy polling option for Amcrest motion detection (#13798)

Browse Source
This commit is contained in:
Phil Bruckner 2020-07-05 07:19:51 -05:00 committed by GitHub
parent 896ff23fb6
commit 8bcdb9ef92
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
source/_integrations/amcrest.markdown
View File

@ -106,7 +106,9 @@ binary_sensors:
default: None
keys:
motion_detected:
description: "Return `on` when a motion is detected, `off` when not."
description: "Return `on` when a motion is detected, `off` when not. Uses streaming method (see [below](#streaming-vs-polled-binary-sensors))."
motion_detected_polled:
description: "Return `on` when a motion is detected, `off` when not. Uses polled method (see [below](#streaming-vs-polled-binary-sensors))."
online:
description: "Return `on` when camera is available (i.e., responding to commands), `off` when not."
sensors:
@ -143,6 +145,10 @@ Newer Amcrest firmware may not work, then `rtsp` is recommended instead.
make sure to follow the steps mentioned at [FFmpeg](/integrations/ffmpeg/)
documentation to install the `ffmpeg`.
### Streaming vs Polled Binary Sensors
Some binary sensors provide two choices for method of operation: streaming or polled. Streaming is more responsive and causes less network traffic because the camera will tell Home Assistant when the sensor's state has changed. Polled mode queries the camera periodically (every five seconds) to check the state of the sensor. Therefore streaming is the better option. However, some camera models and versions of camera firmware do not seem to implement the streaming method properly. Therefore the polled mode is also available. It is recommended to use the streaming mode (e.g., `motion_detected`) first, and if that doesn't work (e.g., results in constant errors), then try the polled mode instead (e.g., `motion_detected_polled`.)
## Services
Once loaded, the `amcrest` integration will expose services that can be called to perform various actions. The `entity_id` service attribute can specify one or more specific cameras, or `all` can be used to specify all configured Amcrest cameras.