Livestream Redirect

Si vous utilisez principalement le streaming en direct HTTP (HLS) ou Shoutcast, la redirection de flux en direct est le moyen recommandé pour vous connecter aux flux de Triton Digital. Ce point de terminaison est 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.

URL de redirection du flux en direct

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>

Article	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. Les extensions de montage sont sensibles à la casse.	Voir 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, votre station est KSAD et vous utilisez un montage AAC, donc votre nom de montage est KSADAAC :

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

Extensions de montage

Les extensions de montage sont 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,

URL redirigée

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 l’URL 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 l’URL 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.