エクスペリエンス・コンポーザー

概要

エクスペリエンス・コンポーザーはクラウドベースのサービスで、一般に公開されているウェブサイトをキャプチャし、既存のVonage Video APIセッションでストリームとして公開することができます。この コンポジット・ストリーム は、ウェブサイトの豊富なUI/UX体験をそのままに、アーカイブ録画、ブロードキャスト、他のインタラクティブなVonage Videoセッションへのストリーミングに使用できます。

使用例

エクスペリエンス・コンポーザー アーカイブ

Vonageビデオ アーカイブ 機能を使って、Vonage Video セッションのオーディオとビデオを録画することができます。ただし、構成されたアーカイブのビデオレイアウトは、サポートされているものに限られます。 ビデオ・レイアウト・オプション.

エクスペリエンス・コンポーザーを使用すると、サイトの 実際 レイアウトをアーカイブのレイアウトに使用する：

  1. セッションでストリームを購読する Web ページを指す URL を指定して、適切なレイアウトを適用するエクスペリエンス・コンポーザーを作成します。

  2. エクスペリエンス コンポーザーで、新しい Vonage Video セッションのストリームにページをパブリッシュします。

  3. を使用する。 Vonage Video REST API または Vonage Video サーバー SDK メソッドを使用して Experience Composer ストリームをアーカイブします。

アーカイブの解像度をエクスペリエンス コンポーザーの解像度に合わせます(エクスペリエンス コンポーザーの起動時に設定されます)。

エクスペリエンス・コンポーザー・ブロードキャスト

Vonageビデオ ライブ・ストリーミング放送機能この場合、Vonage Video セッションを HLS または RTMP ストリームにブロードキャストすることができます。ただし、ライブ・ストリーミング・ブロードキャストのビデオ・レイアウトは、サポートされる ビデオ・レイアウト・オプション.

エクスペリエンス・コンポーザーを使用すると、サイトの 実際 レイアウトを放送レイアウトに使用する：

  1. セッションでストリームを購読する Web ページを指す URL を指定して、適切なレイアウトを適用するエクスペリエンス・コンポーザーを作成します。

  2. エクスペリエンス コンポーザーで、新しい Vonage Video セッションのストリームにページをパブリッシュします。

  3. を使用する。 Vonage Video REST API または Vonage Video Server SDK メソッドを使用して、Experience Composer ストリームを HLS または RTMP ストリームにブロードキャストします。

アーカイブの解像度をエクスペリエンス コンポーザーの解像度に合わせます(エクスペリエンス コンポーザーの起動時に設定されます)。

双方向ライブ放送を拡大し、参加者を増やす（最大数百万人）

Vonage Videoライブストリーミング放送では、最大15,000クライアントがインタラクティブなVonage Videoセッションを視聴できます。サポートされる人数は、セッションでストリームを公開しているクライアントの数によって異なります ( 双方向ライブ放送 ガイド）。

エクスペリエンス・コンポーザーを使用して、視聴者の数を増やすことができます：

  1. 放送されるメインの Vonage Video セッションのストリームを購読する Web ページを指す URL を持つエクスペリエンス・コンポーザーを作成します。

  2. エクスペリエンス コンポーザーで、ページを新しい Vonage Video セッションに発行します。

  3. 最初のセッションでストリームをサブスクライブし、新しいセッションにパブリッシュします。

  4. アプリケーション・サーバーは、以下のセッションIDを送信します。 エクスペリエンス・コンポーザー・セッション を各視聴クライアント（最初のセッションに公開していないクライアント）に追加する必要があります。アプリケーション・サーバーは、各エクスペリエンス・コンポーザー・セッションに何人のクライアントが追加されたかを追跡する必要があります。

パブリッシャーが 2 つの場合、Experience Composer セッションの配列は最大 15,000 * (15,000 - 2) ビューアー (224,970,000 ビューアー) をサポートします。それ以外の数のパブリッシャーについては、次のセクションのサポートされるクライアントの表を参照してください。 双方向ライブ放送 そして、このテクニックは 15,000 * ([number supported from that table] - [number of publishers]) の顧客だ。

Experience composer

その他の使用例

エクスペリエンス コンポーザーを使用して任意の Web ページをキャプチャし、音声/ビデオ スト リームとして Vonage Video セッションに送信して、他のユーザーが表示できます。ページには、Vonage Video ストリーム以外のソースからの音声とビデオが含まれる場合があります。または、Vonage Video セッションに接続されたクライアントが表示できる複雑な UI レイアウトの動的コンテンツが含まれる場合もあります。

制限事項

GPU非対応

エクスペリエンス コンポーザーのレンダリング サーバーには GPU support.これらのシステムでは ウェブアプリケーションを実行することはできません。 GPU をデスクトップ上のChromeで実行する。Web アプリケーションで が OpenGL (またはその他のコードで GPU)、エクスペリエンス・コンポーザーでのパフォーマンスとレンダリングが低下する場合があります。

定期的なセッションが必要

エクスペリエンス・コンポーザーは、ルーティングされたセッションにのみ対応しています。 ビデオ・メディア・ルーター).

