Speakers

Speakers let you play audio through devices connected to the Angelcam platform. Audio content is managed via audio messages — pre-recorded clips uploaded in Base64 encoding.

AngelBox as a speaker

If you connect your AngelBox through the My Angelcam UI, the speaker resource is created automatically.

To create it manually via the API, use the following fields when creating the speaker resource:

{
  "setup": "arrow",
  "protocol": "basic",
  "arrow_client": "<arrow_client_uuid>",
  "arrow_service_id": "<service_id>",
  "endpoint": "/api/v1/audio/play"
}

The arrow_client and arrow_service_id values are available from the Arrow clients endpoints.

Audio messages

Audio files are uploaded as Base64-encoded content. Supported formats:

Format	MIME type
AAC	audio/aac
MP3	audio/mpeg
WAV	audio/wav
OGG	audio/ogg
WebM audio	audio/webm

Keep audio files short — a few seconds is ideal. Large files increase upload time and may affect playback reliability.