Livestream Redirect

Si vous utilisez principalement HTTP Live Streaming (HLS) ou Shoutcast, le redirecteur de flux en direct est le moyen préconisé pour vous connecter aux flux Triton Digital. Ce point de terminaison sera toujours renvoyé sous la forme d'une redirection d'URL, vous n'avez donc pas besoin d'une connaissance approfondie du SDK Triton Digital pour le faire fonctionner.

Voici les éléments constitutifs d'une URL de redirection de flux en direct :

http://playerservices.streamtheworld.com/api/livestream-redirect/<mount-name>[.<mount-extension>|_SC][?<query-string>

Paramètres du redirecteur de flux

Paramètre	Description	Valeurs possibles	Obligatoire ?
mount-name	Le nom du montage.	N'importe quel nom de montage valide.	Oui
mount-extension	L'extension du nom de montage. Non requis, mais certains lecteurs le demandent. Notez que les extensions sont sensibles à la casse.	Référez-vous au tableau des extensions de montage ci-dessous.	Non
query-string	Si une chaîne de requête est présente dans la demande initiale du point d'entrée de l'URL du flux de chaînes, elle doit être répétée telle quelle sur l'URL de redirection.	N'importe quelle valeur.	Non

Par exemple, si votre station est KSAD utilisant un montage AAC (« KSADAAC ») :

http://playerservices.streamtheworld.com/api/livestream-redirect/KSADAAC.m3u8?lsid=hdsjdhsjhdskj&smbid=dhsjhdjs

Extensions de montage (sensibles à la casse)

Extension (dans l'URL de demande)	Redirection vers...	Transport requis
—	<mount-name>	HTTP
flv	<mount-name>	HTTP
mp3	<mount-name>.mp3	Shoutcast
aac	<mount-name>.aac	Shoutcast
_SC	<mount-name>_SC	Shoutcast
m3u8	<mount-name>/HLS/playlist.m3u8	HTTP Shoutcast HLS,

En cas de succès, le service de lecteur se redirigera vers une URL avec le modèle suivant :

http://<mg-host>:<mg-port>/<mount-name>[.<ext>|_SC][?<query-string>]

Codes d'état

Code	Message	Description
302	Found Response	La demande est réussie et la redirection est effectuée.
403	Forbidden	Le nom de montage demandé (dans le paramètre de montage ) n'est pas disponible pour l'adresse IP distante.
404	Not Found	Le montage n'a pas été retrouvé. Cela pourrait être dû à l'une des raisons suivantes : Le nom du mont n'a pas été trouvé dans la base de données. La construction de l'URL de redirection a donné lieu à une URL erronée. Il n'y a pas de MediaGateway associé au montage. Erreur lors du changement de direction. Problème de configuration du flux, comme le fait que le montage ne prend pas en charge l'extension fournie.

Code

Message

Description

302

Found Response

La demande est réussie et la redirection est effectuée.

403

Forbidden

Le nom de montage demandé (dans le paramètre de montage ) n'est pas disponible pour l'adresse IP distante.

404

Not Found

Le montage n'a pas été retrouvé. Cela pourrait être dû à l'une des raisons suivantes :

Le nom du mont n'a pas été trouvé dans la base de données.
La construction de l'URL de redirection a donné lieu à une URL erronée.
Il n'y a pas de MediaGateway associé au montage.
Erreur lors du changement de direction.
Problème de configuration du flux, comme le fait que le montage ne prend pas en charge l'extension fournie.