A continuación se muestra una respuesta XML de muestra para una solicitud exitosa típica.
<?xml version="1,00" encoding="UTF-8"?>
<live_stream_config version="1,10" xmlns="https://provisioning.streamtheworld.com/player/livestream-1,10">
<mountpoints>
<mountpoint tags="td-lowdelay">
<status>
<status-code>200</status-code>
<status-message>OK</status-message>
</status>
<transports>
<transport>http</transport>
<transport mountSuffix="_SC">shoutcast</transport>
<transport mountSuffix="HLS/playlist.m3u8">hls</transport>
<transport mountSuffix="/HLSTS/playlist.m3u8">hlsts</transport>
</transports>
<metadata>
<shoutcast-v1 enabled="true" mountSuffix="_SC"/>
<shoutcast-v2 enabled="true" mountSuffix="_SC"/>
<sse-sideband enabled="true" mountSuffix="_SBM"/>
</metadata>
<servers>
<server sid="1681">
<ip>1681.live.streamtheworld.com</ip>
<ports>
<port type="http">80</port>
<port type="http">3690</port>
<port type="http">443</port>
</ports>
</server>
<server sid="2310">
<ip>2310.live.streamtheworld.com</ip>
<ports>
<port type="http">80</port>
<port type="http">443</port>
</ports>
</server>
</servers>
<metrics>
<listener-tracking url="https://test-prod.webcastmetrics.com/lt" wcm-station-id="35892" />
<tag name="uuid"/>
</metrics>
<mount>WXYZFM</mount>
<format>FLV</format>
<audio>96000</audio>
<media-format container="flv" cuepoints="stwcue" trackScheme="audio">
<audio index="0" samplerate="44100" codec="heaacv2" bitrate="32000" channels="2" tags="low-bw"/>
</media-format>
<authentication>0</authentication>
<timeout>0</timeout>
<send-page-url>1</send-page-url>
<!-- Optional Section -->
<side-channels>
<station name="WXYZ_SIDECHAN1"/>
<station name="WXYZ_SIDECHAN2"/>
</side-channels>
</mountpoint>
<!-- Other mount points may be present if request was by station name -->
<mountpoint .../>
</mountpoints>
</live_stream_config>El esquema XML correspondiente está disponible en el siguiente URL:
https://playerservices.streamtheworld.com/schema/livestream-1.10.xsd
Comentarios adicionales para etiquetas importantes
Nombre | Valor |
|---|---|
<live_stream_config> | The version attribute represents the version of the configuration file format. Versions 1, 1,10, 1,20, 1,30, 1,40, 1,50, 1,60, 1,70, 1,80, 1,90, and 1,10 are currently supported. El valor de este atributo coincide con el número de versión que se pasó en la solicitud inicial. We highly recommended you use the most recent version (1,10). |
<status-code> | El estado del montaje, en la forma de un número entero de tres dígitos. Ver Códigos de estado de montaje para obtener más detalles. |
<status-message> | Una descripción textual del estado del montaje. Este mensaje siempre está en inglés, y puede usarse para que el usuario lo vea. Sin embargo, se recomienda que la aplicación del cliente implemente su propio diccionario de secuencias para mostrar mensajes más sencillos al usuario, según el código de estado. En ese caso, este mensaje puede usarse como alternativa si el cliente no sabe el código de estado. |
<transport> | Este elemento puede aparecer múltiples veces e indica qué transporte(s) es(son) compatible(s) para este montaje. The mountSuffix attribute indicates a suffix that needs to be appended to the mount name when requesting the stream. When the timeshift="true" property is added to a HLSRW transport, it means that the HLS URL available is capable of Timeshift Radio. |
<shoutcast-v1> | Specifies that Shoutcast v1 metadata is available for this mount (enabled="true"), and what suffix (via mountSuffix="<suffix>") to append to the stream URL when connecting. Note: for Shoutcast V1, the metadata is multiplexed into the stream, so the mount suffix is identical to the stream itself – there is no need to establish a second connection to obtain metadata. |
<shoutcast-v2> | Specifies whether Shoutcast v2 metadata is available for this mount (when enabled="true"), and what suffix (via mountSuffix="<suffix>") to append to the stream URL when connecting. Note: for Shoutcast V2, the metadata is multiplexed into the stream, so the mount suffix is identical to the stream itself – there is no need to establish a second connection to obtain metadata. |
<sse-sideband> | Specifies whether Sideband Metadata is available for this mount (when enabled="true"), and what suffix (via mountSuffix="<suffix>") used by players to build the mount’s metadata URL if using SBM. Ver Metadatos de banda lateral para obtener más detalles. |
<server> | Este elemento puede aparecer múltiples veces cuando el stream del montaje está alojado en múltiples servidores. The sid attribute indicates the ID of the server. |
<ip> | La dirección IP del servidor. |
<port> | Este elemento puede aparecer múltiples veces; indica el(los) puerto(s) en el que el servidor está escuchando. The type attribute indicates, for each port, what kind of connection the port supports:
|
<metrics> | The <metrics> tag is part of the provisioning information to inform the player about the URL needed to call the Triton Listener Tracking (LT) API. For more information about LT and the risks of duplicate measurement, please speak to your Triton Digital representative. |
<mount> | The name of the mount (same as the mount parameter in the request) |
<format> | El formato del stream. Los formatos y códecs actualmente permitidos son: FLV: Audio: MP3, AAC. Video: On2 VP6, H.264 MP3: MPEG Layer III Audio Deprecated – use the <media-format> element instead. |
<bitrate> | La tasa de bits del stream, en bits por segundo. Deprecated – use the <audio> element instead. |
<media-format> | Define el formato multimedia para este montaje. Estos atributos son definidos de la siguiente manera:
This element will contain a single <audio> element. |
<audio> | Define el formato de una pista de audio contenida en el stream. Estos atributos son definidos de la siguiente manera:
|
<authentication> | This feature is now deprecated, and the value is always set to 0. |
<timeout> | This feature is now deprecated, and the value is always set to 0. |
<send-page-url> | Booleano (0 o 1) que indica si el reproductor debe enviar la dirección de la página donde está integrado. When required, the URL of the page should be base64 encoded and sent as the value of the pageurl query parameter. |
<side-channels> | If the station/mount has side-channels, they will be listed here using nested <station name="..."/> elements. Separate calls to the Player Provisioning API are necessary to obtain information about the side-channel stations. |