Compositeur d'expérience

Vue d'ensemble

Experience Composer est un service basé sur le cloud qui permet de capturer n'importe quel site web accessible au public et de le publier sous forme de flux dans une session Vonage Video API existante. Ce service flux composé peut être utilisé pour l'enregistrement d'archives, la diffusion et le streaming dans d'autres sessions interactives de Vonage Video, tout en gardant intactes les riches expériences UI/UX du site Web.

Cas d'utilisation

Archives d'Experience Composer

Vous pouvez utiliser la vidéo Vonage archives pour enregistrer l'audio et la vidéo d'une session Vonage Video. Cependant, la présentation vidéo pour l'archive composée est limitée aux éléments suivants pris en charge options de mise en page de la vidéo.

Vous pouvez utiliser Experience Composer pour utiliser l'interface utilisateur de votre site. réel pour la mise en page de l'archive :

  1. Créez un Experience Composer, dont l'URL pointe vers une page web qui s'abonne aux flux dans une session, en appliquant la mise en page appropriée.

  2. Demandez à l'Experience Composer de publier la page dans un flux dans une nouvelle session Vonage Video.

  3. Utiliser le API Video REST de Vonage ou la méthode SDK du serveur vidéo de Vonage pour archiver le flux Experience Composer.

Réglez la résolution de l'archive pour qu'elle corresponde à la résolution de l'Experience Composer (qui est définie lorsque vous démarrez l'Experience Composer).

Experience Composer Broadcast

Avec la vidéo Vonage fonction de diffusion en directAvec Vonage Video, vous pouvez diffuser une session Vonage Video vers un flux HLS ou RTMP. Cependant, la disposition vidéo pour une diffusion en direct est limitée aux éléments suivants pris en charge options de mise en page de la vidéo.

Vous pouvez utiliser Experience Composer pour utiliser l'interface utilisateur de votre site. réel pour la mise en page de l'émission :

  1. Créez un Experience Composer, dont l'URL pointe vers une page web qui s'abonne aux flux dans une session, en appliquant la mise en page appropriée.

  2. Demandez à l'Experience Composer de publier la page dans un flux dans une nouvelle session Vonage Video.

  3. Utiliser le API Video REST de Vonage ou la méthode SDK du serveur vidéo de Vonage pour diffuser le flux Experience Composer vers un flux HLS ou RTMP.

Réglez la résolution de l'archive pour qu'elle corresponde à la résolution de l'Experience Composer (qui est définie lorsque vous démarrez l'Experience Composer).

Élargir les émissions interactives en direct pour inclure davantage de participants (jusqu'à des millions)

Les diffusions en direct de Vonage Video vous permettent de voir jusqu'à 15 000 clients dans une session interactive de Vonage Video. Le nombre pris en charge dépend du nombre de clients publiant des flux dans la session (voir la section Diffusions interactives en direct ).

Vous pouvez utiliser Experience Composer pour augmenter le nombre de spectateurs :

  1. Créez un Experience Composer, dont l'URL pointe vers une page Web qui s'abonne aux flux de la session vidéo principale de Vonage à diffuser.

  2. Demandez à l'Experience Composer de publier la page dans une nouvelle session Vonage Video.

  3. Répétez cette opération avec un certain nombre d'autres instances d'Experience Composer - chacune s'abonnant aux flux de la première session et les publiant dans une nouvelle session.

  4. Votre serveur d'application enverra les identifiants de session pour l'application Sessions Experience Composer à chacun des clients de visualisation (clients qui ne publient pas dans la première session). Le serveur d'application devra suivre le nombre de clients ajoutés à chaque session de composition d'expérience, de manière à ce que pas plus de 15 000 clients ne se connectent à l'une d'entre elles.

L'ensemble des sessions Experience Composer qui en résulte prend en charge jusqu'à 15 000 * (15 000 - 2) spectateurs (224 970 000 spectateurs) lorsqu'il y a deux éditeurs. Pour d'autres nombres d'éditeurs, voir le tableau des clients pris en charge dans la section Diffusions interactives en direct et cette technique soutiendra l'action de l'Union européenne dans le domaine de la santé. 15,000 * ([number supported from that table] - [number of publishers]) clients.

Experience composer

Autres cas d'utilisation

Vous pouvez utiliser Experience Composer pour capturer n'importe quelle page Web et l'envoyer sous forme de flux audio-vidéo dans une session Vonage Video pour que d'autres personnes puissent la voir. La page peut inclure de l'audio et de la vidéo provenant de sources autres que les flux de Vonage Video. Elle peut également inclure un contenu dynamique avec une interface utilisateur complexe que les clients connectés à la session Vonage Video peuvent visualiser.

Limites

Pas de support GPU

Les serveurs de rendu d'Experience Composer n'ont pas de GPU support. Ils ne sont pas en mesure d'exécuter des applications web qui utiliseraient normalement plus de 10 % de l'espace disque de l'ordinateur. GPU s'exécutant dans Chrome sur un ordinateur de bureau. Si l'application web que vous envoyez à Experience Composer utilise OpenGL (ou tout autre code qui bénéficierait d'un GPU), les performances et le rendu dans Experience Composer peuvent être dégradés.

