Respuesta de aprovisionamiento

Anterior Siguiente

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:

  • http: para transportes http y shoutcast

<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.
Tenga en cuenta que la etiqueta <uuid> también presente bajo la etiqueta <metrics>  se puede ignorar

<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:

  • container="flv": Formato de contenedor

  • cuepoints="stwcue|andoxml": Tipo/diccionario de los puntos de referencia contenidos en el stream

  • trackScheme="audio": Tipo de pistas contenidas en el stream. El esquema de pista de audio es el único actualmente definido, y especifica un stream que contiene una sola pista de audio. Consulte la etiqueta <audio> a continuación para obtener más detalles.

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:

  • index="<track-index>": Índice (número) de la pista. Normalmente 0, pero puede variar según el formato del contenedor (especificado por el elemento <media-format format="..."> )

  • codec="mp3|heaacv1|heaacv2|aaclc": Tipo de códec para esta pista

  • bitrate="<bps>": Tasa de bits para esta pista (en bits por segundo)

  • samplerate="<hz>": Frecuencia de muestreo para esta pista (en Hz, por ejemplo, 44100, 22050, etc.)

  • channels="1|2": Canales de audio (por ejemplo, mono/estéreo)

<authentication>

Esta característica ahora está en desuso y el valor siempre se establece en 0.
Valor antes de quedar en desuso: configurado en 0 si no se requiere ninguna autenticación del oyente, o 1 si el reproductor le solicita al oyente información de autenticación.

<timeout>

Esta característica ahora está en desuso y el valor siempre se establece en 0.
Valor antes de quedar en desuso: representa el tiempo máximo (en minutos) en que un usuario puede escuchar un stream antes de que se le pida seguir escuchando.

<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.