Base de connaissances

Ce guide concerne le multi-bitrate ou transcodage qui permet de diffuser un flux de Streaming vidéo dans la meilleure qualité possible en fonction de la connexion Internet de vos spectateurs.

Préambule

• Sans la fonctionnalité de multi-bitrate ou transcodage, votre flux est uniquement diffusé dans une seule qualité et les spectateurs qui ne disposent pas d'une bonne connexion à Internet risquent de ne pas pouvoir lire votre flux.

Transcodage local vs Transcodage cloud

Il existe deux manières de proposer cette fonctionnalité à vos internautes : le transcodage local ou dans le cloud.
 

Avantages et inconvénients

Laisser Infomaniak gérer le transcodage

La totalité du processus est automatique : Infomaniak configure et transcode les différentes qualités nécessaires et vos spectateurs ont la garantie de pouvoir suivre vos diffusions dans les meilleures conditions possibles, quelle que soit la vitesse de leur connexion à Internet.

• Un seul flux de qualité maximum sera envoyé de votre côté.
• Un encodeur logiciel est suffisant, même s'il est recommandé de disposer d'un encodeur matériel pour plus de fiabilité et de performance.

Gérer le transcodage manuellement en local

L'ensemble du processus est manuel : vous devez configurer les qualités et leur nombre ainsi que posséder la configuration réseau et matérielle requise pour assurer le transcodage et l'envoi des données

• Un encodeur est requis pour le transcodage (Infomaniak en vend si nécessaire).
• L'encodeur (ou le serveur dédié à cette tâche) doit être suffisamment puissant pour transcoder simultanément votre flux dans différentes qualités. Dans le cas inverse, le flux sera coupé et instable pour vos spectateurs.
• Une bonne connexion à Internet est requise pour envoyer simultanément le flux dans différentes qualités.

Ce guide explique comment diffuser une réunion en ligne kMeet dans un flux séparé accessible par une URL unique grâce au Streaming Vidéo Infomaniak.

Préambule

• Diffuser une réunion type conférence dans un flux de Streaming Vidéo plutôt qu'au sein de l'application kMeet présente plusieurs avantages:
  • Diffusion publique à grande échelle sans avoir à restreindre l'accès à une audience limitée aux personnes invitées.
  • Attirer un public plus large, comme les conférences, webinaires ou évènements en direct où des centaines ou milliers de spectateurs peuvent suivre l'événement sans rejoindre un appel privé.
  • Permet de toucher un nombre illimité de spectateurs.
  • Nul besoin de gestion d'accès pour chaque participant, le flux est simplement consultable via un lien.
  • Un simple navigateur Web suffit pour accéder au flux de streaming.
  • Accès passif: les spectateurs ne sont pas forcés de participer activement ou d'interagir ; ils peuvent simplement regarder l'événement sans s'enregistrer ou se connecter, ce qui convient mieux aux grands événements.
  • Pas d'interruptions vocales ou de perturbations liées à la gestion des micros ; cela permet de garder un flux plus fluide et centré sur l'intervenant.
  • Résolution de diffusion plus élevée quand kMeet peut être limité par des contraintes de bande passante et une qualité vidéo moindre pour éviter la surcharge réseau.

Créer le lien de partage en Streaming Vidéo

Prérequis

• La diffusion d'un flux vidéo kMeet au sein d'un flux de Streaming vidéo est possible avec l'offre kSuite Pro ou Entreprise uniquement.
• Il faut être modérateur du kMeet pour pouvoir créer un lien de diffusion live mais il n'est pas nécessaire de posséder une offre de Streaming Vidéo Infomaniak.

Ensuite:

1. Démarrez kMeet via kmeet.infomaniak.com ou depuis l'une des applications pour ordinateur ou appareils mobiles.
2. Une fois dans la réunion, cliquez sur le menu d'action ○○○ dans la barre d'outils kMeet.
3. Choisissez de Démarrer la diffusion en direct:
   
4. Cliquez sur le bouton pour Démarrer:
   
5. Patientez le temps de la création du flux de Streaming Vidéo:
   
6. Au même endroit, une fois le lien du stream affiché, cliquez sur l'icône à droite pour copier l'URL correspondant au flux en direct ; collez l'URL dans un message à l'attention des participants ou de toute personne devant assister à la diffusion en direct.
7. Un symbole affiché sur kMeet ainsi qu'un signal sonore affiche le début de la diffusion via Streaming Vidéo:
   

Le flux est diffusé en continu pendant maximum 24 heures, et ne sera plus accessible dès que la réunion kMeet est stoppée.

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 donne des indications pour sécuriser un Streaming vidéo avec une clé unique (hash).

