mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 15:26:59 +00:00
Add amcrest camera services and deprecate switches (#9180)
* Add amcrest services and deprecate switches * Rename services * Update amcrest.markdown Refer to amcrest-specific services as just "services." Referring to them as "camera services" can be misleading, since the services are not in the camera domain.
This commit is contained in:
parent
796e0211ce
commit
ac958d5ad8
@ -29,7 +29,7 @@ There is currently support for the following device types within Home Assistant:
|
|||||||
- Binary Sensor
|
- Binary Sensor
|
||||||
- Camera
|
- Camera
|
||||||
- Sensor
|
- Sensor
|
||||||
- Switch
|
- Switch (deprecated)
|
||||||
|
|
||||||
## {% linkable_title Configuration %}
|
## {% linkable_title Configuration %}
|
||||||
|
|
||||||
@ -129,7 +129,7 @@ sensors:
|
|||||||
description: >
|
description: >
|
||||||
Return `true`/`false` when motion is detected.
|
Return `true`/`false` when motion is detected.
|
||||||
|
|
||||||
**Note:** This sensor is deprecated and will be removed in a future release.
|
**Note:** The motion_detector sensor is deprecated and will be removed in a future release.
|
||||||
Use **binary_sensors** option **motion_detected** instead.
|
Use **binary_sensors** option **motion_detected** instead.
|
||||||
sdcard:
|
sdcard:
|
||||||
description: Return the SD card usage by reporting the total and used space.
|
description: Return the SD card usage by reporting the total and used space.
|
||||||
@ -140,6 +140,10 @@ sensors:
|
|||||||
switches:
|
switches:
|
||||||
description: >
|
description: >
|
||||||
Switches to display in the frontend.
|
Switches to display in the frontend.
|
||||||
|
|
||||||
|
**Note:** Switches are deprecated and will be removed in a future release.
|
||||||
|
Use services and attributes instead.
|
||||||
|
|
||||||
The following switches can be monitored:
|
The following switches can be monitored:
|
||||||
required: false
|
required: false
|
||||||
type: list
|
type: list
|
||||||
@ -163,9 +167,66 @@ Newer Amcrest firmware may not work, then **rtsp** is recommended instead.
|
|||||||
make sure to follow the steps mentioned at [FFMPEG](/components/ffmpeg/)
|
make sure to follow the steps mentioned at [FFMPEG](/components/ffmpeg/)
|
||||||
documentation to install the `ffmpeg`.
|
documentation to install the `ffmpeg`.
|
||||||
|
|
||||||
To check if your Amcrest camera is supported/tested, visit the
|
## {% linkable_title Services %}
|
||||||
[supportability matrix](https://github.com/tchellomello/python-amcrest#supportability-matrix)
|
|
||||||
link from the `amcrest` project.
|
Once loaded, the `amcrest` component 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.
|
||||||
|
|
||||||
|
Available services:
|
||||||
|
`enable_audio`, `disable_audio`,
|
||||||
|
`enable_motion_recording`, `disable_motion_recording`,
|
||||||
|
`enable_recording`, `disable_recording`,
|
||||||
|
`goto_preset`, `set_color_bw`,
|
||||||
|
`start_tour` and `stop_tour`
|
||||||
|
|
||||||
|
#### {% linkable_title Service `enable_audio`/`disable_audio` %}
|
||||||
|
|
||||||
|
These services enable or disable the camera's audio stream.
|
||||||
|
|
||||||
|
Service data attribute | Optional | Description
|
||||||
|
-|-|-
|
||||||
|
`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
|
||||||
|
|
||||||
|
#### {% linkable_title Service `enable_motion_recording`/`disable_motion_recording` %}
|
||||||
|
|
||||||
|
These services enable or disable the camera to record a clip to its configured storage location when motion is detected.
|
||||||
|
|
||||||
|
Service data attribute | Optional | Description
|
||||||
|
-|-|-
|
||||||
|
`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
|
||||||
|
|
||||||
|
#### {% linkable_title Service `enable_recording`/`disable_recording` %}
|
||||||
|
|
||||||
|
These services enable or disable the camera to continuously record to its configured storage location.
|
||||||
|
|
||||||
|
Service data attribute | Optional | Description
|
||||||
|
-|-|-
|
||||||
|
`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
|
||||||
|
|
||||||
|
#### {% linkable_title Service `goto_preset` %}
|
||||||
|
|
||||||
|
This service will cause the camera to move to one of the PTZ locations configured within the camera.
|
||||||
|
|
||||||
|
Service data attribute | Optional | Description
|
||||||
|
-|-|-
|
||||||
|
`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
|
||||||
|
`preset` | no | Preset number, starting from 1.
|
||||||
|
|
||||||
|
#### {% linkable_title Service `set_color_bw` %}
|
||||||
|
|
||||||
|
This service will set the color mode of the camera.
|
||||||
|
|
||||||
|
Service data attribute | Optional | Description
|
||||||
|
-|-|-
|
||||||
|
`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
|
||||||
|
`color_bw` | no | One of `auto`, `bw` or `color`.
|
||||||
|
|
||||||
|
#### {% linkable_title Service `start_tour`/`stop_tour` %}
|
||||||
|
|
||||||
|
These services start or stop the camera's PTZ tour function.
|
||||||
|
|
||||||
|
Service data attribute | Optional | Description
|
||||||
|
-|-|-
|
||||||
|
`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
|
||||||
|
|
||||||
## {% linkable_title Advanced Configuration %}
|
## {% linkable_title Advanced Configuration %}
|
||||||
|
|
||||||
@ -181,9 +242,6 @@ amcrest:
|
|||||||
- motion_detected
|
- motion_detected
|
||||||
sensors:
|
sensors:
|
||||||
- sdcard
|
- sdcard
|
||||||
switches:
|
|
||||||
- motion_detection
|
|
||||||
- motion_recording
|
|
||||||
|
|
||||||
# Add second camera
|
# Add second camera
|
||||||
- host: IP_ADDRESS_CAMERA_2
|
- host: IP_ADDRESS_CAMERA_2
|
||||||
|
Loading…
x
Reference in New Issue
Block a user