Base de connaissances

Vous pouvez enchaîner plusieurs vidéos de votre espace VOD (un répertoire entier automatiquement ou une sélection de vidéos) dans une liste de lecture (playlist) de votre choix afin de créer par exemple une fausse WebTV c'est-à-dire de proposer un flux qui sera vu de manière synchrone par tous les spectateurs, même si ce flux n'est pas émis en direct.

Actions à effectuer

Vous générez une playlist à partir de médias de votre espace VOD et la lecture se fait en faux direct, s'apparentant dès lors à notre produit de streaming vidéo (mais bien que le flux sera vu de manière synchrone par tous les spectateurs, ce flux n'est pas produit en direct).

Les vidéos sont classables selon plusieurs critères (Date, Nom, Durée, Hit, Random).

Vous pouvez créer une playlist dynamique: lorsque vous ferez des actions dans le reste de l'espace VOD, toutes les playlists concernées seront automatiquement mises à jour. Par exemple:

• à chaque upload de nouvelle vidéo (y compris via API SOAP)
• activation / désactivation vidéo
• suppression / restauration vidéo ou Dossier
• déplacement
• duplication
• découpage vidéo (2 cas)  / restauration

Les vidéos impactées seront repositionnées en fonction du critère de classement défini pour la playlist en question.

Vous pouvez également gérer une playlist manuellement. Pour ajouter une ou plusieurs vidéos via cette méthode, vous pouvez:

• glisser-déposer un média vers la liste
• double-cliquer sur une vidéo pour l'envoyer dans la liste
• glisser-déposer un répertoire pour ajouter toutes les vidéos du dossier (mais pas les dossiers enfants)
• utiliser le menu contextuel de la ligne survolée

Vous pourrez réordonner les vidéos avec les flèches "monter" et "descendre" ou via glisser-déposer (ordre manuel).

Avec cette méthode, en uploadant une nouvelle vidéo dans un dossier déjà ajouté dans sa totalité à une playlist, vous devrez quand même ajouter manuellement cette vidéo. Il est même possible alors d'inclure des fichiers en double.

Plusieurs modes d'affichage s'offrent à vous, et vous permet de choisir le moyen de retransmission le plus adéquat à votre projet. On distingue par exemple:

