Esta guía explica cómo proteger con contraseña los videos importados a un servicio VOD de Infomaniak.

Prólogo

• La reproducción de un video dentro de un Player configurado en el servicio VOD requerirá una contraseña sin la cual la visualización no será posible.
• No es posible especificar varias contraseñas diferentes para el mismo video.
• Otras restricciones de acceso pueden activarse y afectan el acceso al archivo: token | geoip

Proteger un video con contraseña

La protección con contraseña puede configurarse de diferentes maneras.

1. Contraseña a nivel de la carpeta de importación

Si la contraseña se establece una vez para siempre en la carpeta de destino, todas las nuevas importaciones de medios tendrán automáticamente esta contraseña al reproducirlas. Sin embargo, sigue siendo posible modificar la visibilidad de cada video individualmente (leer más abajo).

Para configurar esta carpeta:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el icono para crear una Nueva carpeta:
   
6. Asigne un nombre a la carpeta.
7. Haga clic en el botón azul para Crear la carpeta.
8. Haga clic en Configuración:
   
9. Seleccione las reglas de codificación para los videos que se importarán y luego pase al siguiente paso.
10. Configure las opciones de la carpeta en el paso 2 y luego pase al siguiente paso.
11. Establezca la contraseña que se deberá ingresar para ver un video protegido:
    
12. Haga clic en el botón azul una vez configuradas las diferentes restricciones deseadas.
13. Sube nuevos videos en esta carpeta para que estén protegidos por contraseña al ser vistos.

2. Contraseña definida manualmente en cada video

Para modificar la visibilidad de un video en un servicio VOD:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el video correspondiente:
   
6. Haga clic en Modificar en la sección Estado.
7. Haga clic en Contraseña para establecer una contraseña.
8. Haga clic en el botón azul para Cambiar el estado:
   
9. El video queda protegido con contraseña:
   

Esta guía trata sobre los tokens de autenticación o tokens de Infomaniak, que se utilizan para verificar la identidad de la aplicación y otorgarle permisos específicos para interactuar con las funcionalidades y los datos de la API de Infomaniak de manera segura.

Prólogo

• Los tokens de autenticación o tokens sirven para verificar la identidad de la aplicación y otorgarle permisos específicos para interactuar con las funcionalidades y los datos de la API Infomaniak de manera segura.
• No hay límite en cuanto al número de tokens que puede crear.
• La duración de un token de acceso es "ilimitada" por defecto, pero es posible definir una duración personalizada al crearlo.
• Atención, si no se realiza ninguna llamada con el token durante un año, se desactiva automáticamente; entonces será necesario generar uno nuevo.

Gestionar los tokens de la API de Infomaniak

En el momento de la creación de un token API, será posible elegir la aplicación y el alcance accesible por el token (para que coincida con su necesidad y proyecto actual).

Para ello:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic en el botón azul Crear un token.
3. Seleccione en el menú desplegable el producto adecuado según su necesidad y proyecto actual.
4. Seleccione una duración de validez.
5. Haga clic en el botón azul Crear un token.
6. Ingrese la contraseña de conexión al Manager como se solicita.
7. Copie el token en un lugar seguro - no será accesible después de esto.

Ejemplo de aplicación: token para la API Newsletter

Esta guía explica cómo agregar subtítulos a los medios de tu espacio VOD Infomaniak.

Prólogo

