Compositeur d'expérience

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

Méthodes de l'API REST

Utilisez l'API REST Video API pour effectuer les opérations suivantes :

OpenTok SDK serveur comprennent également des méthodes d'utilisation d'Experience Composer.

Cas d'utilisation

Archives d'Experience Composer

Vous pouvez utiliser OpenTok archives fonctionnalité permettant d'enregistrer l'audio et la vidéo d' une session OpenTok. Toutefois, la mise en page vidéo de l'archive ainsi créée est limitée aux formats 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 :

Créez un « Experience Composer » dont l'URL pointe vers une page Web qui s'abonne aux flux d'une session, en appliquant la mise en page appropriée.
Demandez à Experience Composer de publier la page dans un flux au sein d'une nouvelle session OpenTok.
Utiliser le API REST d'OpenTok ou la méthode du SDK serveur OpenTok pour archiver le flux d'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 OpenTok fonction de diffusion en direct, vous pouvez diffuser une session OpenTok via un flux HLS ou RTMP. Cependant, la configuration vidéo pour une diffusion en direct est limitée aux formats 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 :

Créez un « Experience Composer » dont l'URL pointe vers une page Web qui s'abonne aux flux d'une session, en appliquant la mise en page appropriée.
Demandez à Experience Composer de publier la page dans un flux au sein d'une nouvelle session OpenTok.
Utiliser le API REST d'OpenTok ou la méthode du SDK serveur OpenTok pour diffuser le flux d'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 OpenTok permettent à un maximum de 15 000 clients de suivre une session OpenTok interactive. Le nombre de clients pris en charge dépend du nombre de clients diffusant des flux au cours de la session (voir la Diffusions interactives en direct ).

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

Créez un « Experience Composer » dont l'URL pointe vers une page Web qui s'abonne aux flux de la session OpenTok principale à diffuser.
Demandez à Experience Composer de publier la page dans une nouvelle session OpenTok.
Répétez cette opération avec plusieurs autres instances d'Experience Composer — chacune s'abonnant aux flux de la première session et les publiant dans une nouvelle session.
Votre serveur d'application enverra les identifiants de session pour l'application Sessions Experience Composer à chacun des clients en mode lecture (c'est-à-dire les clients qui ne publient pas vers la première session). Le serveur d'applications devra comptabiliser le nombre de clients ajoutés à chaque session d'Experience Composer, afin de s'assurer qu'aucune session n'accueille plus de 15 000 clients.

L'ensemble de sessions Experience Composer ainsi créé pourra prendre en charge jusqu'à 15 000 * (15 000 - 2) utilisateurs (224 970 000 utilisateurs) lorsqu'il y a deux éditeurs. Pour d'autres nombres d'éditeurs, consultez le tableau des clients pris en charge dans le Diffusions interactives en direct guide, et cette technique permettra de 15,000 * ([number supported from that table] - [number of publishers]) clients.

Autres cas d'utilisation

Vous pouvez utiliser Experience Composer pour capturer n'importe quelle page Web et la transmettre sous forme de flux audio-vidéo vers une session OpenTok afin que d'autres utilisateurs puissent la visualiser. La page peut inclure du contenu audio et vidéo provenant de sources autres que les flux OpenTok. Elle peut également comporter du contenu dynamique avec une mise en page complexe que les clients connectés à la session OpenTok peuvent visualiser.

Limites

Pas de support GPU

Les serveurs de rendu d'Experience Composer ne prennent pas en charge les GPU. Ils ne sont pas capables d'exécuter des applications web qui utiliseraient généralement plus de 10 % des ressources du GPU sous Chrome sur un ordinateur de bureau. Si l'application web que vous envoyez à Experience Composer utilise OpenGL (ou tout autre code pouvant tirer parti d'un GPU), les performances et le rendu dans Experience Composer risquent d'être altérés.

Sessions routées requises

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

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.

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": "&lt;experience-composer-id&gt;",
  "sessionId": "&lt;session-id&gt;",
  "streamId": "&lt;output-stream-id&gt;",
  "status": "stopped",
  "reason": "Max duration exceeded."
  "event": "render"
}

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

id — L'identifiant unique de l'Experience Composer.
sessionId — L'identifiant de session OpenTok.
streamId — Identifiant du flux composé en cours de publication. Le streamId peut ne pas être disponible lorsque le statut est « failed ».
status — L'état de l'Experience Composer. Cette propriété peut prendre l'une des valeurs suivantes :
- « démarré » — La plateforme Video API Vonage s'est connectée avec succès au serveur d'applications distant et publie la vue Web sur un flux OpenTok.
- « arrêté » — L'Experience Composer s'est arrêté.
- « Échec » — Une erreur s'est produite et Experience Composer n'a pas pu poursuivre l'opération. Cela peut se produire au démarrage si le serveur OpenTok ne parvient pas à se connecter au serveur d'applications distant ou à republier le flux. Cela peut également se produire à tout moment au cours du processus en raison d'une erreur de la plateforme Video API Vonage.
motif — Ce champ n'est disponible que lorsque le statut est « arrêté » ou « échec ». Si le statut est « arrêté », le champ « motif » indiquera soit « Durée maximale dépassée », soit « Arrêt demandé ». Si le statut est « Échec », le champ « Motif » indiquera « Échec interne du serveur ».
événement — Pour tous les événements de rappel d'Experience Composer, cette valeur est définie sur « render ».

Visualisation des données

Consultation des données via l'API Insights

Vous pouvez utiliser le API Insights pour consulter les données d'utilisation d'Experience Composer. Le 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 ont pas comprenaient les minutes correspondant aux périodes pendant lesquelles un Experience Composer était connecté à une archive ou à une diffusion. Ce n'est toutefois plus le cas aujourd'hui. (Les offres « Experience Composer Archive » et « Experience Composer Broadcast » ne sont plus disponibles.)