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

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

最終更新日:Jul 17, 2026

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

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

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

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

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

  4. [Billing Method] で [利用時間課金] または [月次 95 パーセンタイル] を選択します。

  5. 任意の インスタンス名 を入力し、[Terms of Service] に同意してから、[Purchase] をクリックします。

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

    説明

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

バイパスインジェストの設定

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

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

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

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

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

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

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

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

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

        パラメータ

        設定オプション

        説明

        バイパス・プッシュ転送

        [On] または [Off]

        単一ストリームインジェストを有効にすると、デフォルトで全ての音声・映像ストリームが ApsaraVideo Live にインジェストされます。SDK またはサーバー側 API を使用して、ストリームミキシングのレイアウトを引き続き更新できます。

        再生ドメイン名

        例:play.example.com

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

        説明
        • ストリーミングドメインがない場合は、[Domain Names] コンソールで追加してください。

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

        [AppName]

        最大 255 文字。数字、英大文字、英小文字、ハイフン (-)、アンダースコア (_)、イコール (=) を使用できます。

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

        インジェスト後のストリーミング URL に含まれる AppName です。詳細については、「Generate streaming URLs」をご参照ください。

        説明

        インジェスト済みストリームにトランスコード、録画、またはスナップショットのテンプレートを関連付けるには、この AppName をテンプレート内の AppName と同じに設定し、テンプレートを有効にする必要があります。

        グローバル自動 SEI 設定

        • 一定間隔で SEI を挿入:指定した間隔で補助拡張情報 (SEI) フレームを挿入します。間隔は 1000 ms ~ 5000 ms で設定できます。

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

        補助拡張情報 (SEI) は、UID などの基本的なユーザー情報や、ストリームミキシングのレイアウトパラメータを、システム SEI を使用してストリームに挿入します。例えば、共同ストリーミングのシナリオでストリームミキシングのレイアウトが変更された場合、視聴者側のアプリケーションは SEI からレイアウト情報をリアルタイムに解析し、インタラクティブ UI を調整できます。詳細については、「Supplemental Enhancement Information (SEI) format」をご参照ください。

        説明

        Domain Names コンソールにストリーミングドメインがない場合は、先に追加する必要があります。詳細については、「Add a domain name」をご参照ください。

補助拡張情報 (SEI) の形式

データ型

パラメータ名

値

映像ストリーム情報

stream

配信者情報:

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

配信者のウィンドウ領域のレイアウト情報。次のパラメータに注意してください。

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

  • zorder:領域の重ね順のレベル。有効値:[0, 99]。

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

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

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

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

  • vol:配信者の音量 (dB)。有効値:[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 は、チャンネル、ユーザー、バイパスインジェスト、ストリームミキシング用のコールバックイベントを提供します。これらのコールバックイベントはコンソールで設定できます。

コールバックの概要

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

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

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

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

チャンネルおよびユーザーコールバックの詳細については、「Subscribe to channel message callbacks」をご参照ください。バイパスおよびストリームミキシングコールバックの詳細については、「Subscribe to stream mixing and ingest events」をご参照ください。

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

チャンネルおよびユーザーコールバック

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

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

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

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

  5. コールバックパラメータを設定します。パラメータは次の表のとおりです。

    パラメータ

    説明

    コールバック URL

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

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

    コールバックイベントには、[User events] と [Channel events] が含まれます。

    • [User events] には次のイベントが含まれます。

      • チャンネル参加

      • 画面共有の開始

      • 退出

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

      • ロールの切り替え

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

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

      • 画面共有の停止

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

    • [Channel events] には次のイベントが含まれます。

      • チャンネル開始

      • チャンネル終了

    指定チャネル

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

    指定ユーザー

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

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

バイパスおよびストリームミキシングコールバック

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

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

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

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

  5. コールバックパラメータを設定します。パラメータは次の表のとおりです。

    パラメータ

    説明

    [Webhook アドレス]

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

    [Channel scope]

    オプションです。コールバックを受信するチャンネル (ChannelIDs) を指定します。最大 20 件のチャンネルを指定できます。複数の ID はカンマ (,) で区切ります。各チャンネル ID には、英大文字、英小文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。最大長は 64 文字です。空欄の場合は、デフォルトで全てのチャンネルからコールバックを受信します。

コールバックタスクの編集と削除

チャンネルおよびユーザーコールバック

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

  1. チャネルとユーザーのコールバック ページに移動し、更新または削除するタスクを探します。

  2. [操作] 列で、編集 をクリックしてタスクを変更するか、削除 をクリックしてタスクを削除します。

バイパスおよびストリームミキシングコールバック

バイパスおよびストリームミキシングコールバックを設定した後、設定を変更または削除できます。

リレーおよびミキシングのコールバックタスクを設定すると、ステータスは [Configured] と表示されます。[Modify Configuration]、削除、[Callback Example] を使用して、コールバックタスクを管理できます。また、このページには設定済みのコールバック URL とチャンネルスコープ (例:[All Channels]) も表示されます。

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

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

コールバックレコードには、直近 7 日間のコールバック成功/失敗データが保持されます。時間範囲 ([Today]、[Last 3 Days]、[Last 7 Days]、[Custom]) と [Callback ID] でレコードを絞り込めます。レコードには次のフィールドが含まれます。

  • Callback ID

  • Callback Time

  • Callback Content

  • Callback URL

  • Request Result

[Callback Records] タブをクリックして、時間範囲 ([Today]、[Last 3 Days]、[Last 7 Days]、または [Custom]) でレコードを絞り込み、[Callback Time]、[Callback Content]、コールバック URL、[Request Result] を確認します。