• Los subtítulos de tus videos no son destructivos para el video en sí; este no se altera, se trata únicamente de un archivo *.srt cargado por el Player.
• Puede gestionar el inicio automático de los subtítulos desde el Player mismo (pestaña #1).

Gestion de los subtítulos

Para acceder a la herramienta de creación de subtítulos para sus medios:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el medio para el cual se deben generar subtítulos.
6. Haga clic en Modificar.
7. Haga clic en la pestaña Subtítulos.
8. Haga clic en el botón Agregar un idioma para elegir una de las 3 métodos de generación de subtitulado:
   

A. Creación de subtítulos de forma manual

Con este modo de subtitulado, ingresa manualmente cada uno de los textos que deben aparecer en el timecode especificado:

B. Importación de un archivo de subtítulos

Puede importar un archivo de tipo SubRip (*.srt) o SubViewer (*.sbv y *.sub) para agregar subtítulos preparados de antemano en un archivo separado a su video:

El botón de alternancia (toggle switch) permite activar o desactivar la publicación de los subtítulos en el reproductor; esto permite, en particular, verificar que el contenido es correcto antes de la publicación y el compartir del video.

C. Generar subtítulos automáticamente

Puedes crear subtítulos directamente a partir del audio disponible en tu medio. Los textos se generan gracias a la inteligencia artificial (IA, o informáticamente o equivalente).

Para generar los subtítulos, haga clic en el botón Generar:

Traducir los subtítulos automáticamente

Cuando ya existe un subtitulado, puede añadir un idioma adicional en el mismo lugar, haciendo que el texto se traduzca automáticamente (especifique el idioma actual), lo que generará el subtitulado adecuado en el idioma deseado:

Subtitular automáticamente los nuevos videos

La carpeta Racine o las subcarpetas de tu espacio VOD pueden tener reglas que se ejecutan cada vez que se añade un nuevo medio en su interior. Una de estas reglas ordena generar automáticamente los subtítulos con el método C anterior. Para configurar esta regla:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en Configurar en la página de la carpeta Raíz o de la carpeta de su elección:
   
6. Haga clic en la pestaña Procesamiento de medios.
7. Verifique que los tratamientos no estén configurados para ser heredados de la carpeta Padre (o configure directamente la carpeta Padre) y guarde los cambios si es necesario (punto 10 a continuación).
8. Active la generación de textos.
9. Configure lo que debe generarse (subtítulos, título del video, resumen/descripción, así como las posibles traducciones según el idioma del visitante).
10. Guarde los cambios:
    

Esta guía explica cómo modificar la miniatura (miniatura, o thumbnail / póster) que representa un video en un servicio VOD.

Prólogo

• El uso de GIF animados no es posible.

Modificar la miniatura del video

Para acceder a un medio del espacio VOD:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el medio que desea reemplazar en la tabla que se muestra:
   
6. Haga clic en el botón Modificar:
   
    

Tienes dos opciones para reemplazar la imagen predeterminada del video en pausa:

1. Seleccione una imagen dentro del propio video (haga clic para desplazarse por el video y presione el botón para extraer la imagen que luego puede recortar/redimensionar):
   
2. Cargue una imagen desde su disco duro (10 Mo máx.) que luego puede recortar/redimensionar.

Confirme clicando en el botón azul Guardar:

Esta guía explica cómo transmitir en vivo una lista de videos del servicio VOD gracias al producto Streaming video.

Prólogo

• Esta funcionalidad permite utilizar el service VOD para crear una lista de reproducción de videos y luego utilizar el service Streaming vidéo para transmitirla en vivo, por ejemplo, en el contexto de un canal de clips musicales, televenta, documentales, etc.
• Es posible insertar anuncios entre cada video, manualmente o mediante el uso de etiquetas VAST.
• La lista de reproducción se transmitirá en bucle infinito hasta que el usuario la detenga.

Transmitir una lista de reproducción VOD en streaming en vivo

Requisitos previos

• Tener un servicio VOD (como mínimo el espacio VOD gratuito con el servicio Streaming vídeo).
• Tener un servicio Streaming vídeo en la misma Organización y gestionado por la misma cuenta.

Para crear la lista de reproducción, importe algunas videos:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en el botón Seleccionar (en la sección Importación rápida).

Una vez importados los videos:

1. Haga clic en Medios en el menú lateral izquierdo.
2. Haga clic en Listas de reproducción / WebTV en el menú lateral izquierdo.
3. Haga clic en el botón para añadir una nueva lista de reproducción.
4. Nombra la lista de reproducción y determina si debe ser automática (vinculada a una carpeta) o manual.
5. Seleccione la carpeta o los videos específicos para usar para crear la lista de reproducción.
6. Haga clic en el botón Crear una transmisión en directo:
   
7. Seleccione el flujo del servicio de Streaming vídeo que deberá transmitir la lista de reproducción y ajuste sus preferencias:
   

Algunos ejemplos de uso

La transmisión de una lista de reproducción puede servir como solución de respaldo (fallback) tan pronto como una transmisión en vivo se corte (voluntariamente o involuntariamente) y, en ese caso, tomar el relevo en antena. Tan pronto como el codificador en vivo emita un flujo, recuperará el control de la lista de reproducción. Esto permite transmitir contenido alternativo si hay un problema con la transmisión en vivo o si el usuario solo transmite en vivo por la noche, por ejemplo, puede automatizar la transmisión de contenido de la lista de reproducción el resto del día.

También es posible programar la difusión de una playlist desde la herramienta de planificación de Streaming vídeo. Así se pueden elegir franjas de emisión de playlist única o diferentes con antelación, o de manera recurrente. El codificador que emite en directo se desconectará automáticamente y durante toda la duración de la emisión de la playlist; una vez finalizado el horario, el codificador se reconectará y su contenido se emitirá.

Esta guía explica cómo integrar en el Player VOD/AOD que se utiliza para transmitir su video, un botón en superposición sobre el video en el que el espectador podrá hacer clic y así compartir fácilmente el enlace del video (o integrar el video mismo).

Prólogo

• Se prevé una compartición automática para Facebook, X (anteriormente Twitter), LinkedIn, WhatsApp, pero también es posible proporcionar un código HTML para la integración del Player en el lugar deseado por el visitante.
• Una compartición también puede iniciarse dentro de la biblioteca de medios misma.

Agregar un enlace de compartir en el Reproductor

Para acceder al espacio VOD:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Players en el menú lateral izquierdo.
4. Haga clic en el objeto correspondiente en la tabla que se muestra.
5. Haga clic en la pestaña Compartir.
6. Active una de las opciones de compartir con los parámetros deseados, para ver, en el Player, un icono que representa la posibilidad de compartir para el usuario:
   
   
    
7. No olvides guardar tus cambios si es necesario.

Esta guía explica cómo obtener y configurar notificaciones en caso de incidente o exceso de consumo de VOD/AOD.

Avis por correo electrónico

Para configurar las notificaciones:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Configuración en el menú lateral izquierdo.
4. Haga clic en Notificaciones en el menú lateral izquierdo.
5. Añada los usuarios de la Organización que deben ser notificados por correo electrónico.
6. Configure los horarios de vigilancia (días de la semana / horas).
7. Guarde los cambios:
   

Esta guía detalla ciertas operaciones realizadas en segundo plano por el servicio VOD / AOD Infomaniak.

Funcionamiento de las solicitudes SOAP y de los callbacks

En el servicio de VOD (vídeo bajo demanda) y AOD (audio bajo demanda), ciertas operaciones como la descarga de archivos se realizan a través de solicitudes SOAP, un protocolo que permite a dos sistemas comunicarse entre sí, a menudo utilizado para intercambiar datos entre servidores.

Cuando se solicita un archivo a través de SOAP, puede haber un retraso antes de que el servidor responda. Este retraso depende de varios factores, como el tamaño del archivo, la carga del servidor o la calidad de la conexión. La descarga comienza tan pronto como sea posible, pero hay que saber que hay una cola: si varios usuarios hacen solicitudes al mismo tiempo, cada una se procesa en orden, y cada usuario tiene un límite de descargas simultáneas.

Callback: una notificación al final de la descarga

Una retroalimentación es un sistema que permite notificar al cliente (por ejemplo, su aplicación) una vez que la descarga está terminada. En otras palabras, en lugar de esperar vigilando la descarga, el sistema le « llama » o le envía una respuesta cuando todo está listo. Esto es útil para evitar bloquear su aplicación mientras se descarga el archivo.

Sin embargo, también existe un tiempo máximo de espera, llamado tiempo de espera máximoSi este retraso se alcanza antes de que finalice la descarga, se envía una respuesta de todos modos. Esto no significa que la descarga haya fallado, sino que la respuesta se ha dado antes de que finalizara. En este caso, el procesamiento continúa en segundo plano.

Los archivos grandes tardan más tiempo

Cuando el archivo solicitado es voluminoso (por ejemplo, varios cientos de megabytes o incluso varios gigabytes), la descarga puede llevar varios minutos. Este tiempo depende mucho del servidor remoto: algunos son muy rápidos, otros menos. El sistema intenta gestionarlo lo mejor posible, pero hay que tener en cuenta que el tiempo de respuesta no siempre será inmediato.

Llamadas bloqueantes y no bloqueantes

Por defecto, algunos clientes SOAP esperan a que el servidor termine de responder antes de continuar. En este caso, se habla de una llamada bloqueante : su aplicación está bloqueada hasta que llegue la respuesta. Esto puede causar problemas si la respuesta tarda en llegar.

Afortunadamente, a menudo es posible configurar el cliente SOAP para que no bloquee. En ese caso, se habla de una llamada no bloqueanteEsto permite enviar varias solicitudes una tras otra sin tener que esperar la respuesta de cada llamada. Es más rápido y más eficiente, especialmente cuando trata varios archivos seguidos.

Esta guía explica cómo proteger con una clave única los videos importados en un servicio VOD Infomaniak.

Prólogo

• Atención, la protección por token solo es efectiva en el caso de una integración estándar por iframe y, por lo tanto, mediante el uso del Player Infomaniak.
• Otras restricciones de acceso pueden activarse: contraseña | geoip

Proteger un video con clave única

Tienes la posibilidad de proteger todos los medios de una carpeta creando un token. Este será único para cada uno de tus visitantes y deberá pasarse como parámetro a tu medio para limitar su consulta. Solo tú podrás generar la clave única, necesaria para que cada usuario vea los videos. Esta clave permite autorizar solo a las personas previamente verificadas por ti.

Esto permite controlar el acceso a los videos y autorizar solo a ciertas personas, rechazando a las demás; útil en casos como el pay-per-view o transmisiones limitadas. Sin embargo, tenga en cuenta que usted debe desarrollar la integración con su sistema existente.

Si el hash no es válido, el acceso al video devolverá una página de error "403 forbidden".

Activar la restricción en la carpeta de importación

Cuando la contraseña se define una vez para siempre al nivel de la carpeta de destino, todas las nuevas importaciones de medios incluirán automáticamente este modo en su lectura. Para configurar esta carpeta:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el icono para crear una Nueva carpeta:
   
6. Asigne un nombre a la carpeta.
7. Haga clic en el botón azul para Crear la carpeta.
8. Haga clic en Configuración:
   
9. Seleccione las reglas de codificación para los videos que se importarán y luego pase al siguiente paso.
10. Configure las opciones de la carpeta en este segundo paso y luego pase al siguiente paso.
11. Active la restricción por clave única.
12. Haga clic en el botón azul una vez configuradas las diferentes restricciones deseadas:
    

1. Crear un token API VOD

Para acceder a la API VOD, primero debe autenticarse utilizando un token de aplicación. Este paso solo se debe hacer una vez. El token de la aplicación será común para todos los carpetas que desee proteger. Para crear este token de aplicación, consulte esta otra guía y luego la documentación https://developer.infomaniak.com/getting-started#authentication.

2. Crear el token de reproducción

Este paso se debe realizar en su sitio web/aplicación y este token debe ser único, por lo tanto, generado para cada visitante.

Es por eso importante que la página que tenga el rol de generar el token no tenga caché, para garantizar la unicidad del token.

POST  https://api.vod2.infomaniak.com/api/pub/v1/channel/channel_id/share/share_id/token

channel_id = 1227
share_id = corresponde al identificador de tu video
Ejemplo: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

La lista de parámetros está disponible en la documentación https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Uso del token único en un medio

El token recuperado en el punto 2 anterior se pasará como parámetro al medio, será único y diferente para cada visitante:

<iframe frameborder="0" width="720" height="360"  src="https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html?token=st=1637143497~exp=1637143797~acl=/hls/1jhvl2uq4dnra/1jhvl2uq4dnmd/*~hmac=914aa838bdba141ec85db74266b54278572a1353a49e8851e4fd096dc6372127" allowfullscreen></iframe>

Esta guía explica cómo integrar en páginas web archivos de video/audio importados en un servicio VOD/AOD de Infomaniak.

Prólogo

• Este código de integración VOD / AOD es único y corresponde a los parámetros que está especificando en la página.
• Te permite integrar el mismo video con diferentes configuraciones de visualización según tus necesidades.
• Posteriormente, podrás modificar los parámetros de esta integración ajustándolos desde la página de historial de integraciones en el Manager Infomaniak.
• Puede compartir un medio de diferentes maneras.

Generar y copiar el código de integración

El código de integración se encuentra en tu interfaz VOD; aquí tienes un ejemplo con un Player por defecto:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el medio que le interesa en la tabla que se muestra.
6. Haga clic en el botón azul Integrar.
7. Haga clic en Crear una integración:
   
8. Personaliza la integración del medio (marca de tiempo, reproducción en bucle, inicio automático, …).
9. Haga clic en el botón para Generar el código de integración:
   
10. Copie el código para integrarlo en el lugar de tu elección:
    

El medio se insertará con el Reproductor por defecto, pero tiene la posibilidad de elegir entre sus Reproductores creados el que debe proponer durante la integración.

Modificar una integración anterior

Para personalizar nuevamente la integración ya realizada de su medio, y con el fin de conservar el código correspondiente sin tener que insertarlo nuevamente:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el medio correspondiente en la tabla que se muestra.
6. Haga clic en el botón azul Integrar.
7. Haga clic en Modificar una integración:
   
8. Haga clic en el menú de acción ⋮ a la derecha del objeto correspondiente en la tabla que se muestra.
9. Haga clic en el elemento deseado para obtener/modificar los códigos de integración:
   

Pegar el código de integración…

En la página web de su elección, pegue el código en el lugar deseado.

… en Site Creator Infomaniak

• Para Site Creator, hay que generar un código de integración “Fijo” (y no “Reactivo”):
  
• Pega luego este código en Site Creator dentro de un bloque “Código HTML personalizado”.

• Aquí tienes un ejemplo de copiar y pegar desde la página de integración de un medio: