Base de connaissances
1 000 FAQ, 500 tutoriels et vidéos explicatives. Ici, il n'y a que des solutions !
Ce guide explique comment démarrer automatiquement la lecture d'une vidéo ou d'un flux audio lors du chargement d'une page Web.
Lecture automatique des médias
L'option autostart s'active depuis votre Manager (manager.infomaniak.com) dans le player (lecteur) qui diffuse vos médias.
Important : cette option est aujourd'hui limitée par certains navigateurs et appareils. Ces restrictions ont été mises en place par les éditeurs et les fabricants pour limiter les abus publicitaires. Certains permettent la lecture automatique mais désactivent le son par défaut; l'internaute doit alors cliquer sur une icône pour activer le son. D'autres bloquent tout simplement la lecture automatique des médias. Dans ce dernier cas de figure, l'internaute doit démarrer manuellement la lecture de vos médias.
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é.
Une playlist VOD peut être créée puis éditée manuellement (en allant chercher la vidéo qui doit compléter la liste) ou être dynamique si automatiquement constituée par un lot de vidéos se trouvant dans un dossier précis et alimenté au fur et à mesure. Dans les 2 cas, stopper puis relancer la diffusion en direct pour prendre en compte toute nouvelle vidéo ajoutée à la playlist - à noter que cela ne sera plus obligatoire lors d'une prochaine mise à jour de l'outil.
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:
- se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
- cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
- choisir VOD/AOD (univers Streaming)
- cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
- cliquer sur le bouton SĂ©lectionner (dans la partie Importation rapide)
Une fois les vidéos importées:
- cliquer sur Médias dans le menu latéral gauche
- cliquer sur Playlists / WebTV dans le menu latéral gauche
- cliquer sur le bouton pour ajouter une nouvelle playlist
- nommer la playlist et déterminer si celle-ci doit être automatique (liée à un dossier) ou manuelle
- choisir le dossier ou les vidéos précises à utiliser pour constituer la playlist
- cliquer sur le bouton Créer un direct
- choisir le flux du Streaming vidéo qui devra diffuser la playlist et régler vos préférences:
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 :
- se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
- cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
- choisir VOD/AOD (univers Streaming)
- cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
- cliquer sur Médias dans le menu latéral gauche
- cliquer sur Gestion des médias dans le menu latéral gauche
- cliquer sur le média concerné dans le tableau qui s'affiche
- cliquer sur le bouton Modifier
2 possibilités permettent de remplacer l'image par défaut de la vidéo:
- 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)
- charger une image depuis votre disque dur (2 Mo max.)
Valider en cliquant sur le bouton bleu Enregistrer.
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 :
- se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
- cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
- choisir VOD/AOD (univers Streaming)
- cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
- cliquer sur Players dans le menu latéral gauche
- cliquer sur l'objet concerné dans le tableau qui s'affiche
- 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)
Si vous ne désirez pas employer les encodages préconfigurés ou même un encodage personnalisé, vous avez la possibilité d'importer une vidéo sur votre espace VOD sans qu'elle ne soit compressée lors de l'envoi. Attention, cela ne fonctionne qu'avec des formats vidéo compatibles Flash (donc FLV et MP4).
Actions Ă effectuer
Connectez-vous Ă votre console d'administration
Rendez-vous sous VOD et ouvrez votre espace VOD
Rendez-vous sous Dossiers
Sélectionnez ou créez le dossier dans lequel les vidéos vont aller
Cliquez sur Utiliser une configuration conseillée
SĂ©lectionnez Importation sans traitement
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.
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:
- se connecter au Manager Infomaniak (manager.infomaniak.com) depuis un navigateur Web comme Brave ou Edge
- cliquer sur l'icône en haut à droite de l'interface (ou naviguer grâce au menu latéral gauche p.ex)
- choisir VOD/AOD (univers Streaming)
- cliquer sur le nom de l'objet concerné dans le tableau qui s'affiche
- cliquer sur Médias dans le menu latéral gauche
- cliquer sur Gestion des médias dans le menu latéral gauche
- cliquer sur l'icône afin de créer un Nouveau dossier
- donner un nom au dossier
- cliquer sur le bouton bleu pour Créer le dossier
- cliquer sur Configuration
- choisir les règles d'encodage pour les vidéos qui seront importées puis passer à l'étape suivante
- configurer les options du dossier dans cette seconde Ă©tape puis passer Ă l'Ă©tape suivante
- activer la restriction par clé unique
- 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
= 1227share_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.
Le trafic mensuel inclus est de 2 To, ce qui est considérable. Seul un petit nombre de sociétés spécialisées dans la diffusion de contenu audiovisuel dépasse actuellement cette limite.
Conservez chaque pixel de vos productions et encodez votre travail dans plusieurs qualités pour garantir la fluidité de la diffusion (4K, 2K, 1080p, 720p, 480p, etc.).
La VOD d'Infomaniak choisira automatiquement la qualité adaptée à l'appareil et la connexion de vos spectateurs.
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.
Un callback est un système permettant de définir des adresses de page Web qui seront automatiquement appelées lors d'évènements bien particuliers sur votre espace VOD/AOD. Cela permet de détecter la disponibilité de nouveaux médias ou leurs modifications et ainsi de mettre instantanément votre site à jour.
Lors de l'appel de ces pages, un certain nombre de paramètres leurs sont envoyés en POST. Il est donc possible de récupérer directement différentes informations sur cette nouvelle vidéo (identifiant, URL, poids, résolution...).
Vous pouvez configurer ces callback dans votre espace AOD/VOD sous Configuration puis sous l'onglet Callback.
Le callback est appelé dès la conversion de la vidéo, les appels sont fait immédiatement. Nul besoin d'attendre un cron chaque heure par exemple.