Sessions routées requises

Experience Composer n'est compatible qu'avec les sessions routées (sessions qui utilisent l'option Routeur vidéo multimédia de Vonage).

Rotation des serveurs

Un Experience Composer se termine pendant la rotation du serveur pour la session qu'il utilise. Vous pouvez redémarrer un Experience Composer en réponse aux événements de notification de rotation du serveur. Voir Rotation des serveurs et migration des sessions.

REST-API uniquement

Au moment de la rédaction du présent document, l'Experience Composer n'est accessible que via une interface API REST. Voir la page Documentation REST pour plus d'informations.

Configuration des rappels

Afin de configurer des rappels sécurisés pour les webhooks d'Experience Composer, veuillez vous référer à ce guide.

Lorsque le statut d'un Experience Composer change, un POST HTTP est envoyé à l'URL configurée. Si aucune URL de rappel n'est configurée, aucune mise à jour de l'état ne sera délivrée. Les données brutes de la requête HTTP sont un message encodé en JSON de la forme suivante :

{
  "id": "<experience-composer-id>",
  "sessionId": "<session-id>",
  "streamId": "<output-stream-id>",
  "status": "stopped",
  "reason": "Max duration exceeded."
}

L'objet JSON comprend les propriétés suivantes :

  • id: L'identifiant unique du compositeur d'expérience.
  • sessionId: L'ID de la session vidéo Vonage.
  • streamId: L'ID du flux composé en cours de publication. L'identifiant du flux peut ne pas être disponible lorsque le statut est "failed".
  • status: L'état de l'Experience Composer. Cette propriété est définie comme l'une des suivantes :
    • "started": La plateforme Video API de Vonage s'est connectée avec succès au serveur d'application distant et publie la vue web sur un flux vidéo Vonage.
    • "stopped": L'Experience Composer s'est arrêté.
    • "failed": Une erreur s'est produite et l'Experience Composer n'a pas pu continuer. Cela peut se produire au démarrage si le serveur Vonage Video ne peut pas se connecter au serveur d'application distant ou republier le flux. Elle peut également se produire à n'importe quel moment du processus en raison d'une erreur de la plate-forme API Video de Vonage.
  • reason: Ce champ n'est disponible que lorsque le statut est soit "stopped" ou "failed". Si l'état est "stopped"le champ "motif" contiendra l'un ou l'autre des éléments suivants "Max Duration Exceeded" ou "Stop Requested." Si le statut est "failed"le champ "motif" contiendra "Internal server failure".

Visualisation des données

Afficher les données dans le tableau de bord de l'analyse vidéo

Le tableau de bord Video Analytics at Vonage fournit des données au niveau de la clé API et de l'identifiant de l'application. Vous pouvez y accéder en vous connectant à votre compte Compte Video API de VonageAllez dans Analytics, puis dans la section Video Analytics.

Afficher les données dans Video Insights API

Vous pouvez utiliser le API Insights pour consulter les données d'utilisation d'Experience Composer.

Les experienceComposer Les données d'utilisation montrent les minutes publiées par Experience Composer.

Les experienceComposerArchive et experienceComposerBroadcast sont obsolètes. Auparavant, les propriétés experienceComposer les données d'utilisation n'incluaient pas les minutes des périodes où un Experience Composer était connecté à une archive ou à une diffusion. Cependant, ce n'est plus le cas. (Les offres groupées Experience Composer Archive et Experience Composer Broadcast ne sont plus disponibles).