ApsaraVideo VOD:プレーヤーの一般的な問題

VOD 再生の失敗

再生は、ストリームエンコーディング、ネットワークエンドポイント、CDN、フォーマット、またはストレージバケットの問題により失敗することがあります。原因を特定するには、プレーヤーのエラーメッセージとネットワークリクエストを確認してください。一般的な問題と解決策は次のとおりです。

• 料金の未払い： アカウントの残高を確認してください。アカウントで料金が未払いの場合、動画は再生できません。

• ネットワーククライアントの問題： 動画の再生に失敗し、エラーコード 4400 が返されます。エラーコード 4400 は、サーバーまたはネットワークの問題によりリソースを読み込めないことを示します。SSL 証明書が設定されているか、また HTTPS 証明書が有効期限切れや無効になっていないかを確認してください。

• フォーマットの問題： 動画フォーマットがプレーヤーと互換性がありません。ApsaraVideo VOD がサポートする再生フォーマットの詳細については、「プレーヤー SDK の機能」をご参照ください。

  説明

  認証付きの M3U8 ファイルを再生するには、カスタムドメイン名を使用する必要があります。ドメイン名を追加するには、「アクセラレーションドメイン名の追加」をご参照ください。

• バケットの問題： 設定されたストレージバケットが無効であるか、プライベートバケットの署名付き URL が期限切れになっています。これにより、再生が失敗します。この問題を解決するには、バケットの URL 署名を無効にし、その権限をパブリック読み取りに設定します。

• クロスドメインの問題： アクセラレーションドメイン名のリージョンが動画の再生リージョンと同じであるかを確認してください。異なる場合、再生は失敗します。新しいアクセラレーションドメイン名を作成するか、元のドメイン名のリージョンを変更することができます。

GetPlayInfo のエラー：無効な動画ステータスまたはレビュー中

再生情報を正常に取得するには、動画のメインステータス (Status) が Normal であり、そのレビューステータス (AuditStatus) が Normal である必要があります。動画のステータスが UploadSucc (アップロードは成功したがトランスコーディングが完了していない) であるか、AuditStatus が Init (レビュー中) である場合、再生情報を取得する前にトランスコーディングが完了し、レビューに合格するのを待つ必要があります。GetVideoInfo API を使用して動画の最新ステータスを照会し、グローバルレビュー設定がレビューの進行に影響を与えていないかを確認することを推奨します。

公開前レビューモードでは、手動レビューに合格したことはコンテンツレビューが完了したことを示すだけで、動画が再生可能になったことを意味するわけではありません。動画は、トランスコーディングが完了し、そのメインステータス (Status) が Normal に変更された後にのみ再生情報を返すことができます。手動レビューは合格したものの、動画が長時間 UploadSucc ステータスのままである場合、トランスコーディングがトリガーされなかったか、完了していません。デフォルトのトランスコーディングテンプレートグループが設定され、デフォルトとして設定されているかを確認するか、ApsaraVideo VOD コンソールで手動でトランスコーディングを開始してください。

ローカル M3U8 動画の再生時のエラー

M3U8 ファイルには、複数の Transport Stream (TS) セグメントが含まれています。ローカル再生の場合、リモート URL はサポートされていないため、これらのセグメントは M3U8 ファイル内で正しい相対パスとともにローカルに存在する必要があります。

M3U8 インデックスファイルとそれに対応する .ts セグメントファイル (例： 000000.ts、000001.ts など) は、同じディレクトリに配置する必要があります。

ローカル M3U8 ファイルは、このディレクトリ構造に従う必要があります。

外部再生の失敗

次の手順で問題をトラブルシューティングします。

1. ApsaraVideo VOD に動画がまだ存在するかどうかを確認します。

