Base de connaissances

Ce guide explique comment modifier la vignette ou miniature représentant une vidéo sur un service VOD.

Modifier la miniature vidéo

Afin d'accéder à un média de l'espace VOD :

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur Médias dans le menu latéral gauche
6. cliquer sur Gestion des médias dans le menu latéral gauche
7. cliquer sur le média concerné dans le tableau qui s'affiche
8. cliquer sur le bouton Modifier
   

2 possibilités permettent de remplacer l'image par défaut de la vidéo:

1. sélectionner une image au sein de la vidéo elle-même (cliquer pour faire défiler la vidéo et appuyer sur un bouton pour extraire l'image vers la vignette de prévisualisation)
2. charger une image depuis votre disque dur (2 Mo max.)

Valider en cliquant sur le bouton bleu Enregistrer.

Ce guide explique comment diffuser en direct une liste de vidéos du service VOD grâce au produit Streaming vidéo.

A quoi ça sert ?

Cette fonctionnalité permet d’utiliser le service VOD pour créer une playlist de vidéos et d’utiliser ensuite le service Streaming vidéo pour la diffuser en vrai direct, p.ex dans le cadre d'une chaîne de clip musicaux, téléachat, documentaires, etc. Il est possible d’y glisser des publicités entre chaque vidéo, manuellement ou via l’utilisation de tag VAST. La playlist sera diffusée en boucle à l'infini jusqu’à ce que l’utilisateur la stoppe.

Quelques exemples d'utilisation

La diffusion d'une playlist peut servir comme solution de repli (fallback) dès qu'un live se coupe (volontairement ou involontairement) et dans ce cas prendre le relai à l'antenne. Dès que l’encodeur live repousse un flux, il reprend la main sur la playlist. Cela permet de diffuser un contenu alternatif s'il y a un problème sur le direct ou si l’utilisateur ne diffuse du vrai direct que le soir p.ex, il peut automatiser la diffusion de contenu issu de playlist le reste de la journée.

Il est également possible de programmer la diffusion d’une playlist depuis l’outil de planification du Streaming vidéo. Ainsi on peut choisir des plage de diffusion de playlist unique ou différentes à l’avance, ou de manière récurrente. L’encodeur diffusant en direct sera déconnecté automatiquement et ce pendant toute la durée de diffusion de la playlist ; une fois la plage horaire terminée, l’encodeur se reconnectera et son contenu sera diffusé. 

Prérequis

• posséder un service VOD (au minimum l'espace VOD gratuit avec le service Streaming vidéo)
• posséder un service Streaming vidéo dans la même organisation et géré par le même compte

Diffuser une playlist VOD en live streaming

Constituer la playlist à partir de quelques vidéos importées

Importer les vidéos sur l'espace VOD:

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur le bouton Sélectionner (dans la partie Importation rapide)

Une fois les vidéos importées:

1. cliquer sur Médias dans le menu latéral gauche
2. cliquer sur Playlists / WebTV dans le menu latéral gauche
3. cliquer sur le bouton pour ajouter une nouvelle playlist
4. nommer la playlist et déterminer si celle-ci doit être automatique (liée à un dossier) ou manuelle
5. choisir le dossier ou les vidéos précises à utiliser pour constituer la playlist
6. cliquer sur le bouton Créer un direct
   
7. choisir le flux du Streaming vidéo qui devra diffuser la playlist et régler vos préférences:
   

Ce guide explique comment intégrer dans le Player VOD/AOD qui sert à diffuser votre vidéo, un bouton en surimpression sur la vidéo sur lequel le spectateur pourra cliquer et ainsi partager facilement le lien de la vidéo (ou intégrer la vidéo elle-même) sur les réseaux sociaux comme Facebook ou X (anciennement Twitter).

 

Ajouter un lien de partage

Afin d'accéder à l'espace VOD :

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône ‍ en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur Players dans le menu latéral gauche
6. cliquer sur l'objet concerné dans le tableau qui s'affiche
7. cliquer sur l'onglet Options de partage
   

Activer l'un ou l'autre des partages avec les paramètres souhaités, pour voir sur le lecteur vidéo une icône de type flèche représentant la possibilité de partage pour l'utilisateur.

Facebook

Permet de spécifier une URL qui sera automatiquement complétée par 2 paramètres: "folder" et "file" permettant au propriétaire de la vidéo de savoir que le visiteur qui arrive sur son site vient de Facebook et qu'il a cliqué sur telle vidéo. S'il utilise l'API de la VOD, il pourra aisément faire la liaison et n'afficher que la vidéo voulue p.ex sur une page spécifique en fonction de chaque vidéo source.

X (ex-Twitter)

Permet de spécifier l'URL d'un site, qui sera automatiquement complétée par 2 paramètres afin d'identifier la vidéo après la redirection (folder=ID_FOLDER&file=ID_FILE)

Ce guide explique comment obtenir et configurer des notifications en cas d'incident ou de dépassement de consommation de VOD/AOD.

Avertissement par mail

Pour configurer les notifications:

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur Paramètres dans le menu latéral gauche
6. cliquer sur Notifications dans le menu latéral gauche
7. configurer les horaires de surveillance (jours de la semaine / heures)
8. ajouter les utilisateurs de l'Organisation devant être notifié par mail
9. enregistrer les modifications
   

Ce guide explique comment intégrer sur des pages Web des fichiers vidéo / audio importés sur un service VOD / AOD Infomaniak.

 

Préambule

• Ce code d'intégration VOD / AOD est unique et correspond aux paramètres que vous êtes en train de spécifier sur la page.
• Il vous permet d'intégrer une même vidéo avec des configurations d'affichage différentes selon vos besoins.
• Par la suite, vous pourrez modifier les paramètres de cette intégration en les ajustant depuis la page d'historique des intégrations sur le Manager Infomaniak.

 

Générer et copier le code d'intégration

Le code d'intégration qui permet d'insérer votre média à l'endroit désiré (blog, site Web, etc.) se trouve sur votre interface VOD:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur le média concerné dans le tableau qui s'affiche.
6. Cliquez sur le bouton bleu Partager.
7. Cliquez sur Créer une intégration.
8. Personnalisez l'intégration du média.
9. Cliquez sur le bouton pour Générer le code d'intégration.
10. Copiez le code pour l'intégrer à l'emplacement de votre choix:

 

Modifier une précédente intégration

Pour personnaliser à nouveau l'intégration déjà effectuée de votre média, et dans le but de conserver le code correspondant sans devoir l'insérer à nouveau:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur le média concerné dans le tableau qui s'affiche.
6. Cliquez sur le bouton bleu Partager.
7. Cliquez sur Modifier une intégration:
   
8. Cliquez sur le menu d'action ⋮ à droite de l'objet concerné dans le tableau qui s'affiche.
9. Cliquez sur l'élément désiré afin d'obtenir / modifier les codes d'intégration / partage:
   

 

Coller le code d'intégration

Sur la page Web de votre choix, collez le code à l'endroit désiré.

Pour SiteCreator p.ex, il faut générer un code d'intégration “Fixe” (et non “Réactif”):

Puis collez ce code sur Site Creator au sein d'un bloc “Code HTML personnalisé”.

Voici un exemple de copier-coller depuis la page d'intégration d'un média:

Ce guide explique comment protéger par clé unique des vidéos importées sur un service VOD Infomaniak.

Protéger une vidéo par clé unique

Vous avez la possibilité de protéger l'ensemble des médias d'un dossier avec la création d'un token. Ce dernier sera unique pour chacun de vos visiteurs et devra être passé en paramètre à votre media afin de limiter la consultation de ce dernier. Vous seul serez capable de générer la clé unique, nécessaire à chaque utilisateur pour voir les vidéos. Cette clé permet donc de n'autoriser que les personnes préalablement vérifiées par vos soins.

Cela permet de contrôler l'accès aux vidéos et de n'autoriser que certaines personnes, les autres étant refusées. Utile dans des cas tels que du pay-per-view ou des diffusions limitées. Cependant veuillez noter que c'est à vous de développer l'intégration à votre système existant.

Si le hash n'est pas valide, l'accès à la vidéo retournera une page d'erreur "403 forbidden".

Activer la restriction sur le dossier d'importation

Lorsque le mot de passe est défini une fois pour toute au niveau du dossier de destination, toutes les nouvelles importations de médias comporteront automatiquement ce mode à leur lecture. Pour configurer ce dossier:

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur Médias dans le menu latéral gauche
6. cliquer sur Gestion des médias dans le menu latéral gauche
7. cliquer sur l'icône afin de créer un Nouveau dossier
   
8. donner un nom au dossier
9. cliquer sur le bouton bleu pour Créer le dossier
10. cliquer sur Configuration
    
11. choisir les règles d'encodage pour les vidéos qui seront importées puis passer à l'étape suivante
12. configurer les options du dossier dans cette seconde étape puis passer à l'étape suivante
13. activer la restriction par clé unique
14. cliquer sur le bouton bleu une fois les différentes restrictions souhaitées configurées
    

1. Créer un token API VOD

Pour avoir accès à l'API VOD, vous devez en premier lieu vous authentifier grâce à un token application. Cette étape n'est à faire qu'une seule fois. Le token applicatif sera commun pour l'ensemble des dossiers que vous souhaiterez protéger. Pour créer ce token d'application, lire ce guide puis la documentation https://developer.infomaniak.com/getting-started#authentication.

2. Créer le token de playback

Cette étape sera à faire sur votre site internet/application et ce token devra être unique, donc généré pour chaque visiteur.

Il est donc important que la page qui aura pour rôle la génération de token ne possède pas de cache, afin de garantir l’unicité du token.

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

channel_id = 1227
share_id = correspond à l'identifiant de votre vidéo
Exemple: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

La liste des paramètres est disponible dans la documentation https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilisation du token unique sur un media

Le token récupéré au point 2 ci-dessus sera ainsi passé en paramètre au media, il sera unique donc différent pour chaque visiteur:

<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>

D'autres restrictions d'accès peuvent être activées: mot de passe + geoip.

Les requêtes SOAP mettent parfois très longtemps avant de recevoir une réponse. Le téléchargement est si possible fait immédiatement (il y a une queue et une limite par utilisateur) et le callback ne répond que lorsque le téléchargement se termine (il y a un timeout qui peut retourner une réponse avant). Mais le téléchargement de gros fichiers (plusieurs centaines de Mo voir Go) peut prendre quelques minutes suivant le serveur distant appelé. 

Il est possible suivant la configuration du client SOAP de ne pas attendre de réponse du serveur SOAP lors de l'appel aux fonctions. Cela permet de rendre l'appel non bloquant et donc de faire plus d'appels successifs assez rapidement sans attendre.

Ce guide concerne les jetons d'authentification ou tokens Infomaniak, qui servent à vérifier l'identité de l'application et à lui accorder des autorisations spécifiques pour interagir avec les fonctionnalités et les données de l'API Infomaniak de manière sécurisée.

 

Préambule

• Les jetons d'authentification ou tokens servent à vérifier l'identité de l'application et à lui accorder des autorisations spécifiques pour interagir avec les fonctionnalités et les données de l'API Infomaniak de manière sécurisée.
• Il n'y a pas de limite quant au nombre de token que vous pouvez créer.
• La durée dun token d'accès est "illimitée" par défaut mais il est possible de définir une durée personnalisée à sa création.
• Attention, si aucun appel n'est fait avec le token pendant une année, il est automatiquement désactivé ; il sera alors nécessaire d'en générer un nouveau.

 

Gérer les token API Infomaniak

Au moment de la création d'un token API, il vous sera possible de choisir l'application et le scope accessible par le token (afin de correspondre à votre besoin et projet actuel).

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez le bouton bleu Créer un token.
3. Choisissez dans le menu déroulant le produit adéquat selon votre besoin et projet actuel.
4. Choisissez une durée de validité.
5. Cliquez sur le bouton bleu Créer un token.
6. Entrez le mot de passe de connexion au Manager comme demandé.
7. Copiez le token en lieu sûr - il ne sera plus accessible après cela.

Exemple d'application: token pour l'API Newsletter

Ce guide explique comment déplacer un média qui a été téléversé sur un espace VOD/AOD vers un autre dossier. Le média est déplacé et conserve ses différents encodages. Il n'est pas réencodé et n'hérite donc pas des encodages du dossier de destination.

Gérer les médias VOD/AOD

Afin d'accéder aux médias :

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur Médias dans le menu latéral gauche
6. cliquer sur Gestion des médias dans le menu latéral gauche

Sélectionner un ou plusieurs médias puis choisir l'option souhaitée en bas de page:

Sinon ouvrir un média précis et cliquer sur le menu d'action ⋮ à droite:

Ce guide donne des indications afin d'afficher et interpréter correctement les statistiques VOD/AOD.

Accéder aux statistiques VOD/AOD

Pour consulter les statistiques de vos médias:

1. se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
2. cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
3. choisir VOD/AOD (univers Streaming)
4. cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
5. cliquer sur Statistiques dans le menu latéral gauche
   
6. cliquer sur les éléments souhaités dans le menu latéral secondaire pour obtenir une vue d'ensemble ou des statistiques précises sur les spectateurs, le temps de visionnage, la consommation, les médias, les zones géographiques, les technologies:
   

Définitions des libellés

• Médias vus: nombre de vues sur l'ensemble des médias
• Visiteurs uniques: nombre de visiteurs avec des IP distinctes

Exemple: si deux collaborateurs d'une même société regardent la même vidéo, cela comptabilisera 1 visiteur unique et 2 visites.

Pourquoi y a-t-il une différence significative entre le nombre de médias vus et le nombre de visiteurs uniques?

Les utilisateurs qui regardent un flux avec une connexion Internet instable (Wifi, 3G, etc.) peuvent engendrer un grand nombre de déconnexions et reconnexions. Dans un tel cas, chaque reconnexion est comptabilisée comme une nouvelle visite, ce qui explique la différence qu'il peut y avoir entre le nombre de médias vus et le nombre de visiteurs uniques.