すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:ApsaraVideo Real-time Communication アプリケーションの管理

最終更新日:Jun 19, 2026

ApsaraVideo Real-time Communication を使用するには、通話、雑談、会議などの機能をサポートするアプリケーションを作成する必要があります。

ApsaraVideo Real-time Communication アプリケーションの作成

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションペインで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。

  3. アプリケーションの作成 をクリックします。ed34559efbe60c8073c93d6038eaaeaa

  4. カスタムの インスタンス名 を入力し、[利用規約] に同意してから、[購入] をクリックします。

  5. 成功メッセージが表示されたら、リアルタイムオーディオビデオ > アプリケーション ページを更新して、作成したコラボ配信アプリケーションを表示します。

    説明

    アプリケーションの作成は無料です。 実際のクラウド使用量に対して、従量課金で請求されます。 詳細については、「ApsaraVideo Real-time Communication の価格」をご参照ください。

ストリームリレーの設定

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションペインで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。 設定するアプリケーションを選択し、管理 をクリックします。

  3. バイパス・プッシュ転送 をクリックします。 [バイパス・プッシュ転送] は、次のいずれかの方法で設定できます。

    1. [方法1:バイパス・プッシュ転送を指定する]

      CreateLiveMixJob (New) API を呼び出して、特定のチャネルのリアルタイム [バイパス・プッシュ転送] (ストリームミキシングあり) を ApsaraVideo Live またはサードパーティのプラットフォームに設定します。 これには、軽微なサーバーサイド開発が必要です。

    2. [方法2:Alibaba Cloud ライブへのグローバルバイパス・プッシュ転送を行う]

      ストリームリレーを有効にすると、音声ストリームと映像ストリームが Alibaba Cloud ライブセンターのオリジンサーバーにインジェストされます。 その後、再生ドメイン名を使用して、トランスコーディング、録画、スナップショットなどの機能を設定したり、ライブストリームをプルして表示したりできます。

      1. バイパス・プッシュ転送 スイッチをオンにします。

      2. インジェストパラメーターを設定します。

        パラメーター

        設定オプション

        説明

        [バイパス・プッシュ転送]

        オンまたはオフ

        シングルストリームインジェストを有効にすると、すべての音声ストリームと映像ストリームがデフォルトで ApsaraVideo Live にインジェストされます。 ソフトウェア開発キット (SDK) またはサーバーサイド API を使用して、ストリームミキシングのレイアウトを更新することもできます。

        再生ドメイン名

        例: play.example.com

        ApsaraVideo Live にインジェストされたストリームの再生ドメイン名です。 このドメイン名を使用して、ライブストリームの再生や、トランスコーディング、録画などの機能も設定できます。

        説明
        • 再生ドメイン名がない場合は、ドメイン名コンソールに移動して追加します。

        • 再生ドメイン名は、遅延が 400 ms ~ 600 ms のリアルタイムストリーミング (RTS) をサポートしていません。 RTS を使用すると、インジェストが失敗します。

        AppName

        最大 255 文字。 数字、大文字と小文字、ハイフン (-)、アンダースコア (_)、等号 (=) をサポートします。

        デフォルト値は "live" です。 この値はカスタマイズできます。

        インジェスト後のストリーミング URL 内の AppName です。 詳細については、「ストリーミング URL の生成」をご参照ください。

        説明

        トランスコーディング、録画、またはスナップショットのテンプレートをインジェストされたストリームにアタッチするには、テンプレートが有効になるように、この AppName をテンプレートの AppName と同じに設定する必要があります。

        [グローバル自動 SEI 設定]

        • 一定間隔で SEI を挿入:指定された間隔で Supplemental Enhancement Information (SEI) フレームを挿入します。 間隔は 1000 ms から 5000 ms の範囲で設定できます。

        • I フレームに SEI を挿入:映像ストリームの I フレームに SEI を挿入します。

        Supplemental Enhancement Information (SEI) は、ユーザー ID (UID) やストリームミキシングのレイアウトパラメーターなどの基本的なユーザー情報を、システム SEI を介してストリームに挿入します。 たとえば、コラボ配信のシナリオでは、ストリームミキシングのレイアウトが変更されると、視聴者のアプリケーションは SEI からレイアウト情報をリアルタイムで解析して、インタラクティブ UI を調整できます。 詳細については、「Supplemental Enhancement Information (SEI) のフォーマット」をご参照ください。

        説明

        ドメイン名コンソールに再生ドメイン名がない場合は、まずドメイン名を追加する必要があります。 詳細については、「ドメイン名の追加」をご参照ください。

Supplemental Enhancement Information (SEI) のフォーマット

データ型

パラメーター名

映像ストリーム情報

stream

配信者情報:

uid:配信者のユーザー ID。

