Files

T

Dermot Duffy cc376a8be1 feat: Rename the card to advanced-camera-card (#1873 )

Whilst the Frigate support in this card is the best among camera
engines, the name incorrectly suggests that Frigate is a requirement.
Instead, to broaden the appeal, change to more camera agnostic name.
This does not suggest any change in priority, role or support for
Frigate.

This change is likely to be bug prone, due to the size of the rename --
the code contains 1500+ references to "Frigate" most of which make sense
to rename, some which do not, all of which needed human assessment.

- Closes #1298


BREAKING CHANGE: References to `frigate-card` in all kinds of
configuration need to be updated to `advanced-camera-card`. An automated
config upgrade should take care of the majority of usecases (click `Edit
-> Upgrade -> Save`), though may not be perfect.

2025-02-06 19:32:32 -08:00

1.7 KiB

Raw Blame History

2-way Audio

This card supports 2-way audio (e.g. transmitting audio from a microphone to a suitably equipped camera). In general, due to the myriad of different cameras, security requirements and browser limitations getting 2-way to work may be challenging.

Requirements

Environmental requirements

Must have a camera that supports audio out (otherwise what's the point!)
Camera must be supported by go2rtc for 2-way audio (see supported cameras).
Must be accessing your Home Assistant instance over https. The browser will enforce this.

Card requirements

Only Frigate cameras are supported.
Only the go2rtc live provider is supported.
Only the webrtc mode supports 2-way audio:
Must have microphone menu button enabled:

Example configuration

type: custom:advanced-camera-card
cameras:
  - camera_entity: camera.office
    live_provider: go2rtc
    go2rtc:
      modes:
        - webrtc
menu:
  buttons:
    microphone:
      enabled: true

Usage

The camera will always load without the microphone connected, unless the always_connected microphone option is set to true.
To speak, hold-down the microphone menu button.
- On first press, this will reset the webrtc connection to include 2-way audio unless always_connected has been used.
- Thereafter hold the microphone button down to unmute/speak, let go to mute.
The video will automatically reset to remove the microphone after the number of seconds specified by disconnect_seconds configuration have elapsed since the last mute/unmute press.

1.7 KiB Raw Blame History