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 reproducirse. 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 modificar la miniatura o thumbnail / póster que representa un vídeo en un Servicio VOD.

Preámbulo

• El uso de GIF animadas no es posible.

Editar miniatura de vídeo

Con el fin de acceder a un medio del espacio VOD:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en Medios de comunicación en el menú lateral izquierdo.
4. Haga clic en Gestión de los medios de comunicación en el menú lateral izquierdo.
5. Haga clic en el medio que desea reemplazar en la tabla que aparece:
   
6. Haga clic en el botón Editar:
   
    

2 posibilidades permiten reemplazar la imagen predeterminada del vídeo:

1. Seleccione una imagen dentro del vídeo en sí (haga clic para mover el vídeo y pulse el botón para extraer la imagen que puede rediseñar/retalar):
   
2. Carga una imagen desde tu disco duro (10 MB max.) que luego puede rediseñar/retamular.

Validar haciendo clic en el botón azul Guardar:

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

Preámbulo

• Esta función permite utilizar el Servicio VOD para crear un playlist de vídeos y luego utilizar el Servicio de Streaming de vídeo para transmitirla en verdadero directo, p.ex en el marco de una cadena de clips musicales, telecompra, documentales, etc.
• Es posible deslizar anuncios entre cada vídeo, manualmente o a través del uso de etiquetas VAST.
• La playlist se difundirá en bucle al infinito hasta que el usuario la estepa.

Difundir una lista de reproducción VOD en vivo streaming

Requisitos previos

• Poseer un servicio VOD (al menos el espacio VOD gratuito con el servicio Streaming de vídeo).
• Poseer un servicio de vídeo Streaming en la misma Organización y administrado por la misma cuenta.

Para crear la playlist, importe algunos videos:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente en el nombreasignado al producto afectado.
3. Haga clic en el botón Seleccionar (en la parteImportación rápida).

Una vez importados los vídeos:

1. Haga clic en Medios de comunicación en el menú lateral izquierdo.
2. Haga clic en Playlists / WebTV en el menú lateral izquierdo.
3. Haga clic en el botón para añadir un nuevo playlist.
4. Nombrar el playlist y determinar si debe ser Automática (relacionada con un expediente) o manual.
5. Elija la carpeta o los vídeos precisos que desee utilizar para crear la lista de reproducción.
6. Haga clic en el botón Crear un directo:
   
7. Elija el flujo del servicio de Streaming video que tendrá que difundir la lista y regular sus preferencias:
   

Algunos ejemplos de uso

La difusión de una playlist puede servir como Solución de repliegue (fallback) tan pronto como un en vivo se corta (voluntaria o involuntariamente) y en este caso tomar el relaido en la antena. Tan pronto como el codificador en vivo empuja un flujo, vuelve a tomar la mano en el playlist. Esto permite difundir un contenido alternativo si hay un problema en el directo o si el usuario sólo transmite el verdadero directo por la noche p.ex, puede automatizar la difusión de contenido procedente de playlist el resto del día.

También es posible programar la difusión de una lista de reproducción desde la herramienta de planificación del Streaming video. Así se pueden elegir rangos de difusión de playlist únicos o diferentes de antemano, o de manera recurrente. El codificador en vivo se desconectará automáticamente durante todo el tiempo de difusión de la lista; una vez que se haya completado el intervalo horario, el codificador volverá a conectarse y su contenido se difundirá.

Esta guía explica cómo integrar en el reproductor VOD/AOD un botón superpuesto en el vídeo, en el que el espectador puede hacer clic para compartir fácilmente el enlace del vídeo (o incrustar el propio vídeo) en redes sociales como Facebook o X (anteriormente Twitter).

Agregar un enlace para compartir

Para acceder al área VOD:

1. Inicie sesión en el Manager de Infomaniak (manager.infomaniak.com) desde un navegador web como Brave o Edge
2. Haga clic en el ícono en la parte superior derecha de la interfaz (o navegue a través del menú lateral izquierdo, por ejemplo)
3. Elija VOD/AOD (Universo de transmisión)
4. Haga clic en el nombre del objeto relevante en la tabla que se muestra
5. Haga clic en Players en el menú lateral izquierdo
6. Haga clic en el objeto relevante en la tabla que se muestra
7. Haga clic en la pestaña Opciones de compartir
   

Active una o ambas opciones de compartido con la configuración deseada para ver un ícono de compartir en el reproductor de vídeo para el usuario.