配信者のウィンドウ領域のレイアウト情報。 主なパラメーターは次のとおりです。

  • paneid:ウィンドウ内の領域の ID。 有効な値: [0,8]。

  • zorder:領域のスタックレベル。 有効な値: [0,99]。

  • x:キャンバス上の領域の x 座標。 正規化されたパーセンテージ。

  • y:キャンバス上の領域の y 座標。 正規化されたパーセンテージ。

  • w:領域の幅。 正規化されたパーセンテージ。

  • h:領域の高さ。 正規化されたパーセンテージ。

  • vol:配信者の音量 (デシベル)。 有効な値: [0,255]。

  • vad:音声区間検出 (VAD)。 値が 150 の場合は音声が検出されたことを示します。 150 以外の値は、音声が検出されてから検出されなくなるまでの後続時間を示します。

説明

たとえば、ストリームミキシングのレイアウトが UID 111 と 222 の 2 人のユーザーに適用された場合、SEI メッセージは次のようになります。

{"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":60,"vad":123}]}

コールバックイベント

ApsaraVideo Real-time Communication は、チャネル、ユーザー、ストリームリレー、およびストリームミキシングのコールバックイベントを提供します。 これらのコールバックイベントはコンソールで設定できます。

コールバックの概要

コールバックイベントを使用すると、ビジネスサーバーは、チャネル、ユーザー、ストリームリレー、およびストリームミキシングのリアルタイムのステータス変更を受信できます。

  • チャネルコールバック:チャネルの作成や解散などのイベント。

  • ユーザーコールバック:ユーザーのチャネルへの参加または退出、ロールの切り替え、ストリームのインジェストまたはプルの開始または停止などのイベント。

  • ストリームリレーとストリームミキシングのコールバック:[バイパス・プッシュ転送] イベント。

チャネルとユーザーのコールバックの詳細については、「チャネルメッセージコールバックの購読」をご参照ください。 ストリームリレーとストリームミキシングのコールバックの詳細については、「ストリームミキシングとインジェストイベントの購読」をご参照ください。

コールバックタスクの作成

チャネルとユーザーのコールバック

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションペインで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。

  3. コールバックタスクを作成するアプリケーションを見つけ、管理 をクリックしてアプリケーション管理ページに移動します。

  4. 左側のナビゲーションペインで、イベントコールバック > チャネルとユーザーのコールバック を選択し、タスクの作成 をクリックします。

  5. コールバックパラメーターを設定します。 パラメーターについては、次の表で説明します。

    パラメーター

    説明

    [コールバック URL]

    コールバックメッセージを受信するビジネスサーバーのアドレスです。 HTTP と HTTPS がサポートされています。 HTTPS の使用を推奨します。

    [コールバックイベント範囲]

    コールバックイベントには、ユーザーイベントチャネルイベント が含まれます。

    • ユーザーイベントには次のものが含まれます。

      • チャネルへの参加

      • 画面共有の開始

      • 退出

      • 映像インジェストの停止

      • ロールの切り替え

      • 音声インジェストの停止

      • 映像インジェストの開始

      • 画面共有の停止

      • 音声インジェストの開始

    • チャネルイベントには次のものが含まれます。

      • チャネルの開始

      • チャネルの終了

    [指定チャネル]

    オプション。 チャネルを指定しない場合、コールバックはデフォルトですべてのチャネルのイベントに対して生成されます。 チャネルを指定した場合、コールバックはそのチャネルのイベントに対してのみ生成されます。

    [指定ユーザー]

    オプション。 このパラメーターはユーザーイベントにのみ適用されます。 ユーザー ID を指定する場合は、チャネル ID も指定する必要があります。 最大 20 個のユーザー ID を入力でき、コンマ (,) で区切ります。

  6. [OK] をクリックしてタスクを作成します。

ストリームリレーとストリームミキシングのコールバック

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションペインで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。

  3. コールバックタスクを作成するアプリケーションを見つけ、管理 をクリックします。

  4. 左側のナビゲーションペインで、イベントコールバック > バイパスとミックスストリームのコールバック を選択し、設定 をクリックします。

  5. コールバックパラメーターを設定します。 パラメーターについては、次の表で説明します。

    パラメーター

    説明

    Webhook URL

    コールバックメッセージを受信するビジネスサーバーのアドレスです。 HTTP と HTTPS がサポートされています。 HTTPS の使用を推奨します。

    チャネルスコープ

    オプション。 コールバックを受信するチャネル (ChannelID) を指定します。 最大 20 個のチャネルを指定できます。 複数の ID はコンマ (,) で区切ります。 各チャネル ID には、大文字、小文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。 最大長は 64 文字です。 このパラメーターを空欄にした場合、デフォルトですべてのチャネルからコールバックを受信します。

コールバックレコードの編集と削除

チャネルとユーザーのコールバック

チャネルとユーザーのコールバックタスクを作成した後、タスクを更新または削除できます。

image

  1. 左側のナビゲーションペインで チャネルとユーザーのコールバック ページに移動し、更新または削除するタスクを見つけます。

  2. 「操作」列で、タスクを編集するには編集を、タスクを削除するには削除をクリックします。

ストリームリレーとストリームミキシングのコールバック

ストリームリレーとストリームミキシングのコールバックを設定した後、設定を変更または削除できます。image

コールバックレコードの表示

コールバックタスクが有効になると、コールバックレコードでコールバックイベントの詳細を表示できます。

image

image