Skip to content

Multicast Audio#

Multicast audio support provides means to setup public announcements on D-Series Phones.

Packets sent to a multicast address will be transported to every device that is listening on this address.

Multicast addresses can be assigned to a range from 224.0.1.2 to 239.255.255.255 (rfc1112).

The D-Series supports two ways of listening to multicast audio, permanent and ad-hoc listeners.

Audio received via multicast audio will be mixed into any stream already playing.

Permanent listeners#

A permanent listener is stored in the settings and waits for audio packets to arrive on the specified address/port.

When audio data arrives, it will be played on the default audio path. Also a Notification is displayed, showing which configured stream is playing.

When the audio stops, the notifiction is removed and the audio stops playing.

Ad-hoc listeners#

An ad-hoc listener is setup via an http api.

https://<phone>/api/v1/exec/rtp_xml

will accept POST requests with the following content:

Start#

<?xml version="1.0" encoding="utf-8" ?>
<startMedia>
  <mediaStream>
    <address>239.255.255.230</address>
    <port>5555</port>
    <codec>PCMU</codec>
  </mediaStream>
</startMedia>

the request will send an unique id as a response.

<mediaStream id="c73dc99e-fdb1-4e8a-9bc7-c308427dc763"/>

Stop#

the above id can be used to stop the stream.

<?xml version="1.0" encoding="utf-8" ?>
<stopMedia>
  <mediaStream id="c73dc99e-fdb1-4e8a-9bc7-c308427dc763"/
</stopMedia>