Skip to content

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.

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 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.