Cette méthode offre le meilleur niveau de protection et permet p.ex de restreindre vos diffusions à un espace membre nécessitant une authentification. La manière de générer ce code étant propre à chaque site, il sera nécessaire d'implémenter les fonctions PHP requises et d'adapter le code d'intégration de votre lecteur en conséquence.

Restriction par clé unique (hash)

Pour cela:

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 Paramètres dans le menu latéral gauche:
   
4. Cliquez sur Restrictions dans le menu latéral gauche.
5. Cliquez sur l'onglet Restriction par hash unique:
   

Fonctionnement des restrictions

Cette méthode nécessite de récupérer des informations liées à la configuration de votre flux et à l'internaute qui se connecte.

Il est dans un premier temps nécessaire de définir un mot de passe (une clé) au niveau du Manager Infomaniak. Dès l'ajout de cette clé, les spectateurs connectés et ceux qui tentent de visionner votre flux seront instantanément bloqués.

Voici le principe à suivre pour autoriser l'accès à votre flux :

• Conception d'un système d'authentification par vos soins (p.ex un espace membre).
• Prendre le mot de passe configuré ci-dessus sur le Manager.
• Récupérer l'IP des internautes via $_SERVER["REMOTE_ADDR"] p.ex.
• Prendre l'identifiant du flux à cibler.
• Récupérer la date ainsi que l'heure courante (sans les minutes et les secondes).

Ces éléments seront ensuite hashés par le code fourni dans le Manager afin de générer un token unique et propre à chaque utilisateur qui sera transmis au flux au moment de son chargement. La plateforme de streaming vérifiera ensuite la validité du hash afin d'autoriser ou de rejeter la connexion.

Remarques importantes

• Afin de garantir la sécurité de l'accès au flux, la validité de chaque token est limitée dans le temps.
• Il est important de désactiver le cache sur les pages qui permettent d'accéder au flux ; en effet, si la génération du token est mis en cache, d'autres utilisateurs tenteront de s'authentifier avec le hash de quelqu'un d'autre, ce qui provoquera leur rejet même s'ils ont l'autorisation de consommer le flux.

Ce guide explique comment faire un live en 360° avec le service de streaming vidéo d'Infomaniak.

Prérequis

• Posséder une caméra 360 compatible avec l'un des formats suivants :
  • équirectangulaire 360 monoscopique (2D)
  • équirectangulaire 360 stéréoscopique (3D) side by side (séparation gauche/droite)
  • équirectangulaire 360 stéréoscopique (3D) top/bottom (séparation haut/bas)
• Votre encodeur ou votre caméra doit également pouvoir envoyer un flux via une connexion RTMP (en savoir plus).
• Prenez enfin note qu'un flux vidéo à 360° requiert une source avec un bitrate élevé et un contrôle de débit réglé en mode CBR ; le bitrate dépendra du type de contenu et de la consommation de données qui sera également plus grande qu'avec un flux standard.
   

Créer un player 360°

La diffusion d'un live 360° requiert un player 360°. Cette option est gratuite et s'active rapidement :

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 Intégration puis sur Players dans le menu latéral gauche pour créer ou éditer un player existant.
4. Cochez la case Player 360 et configurez la projection (format du 360):
   
5. Cliquez sur le bouton Enregistrer.
6. Tout le contenu diffusé par ce player (qu'il soit au format 360 ou non) sera désormais interprété comme du 360°.

Ce guide explique comment enregistrer ou archiver l'intégralité de vos diffusions Streaming vidéo, ce qui peut être utile pour créer des replays TV ou revisionner les vidéos enregistrées par des caméras de surveillance p.ex.

Activer ou désactiver l'enregistrement automatique des directs

Pour activer cette option :

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. Activez l'enregistrement des directs par le bouton à bascule (toggle switch) depuis le tableau de bord du flux:
   

Une fois cette fonctionnalité activée, le flux sera automatiquement et perpétuellement enregistré à partir du moment qu'il est envoyé vers (ou tiré par) la plateforme d'Infomaniak.

Restez vigilant par rapport à votre espace FTP qui pourrait rapidement être saturé. En cas de besoin, vous avez également la possibilité de planifier manuellement des enregistrements depuis l'outil de planification.

Fonctionnement des enregistrement automatiques

Une fois cette option activée, un fichier mp4 sera automatiquement généré après chaque diffusion, lequel sera transféré vers l'espace FTP ou VOD configuré par vos soins.

Précisions importantes :

• Une diffusion est définie comme le moment entre la connexion et la déconnexion jusqu'à l'encodeur vidéo.
• Qualité des enregistrements : dans le cas d'un flux multi-bitrate, la qualité source maximum sera conservée.
• Limitation de la taille des fichiers : en cas de diffusion en continu, vous avez la possibilité de définir la durée maximum de chaque fichier mp4 ; cette option vous permet d'éviter de générer des fichiers trop lourds et de garantir l'enregistrement de vos archives vers l'espace FTP ou VOD de votre choix (et une fois la durée atteinte, l'enregistrement est automatiquement stoppé puis envoyé par FTP et un nouvel enregistrement est lancé).

