From 0934b9c0bf5d9cfa2977c4b319cc1460469879e9 Mon Sep 17 00:00:00 2001 From: Dermot Duffy Date: Sun, 13 Oct 2024 17:17:54 -0700 Subject: [PATCH] docs: Fix PTZ example --- docs/configuration/actions/stock/README.md | 11 ------- docs/examples.md | 38 ++++++++++++---------- 2 files changed, 21 insertions(+), 28 deletions(-) diff --git a/docs/configuration/actions/stock/README.md b/docs/configuration/actions/stock/README.md index 83fbbb4d..805d7219 100644 --- a/docs/configuration/actions/stock/README.md +++ b/docs/configuration/actions/stock/README.md @@ -1,16 +1,5 @@ # Stock Actions -## `call-service` - -Call a service. See [Home Assistant actions documentation](https://www.home-assistant.io/dashboards/actions/). - -!> Home Assistant has deprecated the `call-service` action, please use [`perform-action`](#perform-action) instead. - -```yaml -action: call-service -# [...] -``` - ## `more-info` Open the "more-info" dialog for an entity. See [Home Assistant actions documentation](https://www.home-assistant.io/dashboards/actions/). diff --git a/docs/examples.md b/docs/examples.md index a6285196..d6daf4e2 100644 --- a/docs/examples.md +++ b/docs/examples.md @@ -620,30 +620,34 @@ overrides: ## PTZ control -The card supports using PTZ controls to conveniently control pan, tilt and zoom for cameras. This example shows the PTZ controls on the `live` view. Note that if your camera engine supports it (e.g. `frigate`) this will just work out of the box with no configuration at all. +The card supports using PTZ controls to conveniently control pan, tilt and zoom +for cameras. If you're using a Frigate camera, and Frigate itself shows PTZ +controls, this should work straight out of the box without any extra configuration: ```yaml type: custom:frigate-card cameras: - camera_entity: camera.office -live: - ptz: - orientation: horizontal - service: sonoff.send_command - data_left: - device: '048123' - cmd: left - data_right: - device: '048123' - cmd: right - data_up: - device: '048123' - cmd: up - data_down: - device: '048123' - cmd: down ``` +If you're using a non-Frigate camera, or Frigate itself does not support the PTZ +controls on your camera but Home Assistant does, you can still manually +configure actions for the card to perform for each PTZ control: + +```yaml +type: custom:frigate-card +cameras: + - camera_entity: camera.office + ptz: + actions_left: + action: perform-action + perform_action: homeassistant.toggle + target: + entity_id: switch.camera_move_left +``` + +See the full [Camera PTZ Configuration](./configuration/live.md?id=ptz) for more information. + ## `screen` conditions These examples show altering the card configuration based on device or viewport properties.