このトピックでは、Push SDK の例外に関するトラブルシューティングの方法と手順について説明し、一般的な問題を効率的に特定して解決するのに役立ちます。
参考資料
API 操作に関連する問題のトラブルシューティングについては、API リファレンスをご参照ください。
Android: Basic Edition、Interactive Edition
Flutter: Flutter Push SDK API ドキュメント
Windows: Windows Push SDK API ドキュメント
デモのソースコードをダウンロードして、API の使用方法を学び、その機能を確認できます。
ビジネスシナリオに共同ストリーミングが含まれる場合は、「共同ストリーミングの概要」および「共同ストリーミングの開始」をご参照ください。
ApsaraVideo MediaBox SDK を使用する場合は、統合および使用ガイドを含む ApsaraVideo MediaBox SDK のドキュメントをご参照ください。
コンソール操作ガイド
コンソールの セルフサービスのトラブルシューティング機能を使用して、ライブストリーミングの問題を特定して解決できます。
ApsaraVideo Live コンソールは、ライブストリーム管理、アプリケーション管理、データセンター、およびツールボックスモジュールの構成と使用法を提供します。詳細については、以下をご参照ください。
FAQ
ライセンス構成で問題が発生した場合は、「ライセンスに関するよくある質問」をご参照ください。
アップストリーミング中に例外が発生した場合は、セルフサービスのトラブルシューティング機能を使用して、アップストリーミング URL が有効かどうかを確認できます。
テクニカルサポート
上記の手順に従っても問題が解決しない場合は、チケットを送信してテクニカルサポートを依頼できます。詳細については、「お問い合わせ」をご参照ください。
テクニカルサポートを求める際は、サポートの効率を向上させるために、次の情報を提供してください。
項目 | 説明 | 注 |
概要 | 発生した問題を 1 文で説明してください | - |
問題の説明 |
|
|
コンテキスト |
|
|
追加情報 |
|
問題の説明に関するガイドライン
標準的な問題のテンプレート
問題のタイトル: (問題の概要を 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
エラーメッセージ: なし
例外からの自動回復: なし、ストリーミングを閉じて再起動する必要がある
その他の注記: 視聴者側にはメッセージなし、ネットワーク/デバイスを切り替えても解決しない