Personnalisation des noms des enregistrements

Afin de vous permettre de facilement identifier et classer vos archives, le nom des enregistrements est personnalisable de manière dynamique à l'aide de paramètres spécifiés entre des accolades.

Exemple :

template_{stream_id}_{date|format:YYYY-MM-dd_hh:mm:ss}_{fragment_id|from:1|prefix:fragment_(|suffix:)}.{extension}

• stream_id // représente l'identifiant du flux sous forme d'une chaîne de caractères.
• date | format: ISO 8601 // date du jour de l'enregistrement.
• time | format: ISO 8601 // heure de l'enregistrement.
• datetime | format: ISO 8601 // date et heure de l'enregistrement.
• fragment_id | from: number | prefix: string | suffix: string // numéro du fragment dans le cas où un enregistrement est découpé avec possibilité de le préfixer et/ou de le suffixer. Chaque fragment sera incrémenté, "from" permettant d'indiquer quel sera le premier fragment de référence.
• extension // extension final du fichier.

Ces paramètres et leurs options sont optionnels et leur ordre est totalement libre. Ils peuvent être utilisés autant de fois que souhaité. Si vous fournissez la même option plusieurs fois, seule la dernière sera prise en compte. Toute option non reconnue sera simplement ignorée.

Exemple 1

Situation : vous avez deux programmations quotidiennes, la première démarre à 10h00 et la seconde à 20h05. En configurant le nommage des fichiers de cette façon template_{date|format:hh:mm:ss} vous obtiendrez les noms de fichier suivants :

Pour la journée du 5 décembre 2019 :

• Le premier enregistrement à 10h00 s'appellera: template-10:00:00.mp4
• Le second enregistrement à 20h05 s'appellera: template-20:05:00.mp4

Pour la journée du 6 décembre 2019 :

• Le premier enregistrement à 10h00 s'appellera: template-10:00:00.mp4
  L'enregistrement de la veille du même nom sera écrasé et remplacé par celui-ci.
• Le second enregistrement à 20h05 s'appellera: template-20:05:00.mp4
  L'enregistrement de la veille du même nom sera écrasé et remplacé par celui-ci.
• etc.

Cette logique peut d'avérer particulièrement utile pour avoir un système d'enregistrement en boucle, par exemple pour une vidéo surveillance. L'utilisateur ira récupérer la vidéo uniquement en cas de besoin et cela évite d'archiver un nombre de vidéos potentiellement infini au risque de saturer l'espace FTP.

Exemple 2

Situation : vous avez cette fois un enregistrement perpétuel, 24h/7, avec une limitation de la durée des fichiers fixée à 360 minutes. En configurant le nommage des fichiers de cette façon template_{date|format:YYYY-MM-dd}_{fragment_id|from:1|prefix:fragment_(|suffix:)}.{extension} vous obtiendrez les noms de fichier suivants :

• Le premier fichier de la journée à 0h00 s'appellera: template_2019-02-05.mp4
• Le second fichier de la journée à 6h00 s'appellera: template_2019-02-05_fragment(1).mp4
• Le troisième fichier de la journée à 12h00 s'appellera: template_2019-02-05_fragment(2).mp4
• Le quatrième fichier de la journée à 18h00 s'appellera: template_2019-02-05_fragment(3).mp4

En configurant le nommage des fichiers de cette façon template_{date|format:YYYY-MM-dd}_{fragment_id|from:0|prefix:fragment_(|suffix:)}.{extension} vous obtiendrez les noms suivants :

• Le premier fichier de la journée à 0h00 s'appellera: template_2019-02-05_fragment(0).mp4
• Le second fichier de la journée à 6h00 s'appellera: template_2019-02-05_fragment(1).mp4
• Le troisième fichier de la journée à 12h00 s'appellera: template_2019-02-05_fragment(2).mp4
• Le quatrième fichier de la journée à 18h00 s'appellera: template_2019-02-05_fragment(3).mp4

Si vous voulez éviter de retrouver le flux de votre TV ou de vos vidéos sur d'autres sites qui ne vous appartiennent pas, vous pouvez restreindre la diffusion à votre propre site uniquement et interdire toute intégration ailleurs.

Restriction par domaine

Pour cela:

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 Streaming vidéo (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 Restrictions dans le menu latéral gauche
7. dans l'onglet Restriction par domaine
   
8. ajouter la restriction par domaine, avec votre propre site Web ainsi que les sites autorisés à charger le flux

Ce guide explique comment personnaliser un player avec l'image de votre choix si vous avez ajouté des restrictions à votre flux ou dans les cas suivants :

• Interruption planifiée de la diffusion (possibilité d'afficher un compte à rebours avant la reprise de la diffusion)
• Restrictions géographiques
• Autres restrictions (blocage via IP, domaine(s), token, etc.)

Personnaliser les vignettes d'un player

1. ouvrir le Manager (manager.infomaniak.com)
2. aller dans Streaming vidéo
3. cliquer sur le flux concerné
4. cliquer sur Intégration puis sur Players depuis le menu à gauche
5. cliquer sur le player à personnaliser
6. aller dans l'onglet Vignettes
7. personnaliser les vignettes souhaitées

Ce guide explique comment gérer les éventuels dépassements de consommation des flux de Streaming vidéo Infomaniak.

Agir avant dépassement

En cas de dépassement de forfait, une facture de dépassement sera générée pouvant engendrer un coût supplémentaire plus ou moins conséquent. Il est donc important de choisir la bonne option qui devra être appliquée en cas de surconsommation.

Afin d'accéder au service de Streaming vidéo :

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 Streaming vidéo (univers Streaming)
4. cliquer sur Gérer
5. cliquer sur Gérer le dépassement
   

Les 3 possibilités en cas de dépassement sont:

• A. interrompre le direct 
• B. déterminer une limite (en Go ou To) avant l'interruption des directs
• C. continuer à diffuser 

Ce guide explique comment configurer l'encodeur d'Infomaniak.

1. Accès par défaut et configuration du mot de passe

Une fois les branchements effectués, l’encodeur sera accessible sur votre réseau à l’adresse : 192.168.1.168

La configuration se fait depuis un navigateur Web à l’adresse : http://192.168.1.168

• Nom d’utilisateur : admin
• Mot de passe : admin

Dans un premier temps, nous vous invitons à définir un mot de passe fort :

2. Configuration réseau

Si l’accès à l’adresse 192.168.1.168 vous convient, vous pouvez passer directement au point 3.

Dans le cas contraire, si votre réseau est configuré en DHCP ou si vous souhaitez définir une adresse IP différente, la page System > Network vous permet de définir les paramètres d’accès. Il sera peut-être nécessaire de contacter votre administrateur réseau pour procéder aux différents réglages et autoriser ce nouveau périphérique au niveau de votre pare-feu.

3. Configuration du flux principal

3.1 Dans le cas ou un seul flux en envoyé

Nous sommes dans le cas du :

• Transcodage dans le Cloud => voir point (1) et (1.3) de ce guide
• ou du Monobitrate => voir point (3) de ce guide

Veuillez ajuster les paramètres suivants :

• Le bitrate (kbit) et la résolution (encoded size) doivent être ajustés selon vos besoins.
• RTMP PUBLISH URL correspond à l’URL de publication indiquée dans votre Manager dans la configuration des flux :

L’encodeur ne permet pas de renseigner une clé de stream. Il est donc nécessaire de concaténer cette dernière avec l’URL.

Exemple : rtmp://stream.vprimary.infomaniak.com/livecast?key=XXXXXX/stream

Les valeurs “stream” et le mot de passe (key=XXXXXX) doivent être remplacées par vos données personnelles.

3.2 Dans le cas où plusieurs flux sont envoyés

Pour en savoir plus sur ce cas, merci de vous reporter au point (2) et (2.2) de ce guide.

Dans le cas où plusieurs flux sont envoyés, vous serez dans un mode multibitrate avec n flux encodés sur l’encodeur.

Les sous-menus Substream1, Substream2 et Substream3 permettent de configurer l’encodage jusqu’à 3 flux supplémentaires :

3.3 Configuration audio

L’audio input sera à ajuster en fonction des branchements effectués. Le bitrate peut également être ajusté selon le type de contenu. Nous vous recommandons d'utiliser le codec suivant : 128 Kbps AAC, à 44100 Hz.