Códigos de estado de montaje

Los códigos de estado de montaje se usan para informar al reproductor si el stream está disponible, y si no lo está, por qué no. Cada punto de montaje puede tener su propio código de estado y mensaje. En la API actual, un solo montaje puede devolverse, pero las versiones futuras admitirán múltiples consultas de montaje y los clientes deberán manejar el código de estado y el mensaje de manera apropiada. Además, cuando el código de estado es diferente a 2xx, el único campo que se garantiza que es válido es el nombre del montaje (por ejemplo, la etiqueta <mount> ).  Otros campos estarán presentes, pero sus valores podrían no ser válidos.

Desde la versión 1.1 de Player Provisioning API, el código HTTP devuelto es siempre 200. Esto permite que el reproductor reciba el archivo XML con el código de estado de montaje y obtenga más información sobre lo que salió mal. En el caso de un error del servidor o una solicitud mal formulada, etc., se aplican los códigos HTTP estándar.

Códigos de estado de montaje

Ejemplo de respuesta XML para un código de estado no 200:

<?xml version="1.0" encoding="UTF-8"?standalone="yes"?>
<live_stream_config version="1.9" xmlns="http://provisioning.streamtheworld.com/player/livestream-1.9">
<mountpoints>
  <mountpoint>
    <status>
      <status-code>453</status-code>
      <status-message>Forbidden (Content Access Denied)</status-message>
    </status>
 
    <mount>WXYZFM</mount> 
 
    <!-- Optional Section --> 
    <alternate-content> 
      <url>[URL to alternate content]</url> 
      <!-- OR --> 
      <mount>[Alternate Mount Name]</mount> 
    </alternate-content> 
  </mountpoint> 
</mountpoints> 
</live_stream_config>

Alternate Content

Cuando un stream tiene bloqueo geográfico (es decir, devuelve un código de estado 453), es posible que se ofrezca algún contenido alternativo al oyente que ha sido bloqueado. Como se muestra arriba, esto se enviará en la respuesta en un elemento <contenido alternativo> , que contiene uno de los elementos que se muestran en la tabla a continuación.

Elementos de contenido alternativo