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

ApsaraVideo Live:Push SDK の問題のトラブルシューティング

最終更新日:Nov 09, 2025

このトピックでは、Push SDK の例外に関するトラブルシューティングの方法と手順について説明し、一般的な問題を効率的に特定して解決するのに役立ちます。

参考資料

コンソール操作ガイド

コンソールの セルフサービスのトラブルシューティング機能を使用して、ライブストリーミングの問題を特定して解決できます。

ApsaraVideo Live コンソールは、ライブストリーム管理、アプリケーション管理、データセンター、およびツールボックスモジュールの構成と使用法を提供します。詳細については、以下をご参照ください。

FAQ

テクニカルサポート

上記の手順に従っても問題が解決しない場合は、チケットを送信してテクニカルサポートを依頼できます。詳細については、「お問い合わせ」をご参照ください。

テクニカルサポートを求める際は、サポートの効率を向上させるために、次の情報を提供してください。

項目

説明

概要

発生した問題を 1 文で説明してください

-

問題の説明

  1. ビジネスシナリオ (基本的なライブストリーミング、インタラクティブストリームなど)。

  2. SDK のタイプとバージョン番号。

  3. 問題が発生した段階 (統合、本番など)。

  4. 詳細な症状とタイプ (ストリームの中断、映像なし、音声なしなど)。

  5. 再現手順 (一貫性があるか、断続的か、具体的な操作手順)。

  6. 問題の分布 (プラットフォーム、システムバージョン、デバイスモデル、リージョン)。

  1. ライセンス関連の問題については、アプリケーションのパッケージ名とライセンスキーを提供してください。

  2. より良いサポートのために、最新バージョンの SDK を使用することをお勧めします。

コンテキスト

  1. 問題が発生したときの具体的な環境の説明。

  2. アップストリーミング/ストリーミング URL (機密情報はマスクしてください)。

  3. 問題が発生した時間。

  4. ログ (logcat/ファイルログ、できれば圧縮してアップロード)。

  5. 構成情報 (アプリ名、パッケージ名、共同ストリーミング設定など)。

  6. その他の資料 (画面録画/スクリーンショットなど)。

  1. ログをキャプチャする前に、ロギング API (AlivcLiveBase クラス) を介してファイルロギングを有効にしてください。Demo の関連設定を参照できます。

  2. ライブストリームを閉じた後にログをキャプチャすることをお勧めします。

  3. ログファイルのパス:

    1. Android: /sdcard/Android/data/${app_id}/files/

    2. iOS: サンドボックスディレクトリ内

  4. 共同ストリーミングのシナリオでは、次の情報を提供してください:

    1. ストリーマーのアップストリーミング URL (アプリケーション ID、チャンネル番号、ユーザー ID を含む)

    2. 通常の視聴者のストリーミング URL (バイパスリレーで構成された再生ドメインを含む)

追加情報

  1. エラーメッセージ (利用可能な場合は、エラーコード/メッセージを含めてください)。

  2. 例外が自動的に回復できるかどうか (自動再接続など)。

  3. 問題の特定に役立つ可能性のあるその他の情報。

問題の説明に関するガイドライン

標準的な問題のテンプレート

問題のタイトル: (問題の概要を 1 文で)
ビジネスシナリオ: (例: 基本的なライブストリーミング / インタラクティブストリーム / 低遅延ストリーミング)
SDK とバージョン: (例: AlivcLivePusher: x.y.z または AlivcLivePusher_Interactive: x.y.z)
アプリケーション名/パッケージ名: (例: LiveExample / com.example.liveapp)

問題の種類と症状: (例: 時折ストリームが中断する / ストリームをプルできない / 映像がない、具体的な症状を簡潔に説明)
再現の確率: (例: 断続的 / 一貫性あり)
詳細な再現手順:
1. 
2. 
3. 
影響を受けるユーザー/デバイスの分布: (例: Android 9 以下 / iOS / 特定のリージョン)

