Base de connaissances
1 000 FAQ, 500 tutoriels et vidéos explicatives. Ici, il n'y a que des solutions !
Ce guide explique comment protéger par mot de passe des vidéos importées sur un service VOD Infomaniak.
La lecture d'une vidéo au sein d'un lecteur configuré sur le service VOD demandera un mot de passe sans lequel le visionnage ne sera pas possible. Il n'est pas possible de spécifier plusieurs mots de passe différents pour la même vidéo.
Protéger une vidéo par mot de passe
La protection par mot de passe peut être configurée de différentes façons.
1. Mot de passe au niveau du dossier d'importation
Si 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 mot de passe à leur lecture. Il est malgré tout possible de modifier la visibilité de chaque vidéo individuellement (lire plus bas). 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 Ă l'Ă©tape 2 puis passer Ă l'Ă©tape suivante
- définir le mot de passe qui devra être entré pour voir une vidéo protégée
- cliquer sur le bouton bleu une fois les différentes restrictions souhaitées configurées
- téléverser des nouvelles vidéos dans ce dossier pour qu'elles soient protégées par mot de passe lors de leur lecture
2. Mot de passe défini manuellement sur chaque vidéo
Pour modifier la visibilité d'une vidéo sur un service 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 la vidéo concernée
- cliquer sur Modifier dans la partie Statut
- cliquer sur Mot de passe, définir un mot de passe
- cliquer sur le bouton bleu pour Modifier le statut
- la vidéo devient protégée par mot de passe:
D'autres restrictions d'accès peuvent être activées et concernent l'accès au fichier: token + geoip.
Vous avez la possibilité d'ajouter une image qui apparaitra sur votre vidéo. Vous pouvez le faire soit depuis les règles propres à un dossier d'importation, soit depuis la configuration d'un lecteur (player) vidéo.
Si vous passez par le player (lecteur vidéo en ligne), le logo apparaît en surimpression au dessus de la vidéo. Le logo n'est ajouté par le player qu'au moment de l'affichage. L'avantage de cette méthode est que le logo peut être modifié à volonté, et cela vous permet d'avoir plusieurs players qui pointent sur la même vidéo sans aucun problème. L'inconvénient est que si l'adresse réelle de la vidéo est récupérée par un visiteur alors la vidéo s'affichera sans le logo. C'est la méthode conseillée pour avoir quelque chose de facile à prendre en main et d’évolutif.
L'incrustation de logo présente dans la partie dossier est comme son nom l'indique, une réelle incrustation dans la vidéo. C'est quelque chose de beaucoup moins souple puisqu'une fois incrusté, on ne peux plus faire aucune modification. Autant dire qu'il ne faut pas regretter d'avoir incrusté un logo lorsque celui change quelques années plus tard.
Ces deux technologies sont différentes et ne travaillent pas au même moment donc si vous les activez simultanément vous aurez le logo du player au dessus du logo incrusté.
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:
Il n'est possible de générer automatiquement deux tailles différentes (738x388 et 131x70 par exemple) pour les vignettes des vidéos.
Par défaut sont générées 2 vignettes de tailles différentes pour chaque vidéo. Cependant leur taille n'est pas directement personnalisable. La première miniature a une taille fixe de 200x120 pixels et la seconde dépend de la résolution d'encodage souhaité. Donc pour résumer:
- Petite vignette: 200x120
- Grande vignette: résolution output maximum demandé
Pour les autres résolutions, vous pouvez récupérer l'image maximum via Curl/wget et la redimensionner sur votre site.
Il est possible d'intégrer dans le player qui sert à diffuser votre vidéo, un bouton en surimpression sur la vidéo (visible uniquement quand le curseur de l'utilisateur survole l'image) 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 Facebook et Twitter.
Actions Ă effectuer
- ouvrir le Manager (manager.infomaniak.com)
- aller VOD/AOD
- cliquer sur l'espace VOD concerné
- dans le menu latéral gauche cliquer sur Players
- sous le lecteur vidéo que vous utilisez puis sous Options générales
- activez l'un ou l'autre des partages.
Facebook
- Si vous activez l'option "Player intégré dans Facebook", le spectateur qui utilisera le bouton de partage situé sur votre vidéo fera s'afficher votre vidéo directement dans Facebook (fig.1) via une iframe sans redirection vers aucun site sauf en cas de clic sur le titre sous la vidéo: là , l'utilisateur est redirigé vers l'URL configurée sous "Lien de retour" (fig.2).
- Si vous n'activez pas l'option, l'utilisateur fera s'afficher sur sa page Facebook un bloc (fig.3) avec des informations (vignette, titre, descriptif) liées à la vidéo en question et modifiables dans votre admin Infomaniak. Ce bloc est cliquable et dirige sur l'URL que vous aurez indiquée sous "Lien de retour" (fig.2). Le visiteur qui clique est donc dirigé vers cette URL qui sera automatiquement complétée par 2 paramètres: "folder" et "file" (fig.4) 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 par exemple sur une page spécifique en fonction de chaque vidéo source!
"Nom du compte Twitter" permet de définir le nom d'utilisateur Twitter qui sera visible à la fin du message après le caractère @.
"Lien de retour 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) (fig.3).
"Comptes Twitter en relation" permet de proposer Ă la personne qui va tweeter de "suivre" d'autres comptes Twitter.
En images
fig.1
fig.2
fig.3
fig.4
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.
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.