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

ApsaraVideo Live:ApsaraVideo Real-time Communication (ARTC) のよくある質問

最終更新日:Feb 07, 2026

このトピックでは、ApsaraVideo Real-time Communication (ARTC) に関するよくある質問への回答を提供します。

単一パラメーターと複数パラメーターでのチャンネル参加の違い

  • 機能的な違いはありません。単一パラメーター方式では、すべての必須パラメーターを JSON 文字列にパッケージ化し、Base64 エンコードします。

  • 単一パラメーター方式では、サーバーがすべての認証パラメーターを 1 つの応答で生成および配信できます。これにより、クライアントとサーバーのパラメーター間の不整合が防止され、統合が簡素化されます。

  • 新規の統合には、単一パラメーター方式の使用を推奨します。

チャンネル参加後に OnJoinChannelResult コールバックがトリガーされない理由

  • joinchannel API がゼロ以外の値を返すかどうかを確認します。ゼロ以外の戻り値は、無効なパラメーターを示します。API レイヤーはこれらのエラーをインターセプトし、戻り値で報告します。

  • ネットワーク接続を確認します。joinchannel がエラーを報告しない場合、ネットワークの問題が発生すると、SDK は内部的にサーバーへの再接続を試みます。onConnectionStatusChange コールバックを使用して、SDK の現在の接続ステータスをモニターできます。SDK を直接停止することもできます。

  • 計算された認証トークンを確認します。トークンが無効な場合、OnJoinChannelResult コールバックはエラーを報告します。

DingRTC SDK を使用してチャンネルに参加できない理由

ARTC は、Global Realtime Transport Network (GRTN) 上に構築されたリアルタイム通信システムです。DingRTC は別のプロダクトであり、ARTC と互換性はありません。ARTC を使用するには、ApsaraVideo Live コンソールでアプリケーションを作成し、公式 ApsaraVideo Live ドキュメントから ARTC SDK をダウンロードしてください。

チャンネルプロファイルの選択方法

Interactive mode (InteractiveLive) は視聴者ロールをサポートしますが、Communication mode (Communication) はサポートしません。ユースケースで視聴者が必要になるかどうかわからない場合は、最大限の柔軟性を得るために InteractiveLive を使用してください。

共同ストリーミング API と ARTC API の違い

共同ストリーミング API は、ライブストリーミングシナリオ向けに ARTC API の上に構築された、簡素化された使いやすいレイヤーです。

共同ストリーミング URL の "live.aliyun.com" ドメインを ping できない理由

"live.aliyun.com" ドメイン名は直接のサーバーアドレスではないため、ping できません。URL を使用する際は、ドメイン名ではなく他のパラメーターに注目してください。

ARTC が提供する View とシステム View の違い

iOS では、ARTC は AliRenderView を提供します。Android では、ARTC は SurfaceView と TextureView を提供します。これらの View はシステム View の上に構築されています。これらは、すべての基本的な View の特徴と、ARTC 固有のライフサイクル監視およびカスタマイズをサポートします。ARTC が提供する View の使用を推奨します。

LeaveChannel などの API 呼び出し時にエラーが発生する理由

エラーは、無効なパラメーターまたは不適切な呼び出しシーケンスを示します。パラメーターを取らない LeaveChannel の場合、エラーは、チャンネルに参加する前に呼び出す、または複数回呼び出すなど、不適切な呼び出しシーケンスを示します。このエラーを処理する必要はありません。ARTC はステートフルな API デザインを使用します。望ましい状態を設定すると、コールバックが実際の状態を確認します。たとえば、SDK ライフサイクル中の任意の時点で LeaveChannel を呼び出すと、内部状態は「チャンネルを離脱した」に設定されます。

回復不能な SDK エラーのみを処理する必要があります。詳細については、「ARTC エンジンの初期化とコールバックの登録」をご参照ください。

現在のネットワークステータスの検出方法

ネットワークステータスは、SDK とバックエンドサービス間の接続を反映します。onConnectionStatusChange コールバックを使用して、それをモニターできます。詳細については、「チャンネル接続ステータス管理」をご参照ください。

オーディオのミュートは課金に影響しますか

  1. チャンネルに参加している限り、課金されます。

  2. ストリームをサブスクライブする場合、サブスクライブされたストリームに対してのみ課金されます。オーディオをミュートしても課金に影響はありません。

  3. 詳細については、「オーディオおよびビデオ通話料金」をご参照ください。

ファイアウォールがある場合、どのポートとドメイン名をホワイトリストに登録する必要がありますか

ポート

プロトコル

ポート

TCP

80 443

UDP

8443 1106

ドメイン名

gw.rtn.aliyuncs.com

rsdk-rtcsub.data.alivecdn.com

r5-rtcpub.media-sh.alivecdn.com

r5-rtcsub.media-sh.alivecdn.com

rs.rtn.aliyuncs.com