アップストリーミング URL: (完全なアップストリーミング URL を貼り付けてください)
ストリーミング URL: (該当する場合)
発生時刻: (正確な時刻を指定するか、複数回発生した場合は例を挙げてください)
ネットワーク環境: (例: Wi-Fi/4G/5G/有線ネットワーク)
問題のログ: (例: logcat ログ、アップストリーミング/ストリーミングログ、できれば圧縮してアップロード)
画面録画/スクリーンショット: (異常な動作の録画や主要なスクリーンショットをアップロード)
アップストリーミングパラメーターの構成: (例: 解像度、フレームレート、ビットレート)

エラーメッセージ: (エラーが発生した場合、エラーコードまたはメッセージを提供)
例外からの自動回復: (例: 自動再接続、再接続の結果を説明)
その他の注記: (役立つと思われる情報があれば)

基本的なライブストリーミングの問題の例

問題のタイトル: 基本的なライブストリーミング中に時折ストリームが中断する
ビジネスシナリオ: 基本的なライブストリーミング
SDK とバージョン: AlivcLivePusher: x.y.z
アプリケーション名/パッケージ名: LiveExample / com.example.liveapp

問題の種類と症状: ストリーミング中、約 30 分ごとにストリームが時折中断され、手動での再起動が必要になる
再現の確率: 断続的
詳細な再現手順:
1. ストリーミングを開始する
2. 約 30 分後にストリームの中断が発生する
3. 回復するにはストリーミングを再起動する必要がある
影響を受けるユーザー/デバイスの分布: Android 9 以下、複数のデバイスモデル、東南アジアでより頻繁に発生

アップストリーミング URL: rtmp://test.alivecdn.com/live/streamId?auth_key=XXX
発生時刻: 2024-05-18 12:34
ネットワーク環境: 4G
問題のログ: 添付ファイル logcat_20240518.zip を参照
画面録画/スクリーンショット: 添付ファイルを参照
アップストリーミングパラメーターの構成: 解像度 720p、ビットレート 1500kbps、フレームレート 30fps

エラーメッセージ: エラーメッセージなし
例外からの自動回復: なし、手動での再起動が必要
その他の注記: なし

インタラクティブストリームの問題の例

問題のタイトル: 共同ストリーミングで CDN 視聴者がストリーマーの映像を受信できない
ビジネスシナリオ: 共同ストリーミング、AUI Kits インタラクティブストリーム
SDK とバージョン: AlivcLivePusher_Interactive: x.y.z
アプリケーション名/パッケージ名: LiveExample / com.example.liveapp

問題の種類と症状: ストリーマーのアップストリーミングは正常で、共同ストリーミングの視聴者は正常にストリームをプルできるが、CDN 視聴者はストリーマーの映像を見ることができず、エラーメッセージも表示されない
再現の確率: 一貫性あり
詳細な再現手順:
1. ストリーマーがインタラクティブストリームを開始し、アップストリーミングを始める
2. 共同ストリーミングの視聴者はストリーマーの映像を正常に受信する
3. CDN 視聴者 (Android/iOS) がライブチャンネルに入るが、ストリーマーの映像を見ることができない
影響を受けるユーザー/デバイスの分布: Android と iOS の両方で一貫して発生

アップストリーミング URL: artc://live.aliyun.com/push/633?timestamp=1685094092&token=fe4e674ade****6686&userId=718&sdkAppId=xxx
ストリーミング URL: rtmp://test.alivecdn.com/live/xxx_633_718_camera?auth_key=XXX
構成情報: チャンネル番号 633、アプリケーション ID xxx、ユーザー ID 718、再生ドメイン test.alivecdn.com
発生時刻: 2024-05-18 12:34
ネットワーク環境: Wi-Fi
問題のログ: 添付ファイル logcat_20240518.zip を参照
画面録画/スクリーンショット: 添付ファイルを参照
アップストリーミングパラメーターの構成: 解像度 720p、ビットレート 1200kbps、フレームレート 20fps

エラーメッセージ: なし
例外からの自動回復: なし、ストリーミングを閉じて再起動する必要がある
その他の注記: 視聴者側にはメッセージなし、ネットワーク/デバイスを切り替えても解決しない