2. アクセラレーションドメイン名が追加されているかを確認します。

   • アクセラレーションドメイン名が追加されていない場合： ストレージバケットの権限を確認します。ストレージバケットがプライベートかどうかを確認します。プライベートの場合、認証が必要です。動画を直接再生するには、認証を無効にし、バケットの権限をパブリック読み取りに設定します。バケットの権限をパブリック読み取りに設定すると、セキュリティリスクが生じることにご注意ください。

   • アクセラレーションドメイン名が追加されている場合： 認証が有効になっているかを確認します。有効な場合は、認証の有効期間を延長するか、認証を無効にすることができます。認証を無効にすると、セキュリティリスクが生じることにご注意ください。

ブラウザで DRM 暗号化動画が再生できない問題

ApsaraVideo Player for web を使用した DRM 暗号化された動画の再生は、ブラウザの制限を受けます。サポートされているブラウザの詳細については、「機能の互換性」をご参照ください。

HLS 暗号化のための MtsHlsUriToken

MtsHlsUriToken パラメーターはカスタムパラメーターです。標準的な HLS 暗号化では、暗号化文字列が HLS ストリームに書き込まれた後、復号サーバーのアドレスが M3U8 マニフェストに追加されます。特定のユーザーのみが動画にアクセスできるようにするには、復号サーバーに ID 認証メカニズムが必要です。MtsHlsUriToken パラメーターは、復号サーバーに認証レイヤーを追加します。その後、この認証ロジックに基づいて特別なパラメーターが生成され、復号の検証のために渡されます。

暗号化を設定する際には、MtsHlsUriToken を生成するためのトークン発行サービスを構築する必要があります。詳細については、「HLS 暗号化 - ステップ 4」をご参照ください。

中国本土での英国 (ロンドン) の動画の読み込み遅延

中国本土から英国 (ロンドン) リージョンへのアクセスは、距離が長いため遅くなります。パフォーマンスを向上させるには、アクセラレーションドメイン名を追加し、Global Accelerator を使用します。

中国以外での再生時のアクセス遅延とカクつき

再生中のカクつきは、通常、不安定なネットワークが原因です。カクつきがプレーヤーエラーを引き起こすほど長い場合は、CDN の不安定性に関連している可能性があります。カクつきが頻繁に発生する場合は、ネットワークリクエストを確認してください。ネットワーク速度が動画のビットレートと見合っていない可能性があります。ネットワーク速度を上げるか、ビットレートを下げる必要があります。

OSS 動画の再生中の過剰なリクエスト

ソースビデオに問題がないかを確認します。たとえば、プレーヤーがソースビデオをデコードする際に多数の重複リクエストを送信していないかを確認します。ApsaraVideo VOD のトランスコーディングテンプレートを使用して、再生前に動画をトランスコーディングできます。詳細については、「動画と音声のトランスコーディング」をご参照ください。

画像リソースのダウンロードなしでのプレビュー

ApsaraVideo VOD に保存されている画像をダウンロードせずにプレビューするには、カスタムドメイン名を使用する必要があります。ApsaraVideo VOD にカスタムドメイン名を追加できます。詳細については、「アクセラレーションドメイン名の追加」をご参照ください。

一部のコンピューターで動画再生が失敗し、エラーコード 4400 が表示される

エラーコード 4400 は、サーバーまたはネットワークの問題、あるいはサポートされていないフォーマットのためにリソースを読み込めないことを示します。SSL 証明書が設定されているかを確認してください。

短い再生 URL

動画のストレージバケットの権限がプライベートの場合、その再生 URL には認証文字列が含まれ、長い URL になります。権限がパブリック読み取りまたはパブリック読み書きの場合、再生 URL には認証文字列が含まれず、短い URL になります。ストレージバケットの権限とその変更方法の詳細については、「ストレージバケットの管理」をご参照ください。

HLS 形式の未トランスコーディング動画の再生失敗

ApsaraVideo Player をビデオID (VID) と PlayAuth を使用して使用する場合、トランスコーディングされた動画のみを再生できます。トランスコーディングされていない動画は、URL を使用してのみ再生できます。GetMezzanineInfo API を呼び出してソースビデオの URL を取得するか、ApsaraVideo VOD コンソールにログインして動画の URL を表示できます。

