INNDS Premium viene con un servidor web incorporado. El servidor proporciona información y control mediante un formato REST estándar. Para acceder a un reproductor utilizando la API HTTP haga lo siguiente: 

• Primero asegúrese de que el reproductor tiene habilitado el servidor web.
• Abra un navegador web e introduzca "http://[IP o nombre de host del reproductor]:8080". Debería aparecer una página web. Si obtiene un error 404, asegúrese de que el reproductor tiene una conexión de red.

En la API HTTP, las solicitudes que se envían al reproductor, ya sea mediante GET o algún otro método HTTP. Las solicitudes GET son generalmente información sobre el estado del reproductor, mientras que las POST o PUT le permiten controlar la reproducción. Cuando realice un comando POST o PUT, asegúrese de que el encabezado "Content-Type" esté configurado como "text/xml" ("Content-Type: text/xml")

Para los ejemplos dados a continuación, estamos utilizando curl

Especificación del comando

/api/

Carpeta raíz de la API. Aquí se obtiene una lista de las funciones de la API que están registradas.

• GET - Recuperar la lista de funciones de la API

/api/Replay/

Comunicación con INNDS Replay (Playback enginge). Varias instancias de Replay en el mismo reproductor pueden ser controladas por la API - por lo tanto, tenemos que indicar a qué instancia de Replay enviar. Esta página nos da una lista de las reproducciones en el reproductor y su ID de software. Utilice este ID para todas las solicitudes posteriores a Replay.

• GET - Recupera la lista de Replays y sus IDs de software.

/api/Replay/[ID]

Cuando nos referimos a "[ID]", es el ID de software que debe especificarse (véase más arriba cómo obtener el ID de software).

Un ejemplo es: {DC61460D-37BD-420F-B859-F21E25B2BC82}

Cuando se hace una petición HTTP, hay que sustituir el { y el } por %7B y %7D, respectivamente, lo que hace que sea: %7BDC61460D-37BD-420F-B859-F21E25B2BC82%7D

• GET - Información básica (ajustes, esquemas de visualización, etc.)

Formato de respuesta (GET)

<Replay>
    <Instance name="[ID]">
        <FriendlyName>[Replay-name]</FriendlyName>
        <DisplayScheme>[path-to-displayscheme]</DisplayScheme>
    </Instance>
</Replay>

/api/Replay/[ID]/Playback

• GET - Obtiene el estado de la reproducción (parada, reproducción, pausa, esquema de visualización, avance, retroceso)
• PUT - Envía un comando al motor de reproducción (reproducción, parada, pausa, avance, retroceso)

Formato de respuesta (PUT)

<Request>
    <Playback>
        <Command>[Play|Stop|Pause|Forward|Backward]</Command>
    </Playback>
</Request>

Ejemplo: Enviar el comando de pausa (usando curl)

curl -H "Content-Type:text/xml" -X PUT --data "<Request><Playback><Command>Pause</Command></Playback></Request>" \ http://localhost:8080/api/Replay/%7BDC61460D-37BD-420F-B859-F21E25B2BC82%7D/Playback/

/api/Replay/[ID]/Screenshot

• GET - Obtenga la captura de pantalla que se está reproduciendo.
  Los siguientes parámetros GET se pueden enviar junto con la solicitud de captura de pantalla:
  • width
    El ancho de la captura de pantalla, en píxeles. Cuando se establece esto, la altura se establecerá automáticamente para mantener la relación de aspecto.
  • height
    La altura de la captura de pantalla, en píxeles.

Ejemplo: Obtener una captura de pantalla en miniatura de 200 píxeles de ancho (usando curl)

curl -X GET http://localhost:8080/api/Replay/%7BDC61460D-37BD-420F-B859-F21E25B2BC82%7D/Screenshot?width=200

/api/Replay/[ID]/Log

• GET - Obtenga la información de registro más reciente.

/api/Replay/[ID]/OSD

• GET - Obtenga información sobre la visualización en pantalla.
• PUT - Establezca la configuración de la visualización en pantalla.

Formato de solicitud (PUT)

<Request>
    <OSD>
        <OSDLevel>1</OSDLevel>
        <OSDColor>255</OSDColor>
    </OSD>
</Request>

Ejemplo: Mostrar la página OSD con la información de reproducción (usando curl)

curl -H "Content-Type:text/xml" -X PUT --data "<Request><OSD><OSDLevel>2</OSDLevel></OSD></Request>" \ http://localhost:8080/api/Replay/%7BDC61460D-37BD-420F-B859-F21E25B2BC82%7D/OSD

/api/Replay/[ID]/Variables

• GET - Listado de variables actuales

/api/Replay/[ID]/Variables/[variable-name]

• PUT - Establece una variable con el nombre nombre-variable.
• DELETE - Elimina la variable nombre-variable.

Formato de solicitud (PUT)

<Request>
    <[variable-name] Persistent="true">
        "Value"  
    </[variable-name]> 
</Request>

Ejemplo: Gestión de variables (usando curl)

curl -H "Content-Type:text/xml" -X PUT --data "<Request><MyVar Persistent='false'>Value</MyVar></Request>" \ http://localhost:8080/api/Replay/%7BDC61460D-37BD-420F-B859-F21E25B2BC82%7D/Variables/MyVar

curl -X DELETE http://localhost:8080/api/Replay/%7BDC61460D-37BD-420F-B859-F21E25B2BC82%7D/Variables/MyVar

/api/Probe/

Comunicación con INNDS Probe. Esta página nos da una lista de las Sondas en el reproductor y su ID de software. Utilice este ID para todas las solicitudes posteriores a la Sonda.