• la diffusion "Live" (simule un faux live, synchronisé en fonction de l'heure UTC, donc le positionnement dans la vidéo sera identique sur deux postes différents sur des fuseaux horaires différents)
• la diffusion "Normale" (les vidéos sont lues à la suite les unes des autres, la timeline indique la durée totale)
• la diffusion "Séquentielle" (les vidéos sont lues à la suite les unes des autres, la timeline indique la durée de la vidéo courante)

En savoir plus

L'intégration des playlists est possible selon les critères classiques habituels (choix du player, paramètres de base, etc.). Les playlists fonctionnent avec le player Flash mais aussi avec le fallback du player en HTML5.

Les playlists sont compatibles avec la gestion du basculement de qualité à la volée (sauf sur le faux live) mais la configuration de qualité par défaut dans la partie player fait toujours office de référence d'encodage.
   
L'exportation vers Facebook, Twitter et via un code HTML est possible (si la fonction est activée dans le player correspondant).

Ce guide explique comment déplacer un produit Infomaniak d'un compte client à un autre.

Générer le lien de transfert du produit à transférer

1. ouvrir cette page avec les identifiants du compte qui contient le(s) produit(s) à transmettre (si vous n'êtes pas dans le bon compte avec un utilisateur ayant les droits administratifs, cela ne fonctionnera pas)
   
2. cliquer sur le bouton Transférer des produits
3. cocher le ou les produits à déplacer
4. lire et accepter les conditions générales
5. cliquer sur le bouton Transférer
6. copier le lien de transfert ou l'envoyer à l'adresse e-mail de votre choix

Importer le produit dans le compte souhaité

Ouvrir le lien copié ou du mail avec les identifiants du compte client de destination

1. si nécessaire, choisir le compte de destination à l'aide du menu déroulant
2. lire et accepter les Conditions générales
3. cliquer sur le bouton Réceptionner les produit
   (si le bouton n'est pas cliquable, assurez-vous d'avoir sélectionné le compte de destination)

Lors de la lecture d'une vidéo intégrée sur une page, le message "Compte suspendu" s'affiche lorsque le produit VOD/AOD, auquel appartient la vidéo, a été bloqué. L'origine du blocage peut être multiple donc contactez au plus vite l'administrateur de l'espace VOD/AOD pour en savoir plus.

Afin de gérer les interactions entre votre espace VOD/AOD et votre CMS, nous avons développé une extension compatible WordPress, Joomla et Drupal. Elle permet:

• de récupérer et de gérer l'ensemble de vos vidéos
• la mise à jour automatique lors de l'ajout de nouvelles vidéos
• la récupération automatique des players existants
• d'importer des fichiers audio/vidéo directement depuis l'administration du CMS
• la gestion des playlists
• de rechercher des vidéos à soi lors de l'écriture d'un article ou d'une page

Installer l'extension VOD pour votre CMS

Module WordPress (cliquez ici pour télécharger)
Module Joomla (cliquez ici pour télécharger)
Module Drupal (cliquez ici pour télécharger)

Les informations au sujet de votre espace VOD et du module externe adapté à votre CMS se trouvent dans votre Manager.
Rendez-vous dans votre espace VOD sous Extensions CMS / API

Connecter l'extension avec votre espace VOD

Pour des raisons de sécurité, il est fortement déconseillé de communiquer à l'extension les identifiants VOD que vous utilisez déjà. Il est nettement plus prudent de créer un nouvel utilisateur dans votre interface d'administration VOD et de ne lui attribuer que les droits "Gestion API". Ce sont ces informations de connexion (adresse email + mot de passe de connexion à l'interface) que vous communiquerez au plugin, accompagné de l'identifiant unique à votre espace VOD.

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

Il est possible de créer des chapitres sur une vidéo qui a été uploadée dans l'espace VOD/AOD et de personnaliser l'affichage du menu (miniature, titre + descriptif, grande vignette...)

Création de chapitrage

1. ouvrir le Manager (manager.infomaniak.com)
2. aller dans VOD/AOD sous Médias
3. cliquer sur la vidéo en question -> onglet Chapitrage
4. sur la timeline (fig.1 pt.1) ou le player (fig.1 pt.2), déplacez la tête de lecture
5. une fois à la position de découpe souhaitée cliquez sur 'Nouveau chapitre'
6. vous pouvez également double cliquer sur la timeline du bas pour créer un chapitre

Un chapitre ne peut être positionné que sur une image clé (fig.1 pt.3)
Pour visualiser les images clés, cliquez sur le symbole (fig.1 pt.4) et zoomez si nécessaire
Naviguez d'une image clé à une autre (fig.1 pt.5 et pt.6) pour affiner la position
Entrez un titre, une description, définissez une vignette, etc.
Enregistrez le chapitre, il est ajouté automatiquement dans la liste des chapitres
Lorsque tous vos chapitres sont prêts cliquez sur Publier en ligne (également après chaque modification)

En images

Fig.1

Ajouter un chapitre sur une vidéo

En savoir plus

Le fichier vidéo doit être encodé en MP4 pour avoir accès à l'édition (création + modification) des chapitres. L'édition des chapitres ne sera pas possible sur une vidéo FLV mais cette dernière affichera quand même les chapitres dans le player vidéo si elle a également été encodée en MP4 parallèlement. Si la vidéo MP4 est supprimée, les chapitres resteront sur le FLV mais sans possibilité d'édition.

L'iPhone (et non l'iPad) gérant lui-même l'affichage des vidéos, le chapitrage n'est pour le moment pas visible sur un iPhone.

Il n'est pas possible d'utiliser cet outil dans le cas d'un média de type sonore uniquement.

Concernant l'API Soap lire https://statslive.infomaniak.com/vod/api/#exemple7

Notre interface d'administration reste une console pour les webmaster/responsable de produit et n'est pas conçu comme un CMS (gestion de contenu).

Pour qu'un utilisateur ne puisse qu'envoyer des vidéos et récupérer leur code d'intégration (sans avoir accès aux autres vidéos ou aux réglages de player par exemple), vous devez contourner les outils mis en place. Il y a pour cela deux possibilités:

1. upload via FTP: simple à mettre en place et automatisable mais passage obligatoire par un logiciel FTP
2. update via module Flash/formulaire HTML: demande à être implémenté via l'API sur une page de votre site mais peut se faire très simplement dans un CMS ou une admin préexistante

L'autre avantage de cette seconde méthode est qu'elle permet de définir un nom de fichier différent de celui envoyé par l'utilisateur.

Pour récupérer le code d'intégration, il y a là aussi plusieurs méthodes:

1. utiliser le code d'intégration par défaut (sous "Dossiers" -> "Intégration" -> "3. Code d'intégration", code qui sera donc toujours pareil et dans lequel il suffit d'insérer le nom de la vidéo) mais attention le nom de fichier peut légèrement varier par rapport à celui envoyé (nettoyages des accents, caractères spéciaux, ...)
2. utiliser le callback pour récupérer les informations sur la vidéo et donc le code d'intégration
3. utiliser l'API une fois l'encodage terminé pour récupérer le code d'intégration (getIFrameImplementation())

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:

1. Petite vignette: 200x120
2. Grande vignette: résolution output maximum demandé

La taille de ces thumbnails ne dépend donc pas de la source mais des formats d'export configurés. L'image de preload prend la taille du format le plus grand à encoder. Cela permet d'avoir une image de preload correspondant à la vidéo que vous intégrez (même résolution, format, ...).

Pour les autres résolutions, vous pouvez récupérer l'image maximum via Curl/wget et la redimensionner sur votre site.

Dans ce guide, vous découvrirez les différents moyens d'importer des médias sur un espace VOD/AOD d'Infomaniak.

Importation des médias

Dans votre espace VOD, sous Importer médias, vous pouvez importer des fichiers audio et vidéo...

1. depuis une URL externe
2. à l'aide d'une application Flash (1 Go max)
3. par FTP (4 Go max)
4. via une API

Formats supportés

• formats vidéos supportés: 3gp, asf, avi, f4v, flv, m2ts, m2v, m4v, mkv, mov, mp4, mpeg, mpg, rm, ts, webm, wmv
• formats audios supportés: aac, flac, m4a, mp2, mp3, ogg, tta, vob, wav, wma

Pour savoir pourquoi la vidéo fraichement uploadée est déformée et/ou n'est pas générée dans le format désiré, il convient d'analyser les fichiers qui doivent être uploadés, ainsi que de procéder à quelques tests.

Vous pourrez dans certains cas vous rendre compte qu'une vidéo qui est visuellement au format 16/9 (1024x576 par exemple) n'est en fait qu'une vidéo 4/3 (720x576). Cela vient du fait que le fichier a un rapport L/H en pixels de type anamorphique, chaque pixel n'est donc pas carré mais rectangulaire. Généralement, on peut se rendre compte de cela en ouvrant le fichier avec Quicktime puis avec VLC, car ces logiciels ne l'interprètent pas de la même façon.

Le problème est que lorsque la vidéo est convertie via l'outil de VOD, elle l'est en pixels carrés, au final avec une taille de ratio 4/3 réellement, même si l'encodage est paramétré en 16/9.

Définissez une règle d'encodage avec un format qui "force la résolution" (menu déroulant sous "format") ainsi que les dimensions 16/9 - 640x360.

Les conversions de base utilisent le mode Letterbox, ce qui fait que les vidéos que vous envoyez en 4/3 restent en 4/3 même si les dimensions demandées sont 16/9. Si vous ajustez ce paramètre en mode "Forcer la résolution" puis en spécifiant des dimensions en 16/9, vous obtiendrez au final un fichier aux dimensions voulues.