Facebook

Permite especificar una URL que será completada automáticamente por 2 parámetros: "carpeta" y "archivo", lo que permite al propietario del vídeo saber que el visitante que llega a su sitio viene de Facebook y ha hecho clic en tal vídeo. Si utiliza la API de VOD, podrá establecer fácilmente la conexión y mostrar solo el vídeo deseado, por ejemplo, en una página específica según cada fuente de vídeo.

Permite especificar la URL de un sitio, que será completada automáticamente por 2 parámetros para identificar el vídeo después de la redirección (carpeta=ID_CARPETA&archivo=ID_ARCHIVO)

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

Notificación por correo electrónico

Para configurar las notificaciones:

1. Inicie sesión en el Manager de Infomaniak (manager.infomaniak.com) desde un navegador web como Brave o Edge.
2. Haga clic en el icono ‍ en la esquina superior derecha de la interfaz (o navegue a través del menú lateral izquierdo, por ejemplo).
3. Seleccione VOD/AOD (universo de streaming).
4. Haga clic en el nombre del objeto relevante en la tabla que se muestra.
5. Haga clic en Configuración en el menú lateral izquierdo.
6. Haga clic en Notificaciones en el menú lateral izquierdo.
7. Configure el horario de supervisión (días de la semana / horas).
8. Agregue los usuarios de la organización que deben recibir notificaciones por correo electrónico.
9. Guarde los cambios
   

Las consultas SOAP a veces tardan mucho antes de recibir una respuesta. Si es posible, la carga se realiza inmediatamente (hay una cola y un límite por usuario) y la devolución de llamada responde cuando se finaliza la carga (hay una temporización que puede devolver una respuesta antes). Pero la carga de grandes archivos (varios centenares de MB incluso GB) puede tardar algunos minutos según el servidor remoto llamado. 

Es posible, según la configuración del cliente SOAP, no esperar respuesta del servidor SOAP tras la llamada de las funciones. Esto permite devolver la llamada no bloqueante y, por tanto, hacer más llamadas sucesivas rápidamente sin tener que esperar.

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 a 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 al directorio.
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 debe realizarse 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 debe realizarse en su sitio web/aplicación y este token debe ser único, por lo que debe generarse 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 vídeo / audio importados en un Servicio VOD / AOD Infomaniak.

Preámbulo

• Este código de integración VOD / AOD es único y corresponde a los parámetros que estás especificando en la página.
• Le permite integrar un mismo vídeo con diferentes configuraciones de visualización según sus necesidades.
• Posteriormente, podrás modificar los parámetros de esta integración ajustandolos desde la página histórica de las integraciones en el Manager Infomaniak.

Generar y copiar el código de integración

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

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en Medios de comunicación en el menú lateral izquierdo.
4. Haga clic en Gestión de los medios de comunicación en el menú lateral izquierdo.
5. Haga clic en el medio en cuestión en la tabla que aparece.
6. Haga clic en el botón azul Compartir.
7. Haga clic en Crear una integración.
8. Personaliza la integración del medio.
9. Haga clic en el botón para Generar el código de integración.
10. Copie el código para integrarlo en la ubicación de su elección:

El medio se insertará en este caso con el Player predeterminado, pero usted tiene la posibilidad de elegir entre tus Players creados el que se proponga en el momento de la integración.

Editar integración anterior

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

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en Medios de comunicación en el menú lateral izquierdo.
4. Haga clic en Gestión de los medios de comunicación en el menú lateral izquierdo.
5. Haga clic en el medio en cuestión en la tabla que aparece.
6. Haga clic en el botón azul Compartir.
7. Haga clic en Editar integración:
   
8. Haga clic en el menú de acción ⋮ a la derecha del objeto en cuestión en el cuadro que aparece.
9. Haga clic en el elemento deseado para obtener / modificar los códigos de integración / compartir:
   

Pegar el código de integración...

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

... en el sitio Creator Infomaniak

Para Sitio Creator, debe generarse un código de integración de la fix-fix (y no de la reacción de la reacción de la reacción):

A continuación, pega este código en el sitio de Creator dentro de un bloque de código de HTML personalizado.

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

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.

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 uno de los 3 métodos de generación de subtítulos:
   

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

Con este modo de subtitulado, ingresas 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

Puede crear subtítulos directamente a partir del audio disponible en su 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: