A continuación se muestra una respuesta XML de muestra para una solicitud exitosa típica.
<?xml version="1.0" 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> | El atributo version representa la versión del formato del archivo de configuración. Actualmente se admiten las versiones 1, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 1.9 y 1.10. El valor de este atributo coincide con el número de versión que se pasó en la solicitud inicial. Le recomendamos encarecidamente que utilice la versión más reciente (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. El atributo mountSuffix indica un sufijo que debe agregarse al nombre del montaje al solicitar la transmisión. Cuando se agrega la propiedad timeshift="true" a un transporte HLSRW, significa que la URL HLS disponible es compatible con Timeshift Radio. |
<shoutcast-v1> | Especifica que los metadatos de Shoutcast v1 están disponibles para este montaje (enabled="true") y qué sufijo (mediante mountSuffix="<suffix>") anexar a la URL del stream al conectarse. Nota: para Shoutcast V1, los metadatos se multiplexan en el stream, por lo que el sufijo de montaje es idéntico al propio stream; no es necesario establecer una segunda conexión para obtener metadatos. |
<shoutcast-v2> | Especifica si los metadatos de Shoutcast v2 están disponibles para este montaje (cuando enabled="true") y qué sufijo (mediante mountSuffix="<sufijo>") anexar a la URL del stream al conectarse. Nota: para Shoutcast V2, los metadatos se multiplexan en el stream, por lo que el sufijo de montaje es idéntico al propio stream; no es necesario establecer una segunda conexión para obtener metadatos. |
<sse-sideband> | Especifica si los metadatos de banda lateral están disponibles para este montaje (cuando enabled="true") y qué sufijo (mediante mountSuffix="<suffix>") usan los reproductores para crear la URL de metadatos del montaje si se usa 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. El atributo sid indica el ID del servidor. |
<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. El atributo type indica, para cada puerto, qué tipo de conexión admite el puerto:
|
<metrics> | La etiqueta <metrics> forma parte de la información de aprovisionamiento para informar al reproductor sobre la URL necesaria para llamar a la API de seguimiento de oyentes (LT) de Triton. Para obtener más información sobre LT y los riesgos de duplicación de mediciones, hable con su representante de Triton Digital. |
<mount> | El nombre del montaje (igual que el parámetro mount de la solicitud) |
<format> | El formato del stream. Los formatos y códecs actualmente permitidos son: FLV: Audio: MP3, AAC. Vídeo: On2 VP6, H.264 MP3: Audio MPEG Layer III En desuso: use el elemento <media-format> en su lugar. |
<bitrate> | La tasa de bits del stream, en bits por segundo. En desuso: use el elemento <audio> en su lugar. |
<media-format> | Define el formato multimedia para este montaje. Estos atributos son definidos de la siguiente manera:
Este elemento contendrá un único elemento <audio> . |
<audio> | Define el formato de una pista de audio contenida en el stream. Estos atributos son definidos de la siguiente manera:
|
<authentication> | Esta característica ahora está en desuso y el valor siempre se establece en 0. |
<timeout> | Esta característica ahora está en desuso y el valor siempre se establece en 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. Cuando sea necesario, la URL de la página debe estar codificada en base64 y enviarse como el valor del parámetro de consulta pageurl . |
<side-channels> | Si la estación/montaje tiene canales laterales, aparecerán aquí usando elementos anidados <station name="..."/> . Se necesitan llamadas separadas a la API de aprovisionamiento de reproductor para obtener información sobre las estaciones de canal lateral. |