Dermot Duffy
f18e4cd4b8
## Summary
- Collapse `live_substream_{on,off,select}` into a unified
`substream_{on,off}` pair, symmetric with `call_{start,end}`.
- Rename the `camera` field on the former `live_substream_select` to
`stream` (it always was a stream ID).
- Add optional `camera` field to both new actions for targeting a
non-selected base camera.
- YAML configs are migrated automatically; URL bookmarks must be updated
by hand.
## Migration
### Cycling between camera and substream (toggle button)
Before:
```yaml
tap_action:
action: custom:advanced-camera-card-action
advanced_camera_card_action: live_substream_on
```
After:
```yaml
tap_action:
action: custom:advanced-camera-card-action
advanced_camera_card_action: substream_on
```
### Selecting a specific substream
Before:
```yaml
tap_action:
action: custom:advanced-camera-card-action
advanced_camera_card_action: live_substream_select
camera: camera.front_door_hd
```
After:
```yaml
tap_action:
action: custom:advanced-camera-card-action
advanced_camera_card_action: substream_on
stream: camera.front_door_hd
```
### Turning the substream off
Before:
```yaml
tap_action:
action: custom:advanced-camera-card-action
advanced_camera_card_action: live_substream_off
```
After:
```yaml
tap_action:
action: custom:advanced-camera-card-action
advanced_camera_card_action: substream_off
```
### URL querystrings (manual update required)
| Before | After |
| --- | --- |
|
`?advanced-camera-card-action.live_substream_select=camera.front_door_hd`
| `?advanced-camera-card-action.substream_on=camera.front_door_hd` |
Configuration
The card supports a myriad of configuration options for simple or complex setups.
Absolute minimum configuration
type: custom:advanced-camera-card
Minimal camera configuration
type: custom:advanced-camera-card
cameras:
- camera_entity: camera.office
Minimal folder configuration
type: custom:advanced-camera-card
folders:
- type: ha
Configuration blocks
Top-level configuration blocks
No top-level option is required. If cameras is omitted the card will still
render and can operate in image or folders views depending on configuration.
| Option | Description |
|---|---|
automations |
Take action when conditions are met. |
cameras |
Configures the cameras to be used in the card. Optional. If present, the first listed camera is the default. |
cameras_global |
Global defaults that apply to all cameras from the cameras section. |
card_id |
An optional ID to uniquely identify this card. For use when actions are being sent to card(s) via URL actions. Must exclusively consist of these characters: [a-zA-Z0-9_]. |
dimensions |
Configures the overall card dimensions. |
elements |
Add custom elements to the card. |
folders |
Configures folders to be used in the card. Optional. If present, the first listed folder is the default. |
image |
Configures the image view. |
live |
Configures the live view. |
media_gallery |
Configures the media gallery. |
media_viewer |
Configures the media viewer. |
menu |
Configures the card menu. |
overrides |
Override card configuration when conditions are met. |
performance |
Configures the card performance. |
profiles |
Apply pre-configured sets of defaults to ease card configuration. |
timeline |
Configures the timeline view. |
view |
Configures the default view and behavior of the card. |
Common configuration blocks
| Option | Description |
|---|---|
actions |
Configure actions. |
conditions |
Configure conditions. |