Services reference

The integration registers two camera services. Both target an aidot camera entity. aidot.ptz requires the camera to be streaming - open the live view first. aidot.talk does not: it reuses the live session when one is open and otherwise opens its own temporary session and closes it afterwards.

aidot.talk - two-way audio

Play an audio clip through a camera's speaker (push-to-talk / announce).

Field	Required	Default	Description
media	yes	-	A media-source id or http(s) URL pointing to an audio file.
max_seconds	no	30	Maximum talk duration (1-300 s).

service: aidot.talk
target:
  entity_id: camera.front_door
data:
  media: "media-source://media_source/local/doorbell.mp3"
  max_seconds: 30

See Two-way audio for details and supported formats.

aidot.ptz - pan / tilt / zoom

Move a PTZ camera. The service accepts every direction; which ones the camera acts on depends on what it advertises - the reference model (A001064) advertises pan only, so left, right and stop are the ones that move it.

Field	Required	Default	Description
direction	yes	-	One of up, down, left, right, left_up, left_down, right_up, right_down, zoom_in, zoom_out, stop. Tilt and zoom only move a camera that advertises them.
speed	no	4	Movement speed, 1 (slow) - 8 (fast).

service: aidot.ptz
target:
  entity_id: camera.outdoor_ptz
data:
  direction: left
  speed: 4

Use direction: stop to halt continuous motion. See PTZ control for the button-entity alternative and a Picture Elements overlay.