StreamRoute

StreamRoute is a scalable and highly available system service for effectively connects user stream requests to Audiostreamer infrastructure running in QuantumCast. The service can be available with own custom domain and automatic https certifications.

Features:

  • Generate listener IDs if necessary, based on client fingerprinting

  • Responsible for aggregator detection

  • Skip request specific handling

  • Alias domain if required

  • Forwarding parameters to QuantumCast-Audiostreamer or other Streamers

  • Detour blacklist-IPs

  • No pre-roll spot at specific aggregator requests, e.g. wake up alarm

  • Generate PLS and M3U-Playlists on request over stream URL

  • Create individual landing pages with metadata for aggregators

  • Certification for listeners from own infrastructure

  • GDPR no tracking option

  • Special handling for special aggregators

All communications with QuantumCast user audio streams comprises of a set of parameters that can be passed in the stream request. These parameters will capture sufficient details about the available opportunity and help serve a targeted audio stream to the user.

Request listener audio streams

URL-Scheme

The URLs to request audio streams are systematized according to the following scheme: https://domain/programkey/format/aggregator/listenerid/?parameters

Parts of audio stream request

domain

StreamURL domain for this channel

Example

streams.audiobrand.com

programkey

Short identifier of this stream name

Type

string

Example

chill

format

Codec and bit rate combined

Type

string

Example

mp3-192

aggregator

Optional aggregator identifier that should be displayed in the analytics dashbord

Type

string

Example

mywebsite or tunein

listenerid

Optional unique ID to identify the listener

Type

string

Example

142e4f19b49da39529de786f81344b76

Hint

If you use a specific provider to generate the listener ID and use dependent functions, then please use the listener IDs container.

parameters

Optional URL parameters

Type

string

Example

tracking=true

Request audio streams via media file (m3u/pls/m3u8)

This is an extension of the standard URL-Scheme. To request media file playlists, add a file extension to the URL.

m3u
Example1

https://domain/programkey/format/play.m3u

Example2

https://domain/programkey/format/aggregator/play.m3u?parameters

Example3

https://domain/programkey/format/aggregator/listenerid/play.m3u?parameters

pls
Example1

https://domain/programkey/format/play.pls

Example2

https://domain/programkey/format/aggregator/play.pls?parameters

Example3

https://domain/programkey/format/aggregator/listenerid/play.pls?parameters

m3u8
Example1

https://domain/programkey/format/play.m3u8

Example2

https://domain/programkey/format/aggregator/play.m3u8?parameters

Example3

https://domain/programkey/format/aggregator/listenerid/play.m3u8?parameters

Parameters

tracking

This is a simple GDPR no tracking option. All parameters will be drop. Possible values are true and false. Default value assumed is false.

Options

true, false

Default

true

Example

tracking=false

Tip

Get started QuantumCast Developers: