Base de connaissances

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.

Préambule

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

Diffuser une playlist VOD en live streaming

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.

Afin de constituer la playlist, importez quelques vidéos:

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 le bouton Sélectionner (dans la partie Importation rapide).

Une fois les vidéos importées:

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

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

Ce guide explique comment interdire l'accès aux flux de Streaming vidéo Infomaniak grâce à une clé unique (hash).

Préambule

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

Restreindre l'accès aux diffusions 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 (prenez connaissance de cet autre guide pour personnaliser l'image de remplacement proposée aux spectateurs 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.

Gérer l'enregistrement automatique des diffusions en direct

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

Ce guide explique comment activer et utiliser la fonction Timeshift (aussi appelée DVR) sur vos diffusions vidéo en direct. Cette fonctionnalité permet à vos spectateurs de revenir en arrière s'ils n'ont pas eu l'occasion d'assister à votre direct depuis le début.

Activer la fonction Timeshift (DVR)

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

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 Configurer sous Timeshift depuis le tableau de bord:
   
4. Activez Timeshift.
5. Définissez la durée pendant laquelle vos spectateurs pourront revenir en arrière (max. 240 min.).
6. Cliquez sur le bouton Activer:
   

Personnaliser la fonction Timeshift

Il est possible d'activer cette option via l'outil de planification sur une plage d'horaire spécifique et de limiter ainsi cette possibilité à certains programmes. Les paramètres définis dans l'outil de planification écraseront l'état par défaut défini depuis le tableau de bord.

Pour bien comprendre cela, imaginez une TV qui diffuse un match de foot de 10h et 12h.

1. La TV souhaite uniquement activer Timeshift pendant le match

 Avec cette configuration, les spectateurs qui rejoignent le direct à 11h59 pourront revoir le début du match à 10h, mais ils ne pourront pas revoir les émissions qui précédaient le match avant 10h. Pour mémoire, la durée max. du Timeshift est de 240 min. (4 heures).
 

2. La TV souhaite uniquement activer un Timeshift de 20 minutes pendant le match

 Avec cette configuration, les spectateurs qui rejoignent le direct à 11h30 pourront revoir les 20 minutes précédentes, mais ils ne pourront pas revoir le début du match; seules les 20 dernières minutes glissantes seront accessibles pendant toute la durée du match.
 

3. La TV souhaite désactiver Timeshift pendant le match

 Avec cette configuration, les spectateurs ne pourront pas revoir des parties du match. Ils pourront uniquement voir les émissions qui précèdent le match si la fonction Timeshift a été activée par défaut depuis le tableau de bord du flux

En résumé, il y a donc 2 cas d'usage

1. Activer Timeshift en permanence, sauf pour des événements particuliers.
2. Désactiver Timeshift en permanence, sauf pour des événements particuliers.

Le statut par défaut se gère depuis le tableau de bord du flux et les exceptions depuis l'outil de planification.

En savoir plus sur le fonctionnement

Si vous avez défini un Timeshift d'une heure et que vous venez d'activer ce dernier, le temps de retour augmentera progressivement jusqu'à la durée choisie à partir du moment de l'activation.

Si des restrictions géographiques sont définies avec une plage d'horaire spécifique, ces dernières seront dans tous les cas respectées. Dans le cas où une TV avec un Timeshift de 4h réserverait son programme sportif aux visiteurs suisses de 10h à 12h, un spectateur italien qui se connecterait au flux à 13h pourrait uniquement revoir les émissions de 9h à 10h.

Ce guide explique comment interdire l'accès aux flux de Streaming vidéo Infomaniak en dehors de votre propre site uniquement.

Restreindre l'accès aux diffusions à un domaine

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 domaine:
   
6. Définissez le ou les sites qui doivent être spécifiquement autorisés à charger le flux.
7. Cliquez sur le bouton Enregistrer.

Prenez connaissance de cet autre guide pour personnaliser l'image de remplacement proposée aux spectateurs bloqués.

Ce guide explique comment personnaliser un Player de Streaming vidéo Infomaniak pour que l'image de votre choix soit proposée aux spectateurs notamment lors de restriction de flux.

Préambule

• Un flux vidéo peut être restreint:
  • Interruption planifiée de la diffusion (possibilité d'afficher un compte à rebours avant la reprise de la diffusion)
  • Restrictions géographiques ou autres restrictions (blocage via IP, domaine(s), token, etc.)

Personnaliser le Player Streaming vidéo 

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 Intégration dans le menu latéral gauche.
4. Cliquez sur Players dans le menu latéral gauche.
5. Cliquez sur le nom du Player à personnaliser.
6. Cliquez sur l'onglet (ou menu déroulant) Vignettes:
7. Personnalisez 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 les origines possibles d'une éventuelle latence que vous pourriez constater entre la source d'une vidéo et sa diffusion en direct via le service de Streaming vidéo Infomaniak.

Disponibilité dans le cas de...

... rendu sur le Manager

Une fois votre encodeur connecté sur les serveurs Infomaniak de type master, le flux peut subir plusieurs transformations, notamment dans le cas d'un transcodage ou le rajout d'un logo en watermark. Dans ces cas de figure, la vidéo doit être réencodée dans un ou plusieurs formats, ce qui nécessite un temps de traitement qui se répercute inévitablement sur le rendu final.

... flux mono bitrate sans retraitement

Dans ce cas de figure, le flux est disponible au bout de seulement quelques secondes.

... flux transcodé ou avec watermark

Ce traitement nécessite environ 25 secondes pour que le flux transformé soit visible dans la ou les différentes qualités.

... décalage entre la source et le rendu aux internautes

Afin d'éviter des microcoupures lors de la diffusion, le player (lecteur vidéo) met en mémoire tampon (buffer) plusieurs secondes de la vidéo. Vous pouvez ainsi facilement constater 30 à 60 secondes de décalage entre la source d'origine et le flux rendu aux internautes.

Pour réduire au maximum ce décalage, l'unique moyen est d'avoir un flux mono bitrate, sans transcodage, sans watermark, avec un bitrate pas trop élevé, et de réduire le plus possible le buffer dans la configuration du player. Selon vos besoins, il est donc nécessaire de faire un compromis entre l'instantanéité de la diffusion et des fonctionnalités que vous souhaitez utiliser pour améliorer l'expérience de vos spectateurs et personnaliser le branding de vos directs.