# Admira API Content HTML5
**Admira API content HTML5** es el servicio disponible para poder comunicarse desde un contenido HTML al player de Admira via Javascript. A continuación se describen las funciones básicas de dicha API.
Para poder utilizar las funcionalidades de Admira API Content HTML5, es necesario disponer del [script](http://admira_api_content.js/), proporcionado por Admira.
Una vez añadido como adjunto y incluido en el HTML principal, se puede invocar de la siguiente manera:
```javascript
…
```
### Eventos
Aqui se explican los eventos básicos de API Content.
* **onReady**: se produce cuando el player ha conseguido precargar el contenido HTML con éxito, es decir, el HTML ha sido cargado dentro del iFrame. En este punto el iFrame sigue en *DISPLAY:NONE*
* **onStart**: se produce cuando el player pone en “PLAY” el contenido. Cualquier animación o reproducción de elementos debe iniciarse aquí. En este punto el iFrame sigue en *DISPLAY:INLINE*
#### Funcionalidades
API content también permite enviar mensajes a player HTML5 para indicarle diferentes acciones a realizar:
* **API\_DURATION**: Cambia la duración del contenido que se está reproduciendo
* **API\_FINISH**: Finaliza el contenido que se está reproduciendo
* **API\_CONDITION**: Escribe una condición para poder ser leída posteriormente por el player con las capacidades de Playlist condicional y Triggers de condiciones
* **API\_WRITE\_FILE**: Permite escribir datos de texto a un fichero en local
* **API\_READ\_FILE**: Permite leer un fichero de texto local
{% hint style="info" %}
**Nota**
Estas funcionalidades están en constante desarrollo y mejora. Para cualquier cuestión, no dudes en reportar a .
{% endhint %}
{% hint style="info" %}
**Nota**
Para versiones de app inferiores a z19.05.30, cuando se quiere obtener el id del player, es necesario poner la llamada dentro de onStrat. Para las versiones posteriores a z19.05.30, esta incluida, se puede poner dentro de onReady. A continuación se muestra un ejemplo de cómo habría que pedir el id del player en ambos casos.
{% endhint %}
**Versión de la aplicación anterior a z19.05.30**
```javascript
my_api.onReady = function(){
console.log("Ready !”);
};
my_api.onStart = function(){
console.log(“onStart”);
my_api.send("api_command",{command:my_api.API_PLAYER_INFO,params:{'callback':"onGetInfo"}});
};
```
**Versión de la aplicación igual o posterior a z19.05.30**
```javascript
my_api.onReady = function(){
console.log("Ready !”);
my_api.send("api_command",{
command:my_api.API_PLAYER_INFO,params:{
'callback':"onGetInfo"
}
});
};
my_api.onStart = function(){
console.log(“onStart”);
};
```
#### Ejemplos de funciones
```javascript
# API_DURATION:
api_obj.send("api_command",{
command:api_obj.API_DURATION,
params: {
duration:30
}
});
```
**→ Cambiará la duración, donde 30 es el número de segundos a partir del momento de la llamada a API.**
```javascript
# API_FINISH:
api_obj.send("api_command",{
command:api_obj.API_FINISH
});
```
**→ Finalizara el contenido de inmediato.**
```javascript
# API_CONDITION:
var condition_object = {
'id': ‘01’,
'filename': ‘internet_connected.xml’,
'value':1,
‘write’:true
};
api_obj.send("api_command",{
command:api_obj.API_CONDITION,
params:condition_object
});
```
**→ Escribirá el valor de la condicion para “Internet Connected”.**
```javascript
# API_WRITE_FILE:
var file_object = {
'path': ‘./log’,
'filename': ‘hello.txt’,
'text':’ Hello World !’
};
api_obj.send("api_command",{
command:api_obj.API_WRITE_FILE,
params:file_object
});
```
**→ Escribirá “Hello World!“ en ./content/hello.txt**
```javascript
# API_READ_FILE:
function onFileReadComplete(data){
console.log("HTML onFileReadComplete data : "+data);
}
var file_object = {
'path': ‘./log’,
'filename': ‘hello.txt’,
'callback': ‘onFileReadComplete’
};
api_obj.send("api_command",{
command:api_obj.API_READ_FILE,
params:file_object
});
```
→ Leerá ./content/hello.txt y enviara el resultado al callback : onFileReadComplete
```javascript
# API_PLAYER_INFO:
**Ejemplo completo obtener player_id y usarlo (versiones app inferiores a z19.05.30)
```
```javascript
# API_PLAYER_INFO:
**Ejemplo completo obtener player_id y usarlo (versiones app iguales o superiores a z19.05.30)
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.admira.com/contenidos/contenidos-html/admira-api-content-html5.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.