VOD 再生 URL の永続性

動画のストレージバケットの権限がプライベートの場合、その再生 URL は期間限定で有効です。再生 URL 内の auth_key 認証文字列は、設定された有効期限に基づいて変化します。

永続的な再生アドレスを取得するには、動画のストレージバケットの権限をパブリック読み取りまたはパブリック読み書きに変更する必要があります。生成された再生アドレスの ? 文字より前の部分は、無期限に使用できる永続的な再生アドレスです。ストレージバケットの権限とその変更方法の詳細については、「ストレージバケットの管理」をご参照ください。

再生 URL のブラウザへのリダイレクト

再生はブラウザとデバイスのデコード能力に依存するため、ブラウザにリダイレクトされることがあります。

更新された動画が表示されない問題

動画を更新した後、URL を更新して最新のデータを取得する必要があります。ApsaraVideo VOD コンソールで URL を更新するには、「更新とプリフェッチ」をご参照ください。API または SDK を使用して URL を更新するには、「PreloadVodObjectCaches」または「RefreshMediaPlayUrls」をご参照ください。

プレーヤーからのフレームピクセルデータの取得

• ApsaraVideo Player for Android： OnRenderFrameCallback コールバックをリッスンしてピクセルデータを取得できます。

• ApsaraVideo Player for iOS： onRenderingFrame コールバックをリッスンしてピクセルデータを取得できます。

  player.renderingDelegate = self;
  
  #pragma mark CicadaRenderingDelegate
  - (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo{
      if(frameInfo.frameType==Cicada_FrameType_Video){
          // ビデオ
          NSLog(@"receive HW frame:%p pts:%ld foramt %d", frameInfo.video_pixelBuffer, frameInfo.pts, CVPixelBufferGetPixelFormatType(frameInfo.video_pixelBuffer));
  
      } else if (frameInfo.frameType==Cicada_FrameType_Audio){
          // オーディオ
      }
      return NO;
  }

• ApsaraVideo Player for Web： この機能はサポートされていません。

AVI 動画の再生 URL を取得できない

GetPlayInfo API は AVI 形式の動画ストリームの取得をサポートしていません。そのため、この API に依存する SDK は AVI 形式の動画ストリームを取得できません。

ApsaraVideo VOD コンソールで AVI 動画の再生 URL を表示できます。詳細については、「音声または動画ファイルの照会」をご参照ください。

GetPlayInfo エラー：「The video has no stream to play for the request parameter」

次の手順で問題をトラブルシューティングします。

1. メディアアセットのストレージクラスが Standard であることを確認してください。

   デフォルトでは、GetPlayInfo API は Standard ストレージクラスのメディアアセットの再生ストリームのみを返します。他のストレージクラスのメディアアセットの再生ストリームを取得するには、PlayConfig パラメーターの StorageClass パラメーターを All に設定してください。

   StorageClass の他の有効な値には、Standard、IA (低頻度アクセス) 、Archive、ColdArchive、SourceIA (ソース低頻度アクセス) 、SourceArchive (ソースアーカイブ) 、SourceColdArchive (ソースコールドアーカイブ) 、Changing (メディアアセットのステータス変更中) 、および SourceChanging (ソースファイルのステータス変更中) があります。空の値はフィルタリングなしを示します。

2. メディアアセットにトランスコーディングされたストリームがあることを確認してください。

   トランスコーディングされたストリームを取得するには、まず動画と音声のトランスコーディングを実行し、その後 GetPlayInfo API を呼び出す必要があります。ソースストリームの URL を取得するには、「GetMezzanineInfo」をご参照ください。

動画のカクつきを軽減し、キャッシュヒット率を向上させる

URL 署名の設定、コンテンツの更新とプリフェッチ、キャッシングの設定、およびパラメーターのフィルタリングによって、キャッシュヒット率を向上させることができます。

シーク時のカクつき

動画のキーフレームが少なすぎると、プレーヤーがフレームを見つけるために、より大きな動画セグメントをデコードする必要があるため、シークが遅くなります。これによりカクつきが発生します。この場合、動画をトランスコーディングしてキーフレームを追加し、カクつきを軽減できます。トランスコーディングの詳細については、「動画と音声のトランスコーディング」をご参照ください。

エラー 0x200600001 MEDIA_PLAYER_ERROR_CODEC_VIDEO_NOT_SUPPORT

メッセージが vvc plugin not enabled の場合、アプリケーションでプラグインが有効になっていないことを示しています。AliPlayerGlobalSettings.enableCodecPlugin メソッドを呼び出して有効にしてください。

メッセージが vvc plugin not loaded の場合、プラグインが正常に統合されなかったことを示します。プラグインライブラリがプロジェクトに正常にインポートされているかを確認するか、明示的に loadlibrary を呼び出してプラグインが正常にロードされることを確認してください。

エラー 0x50020002 MEDIA_PLAYER_ERROR_CODEC_PREMIUM_INVALID

これは、Professional Edition のライセンスが取得されていないことを示します。H.266 デコーダープラグインは Professional Edition の機能です。Professional Edition のライセンスを取得する方法の詳細については、「ライセンスの管理」をご参照ください。

動画のサムネイルを取得できない

ApsaraVideo VOD コンソールはデフォルトで HTTPS プロトコルを使用します。HTTPS をサポートするリソースのみが直接プレビューされ、スクリーンショットとして表示されます。ブラウザの開発者ツールを開いて、具体的なエラーメッセージを確認することもできます。

手動レビュー中に動画が再生できない

ApsaraVideo VOD には 2 つのレビューモードがあります。レビューモードが「公開前レビュー」に設定されている場合、動画はレビューに合格した後にのみ再生可能になります。2 つのレビューモードは次のとおりです。

• 公開後レビュー： 動画がトランスコーディングされた後、デフォルトで正常とマークされ、直接再生できます。その後、動画を手動でレビューする必要があります。レビュー後に動画がブロックされた場合、再生できなくなります。

• 公開前レビュー： 動画がトランスコーディングされた後、デフォルトでレビュープロセスに入り、「レビュー中」とマークされます。動画は、手動レビューに合格した後にのみ再生可能になります。

VideoID

セキュリティのため、ApsaraVideo VOD はメディアファイルをアップロードする際に、直接の URL の代わりにビデオID (videoID) を提供します。ApsaraVideo VOD OpenAPI を呼び出して videoID を取得することもできます。詳細については、「動画の再生 URL の取得」をご参照ください。

ApsaraVideo VOD に動画をアップロードすると、videoID が取得されます。

ApsaraVideo VOD コンソールで videoID を取得することもできます。手順は次のとおりです。

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

2. 左側のナビゲーションペインの メディアファイル で、[Audio/Video] をクリックします。

3. 動画リストで videoID を取得します。

コンソールから取得した videoID を使用して、ダウンロードと再生をテストできます。ApsaraVideo VOD へのファイルのアップロード方法の詳細については、「アップロード SDK の概要」をご参照ください。

AccessKey ID と AccessKey シークレット

Alibaba Cloud の AccessKey ID と AccessKey シークレットは、Alibaba Cloud API にアクセスするための唯一の認証情報です。AccessKey ID は ID 識別子です。AccessKey シークレットはパスワードのようなものです。決して漏洩させないでください。

認証情報を取得するには：

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

2. 右上隅のプロフィール画像にカーソルを合わせ、ショートカットメニューで [AccessKey Management] をクリックします。

3. [AccessKey] ページで、AccessKey ペアを作成するか、既存の AccessKey ID の AccessKey シークレットを表示します。

PlayKey

playKey (API キー) は、プレーヤー SDK が動画の再生 URL を取得する際に ID を認証するために使用される再生キーです。再生認証は、Alibaba Cloud AccessKey のセキュリティ認証に基づく二次的な認証メカニズムです。これにより、ホットリンクを効果的に防止できます。デフォルトでは、ユーザーが再生に使用する可能性のあるプラットフォームに基づいて、Flash、HTML5、iOS、および Android プラットフォーム用に playKey が提供されます。

キーを取得するには：

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

2. 左側のナビゲーションペインの 設定の管理 で、配信の高速化設定 > ダウンロードの設定 を選択します。セキュアダウンロードモードを有効にします。

3. [Obtain Key] セクションで、一意のアプリ識別子 と 秘密鍵 を入力します。

4. キーを生成してダウンロード をクリックします。

PlayAuth

プレーヤーは 3 つの再生モードをサポートしています。setAuthInfo メソッドで実装される PlayAuth モードは、最も安全で商用利用に推奨されます。

PlayAuth は、videoID、AccessKey ID、AccessKey シークレットなどの情報を含む暗号化された文字列です。ApsaraVideo VOD サービスは、この情報を組み合わせて暗号化します。プレーヤーが PlayAuth を受け取ると、動画を再生できます。

フロー： サーバーが PlayAuth を取得 > サーバーが PlayAuth をクライアントに送信 > 動画再生が完了。

1. PlayAuth の取得： サーバーで、再生認証 SDK (サーバーサイド SDK) を呼び出して、ApsaraVideo VOD サービスから PlayAuth を取得します。

2. 動画再生の完了： プレーヤー SDK は、ビデオ ID と PlayAuth を使用して、ApsaraVideo VOD サービスから動画の再生 URL を取得します。その後、動画ストリームをロードし、デコードして再生します。

Chrome で MP4 ファイルの音声トラックを切り替えられない問題

Chrome は HTMLMediaElement.audioTracks API をサポートしていないため、MP4 ファイル内の音声トラックを切り替えることができません。代わりに M3U8 形式の HLS ストリームを使用してください。ApsaraVideo Player SDK for web は hls.js を使用して、HLS ストリーム内の複数の音声トラックを切り替えます。または、マルチトラックのパッケージングとトランスコーディングを使用して M3U8 ファイルを生成することもできます。

Flutter プレーヤーでの音声トラック切り替え時の動画フリーズ

Flutter プレーヤーが音声トラックを切り替えるとき、音声と動画の同期がずれるのを防ぐために再生バッファをクリアします。バッファのクリーンアップ中に発生するフリーズは想定内の動作です。再生が再開されるまで、アプリケーションの UI にローディングインジケーターを表示してください。

ユーザーによる再生速度の変更を防止する方法

再生速度ボタンを非表示にしても、プレーヤーの UI に影響するだけで、ユーザーがブラウザツールや JavaScript を通じて速度を変更することを防ぐことはできません。

JavaScript の ratechange イベントをリッスンし、変更があるたびに playbackRate プロパティを 1 にリセットしてください。また、setInterval を使用して定期的に playbackRate をチェックし、必要に応じて 1 にリセットしてください。

ミニプログラムでの ApsaraVideo Player SDK for web または DRM の使用可否

WeChat ミニプログラムは、ApsaraVideo Player SDK for web も DRM 暗号化再生もサポートしていません。WeChat ミニプログラムで標準の HLS 暗号化を使用した動画を再生するには、ネイティブの [Video] コンポーネントと自社で構築した復号サービスを使用してください。TikTok ミニプログラムなどの他のミニプログラムは、内蔵のプレーヤーを使用するか、WebView に ApsaraVideo Player SDK for web を統合することができます。

ネイティブ Android video 要素による M3U8 ファイルの再生可否

ほとんどの Android デバイスは、video 要素での HLS 再生をネイティブにサポートしていません。ストリームを MP4 に変換するか、WebView に ApsaraVideo Player SDK for web を統合してください。