サーバーローテーション

エクスペリエンス・コンポーザは、使用しているセッションのサーバーローテーション中に終了します。サーバー ローテーション通知イベントに応じて、エクスペリエンス コンポーザーを再起動できます。参照 サーバーのローテーションとセッションの移行.

REST-APIのみ

本稿執筆時点では、エクスペリエンス・コンポーザーにはREST APIインターフェースからのみアクセスできる。詳細は RESTドキュメント をご覧ください。

コールバックの設定

Experience Composer Webhooks の安全なコールバックを設定するには、以下を参照してください。 本ガイド.

エクスペリエンス コンポーザーのステータスが変更されると、HTTP POST が設定された URL に配信されます。コールバック URL が設定されていない場合、ステータスの更新は配信されません。HTTP 要求の生データは、次の形式の JSON エンコードされたメッセージです：

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

JSONオブジェクトには以下のプロパティが含まれる：

  • id: エクスペリエンス・コンポーザー固有の ID。
  • sessionId:Vonage VideoセッションID。
  • streamId:公開される合成ストリームのID。ステータスが "failed".
  • status:エクスペリエンス・コンポーザーの状態。このプロパティには、以下のいずれかが設定されます：
    • "started":Vonage Video API プラットフォームがリモートアプリケーションサーバに正常に接続されました。 ウェブビューを Vonage Video ストリームに公開しています。
    • "stopped":エクスペリエンス・コンポーザーが停止しました。
    • "failed":エラーが発生し、エクスペリエンス コンポーザーを続行できませんでした。これは、Vonage Video サーバーがリモート アプリケーション サーバーに接続できない場合、またはストリームを再パブリッシュできない場合に、起動時に発生する可能性があります。また、Vonage Video API プラットフォーム エラーにより、処理中のどの時点でも発生する可能性があります。
  • reason:このフィールドは、ステータスが以下のいずれかである場合にのみ有効です。 "stopped" または "failed".ステータスが "stopped"理由フィールドには "Max Duration Exceeded" または "Stop Requested." ステータスが "failed"理由フィールドには "Internal server failure".

データの可視化

ビデオ分析ダッシュボードでデータを見る

Video Analytics at Vonage Dashboardは、APIキーとアプリケーションIDレベルでデータを提供します。このダッシュボードには Vonage Video API アカウントをクリックし、「アナリティクス」の「ビデオ分析」セクションに進む。

Video Insights APIでデータを見る

を使用することができます。 インサイトAPI をクリックして、エクスペリエンス コンポーザーの使用状況データを表示します。

について experienceComposer 使用状況データは、エクスペリエンス・コンポーザーが公表した議事録を示しています。

について experienceComposerArchive そして experienceComposerBroadcast 使用プロパティは非推奨。以前は experienceComposer 使用状況データには、エクスペリエンス・コンポーザーがアーカイブまたはブロードキャストに接続されている期間の分数は含まれていませんでした。しかし、現在はこのようなことはありません。(エクスペリエンス コンポーザー アーカイブおよびエクスペリエンス コンポーザー ブロードキャスト バンドルは利用できなくなりました）。