ApsaraVideo VOD:さまざまなプラットフォーム上のプレーヤーに関する一般的な FAQ

ApsaraVideo VOD 動画の再生失敗をトラブルシューティングする方法

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

• 支払い遅延: アカウントの残高を確認してください。アカウントに支払い遅延がある場合、動画は再生できません。

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

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

  説明

  認証付きの M3U8 ファイルを再生するには、カスタムドメイン名を使用する必要があります。ドメイン名をアタッチするには、「高速化ドメイン名の追加」をご参照ください。

• バケットの問題: 指定されたバケットが無効であるか、非公開バケットの認証が期限切れになっています。これにより再生が失敗します。これを解決するには、バケット認証を無効にし、バケットの権限を公開読み取りに設定します。

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

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

M3U8 ファイルには複数の TS シャードが含まれています。これらのシャードはローカルに存在する必要があります。M3U8 ファイル内のパスは、これらの TS ファイルの正しい場所を指している必要があります。そうでない場合、ファイルは読み込めません。シャードがリンクとして指定されている場合、再生はサポートされません。

次の図は、

ローカル M3U8 ファイルは、前の図に示されているフォーマットである必要があります。

ApsaraVideo VOD 動画が自分のサイトでは正しく再生されるが、外部で共有して再生できない

次のように問題をトラブルシューティングできます。

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

2. 高速化ドメイン名が追加されているかどうかを確認します。

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

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

DRM 暗号化された動画がブラウザで再生できない

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

HLS 暗号化動画の再生に必要な MtsHlsUriToken パラメーターとは何ですか、またどのように取得しますか？

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

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

英国 (ロンドン) リージョンの OSS にアップロードされた動画が中国本土で遅く読み込まれる

中国本土から英国 (ロンドン) リージョンへのアクセスは、リージョン間のアクセスです。高速化ドメイン名を追加し、Global Accelerator を使用することができます。

中国国外で ApsaraVideo VOD 動画を再生する際のアクセス遅延と頻繁なスタッタリングを解決する方法

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

OSS に保存されている特定の動画を再生する際に多くのリクエストが送信される場合はどうすればよいですか？

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

ApsaraVideo VOD のイメージリソースをダウンロードせずに、リンクを使用して直接プレビューするにはどうすればよいですか？

ApsaraVideo VOD に保存されているイメージは、カスタムドメイン名を使用している場合にのみプレビューできます。デフォルトのドメイン名でアクセスすると、イメージは強制的にダウンロードされます。ApsaraVideo VOD にカスタムドメイン名を追加できます。詳細については、「高速化ドメイン名の追加」をご参照ください。

一部のコンピューターで動画が再生できず、エラーコード 4400 が報告される

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

ApsaraVideo VOD に保存されている動画の短い再生 URL を生成する方法

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

トランスコーディングフォーマットを HLS に設定した後、トランスコーディングされていない動画を再生できないのはなぜですか？

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

ApsaraVideo VOD に保存されている動画の再生 URL は固定ですか？

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

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

動画を ApsaraVideo VOD にアップロードした後、URL を Taobao などのプラットフォームに送信すると、なぜ再生のためにブラウザにリダイレクトされるのですか？

動画の再生は、ブラウザとローカルデバイスのデコード能力に依存します。そのため、通常は再生のためにブラウザにリダイレクトされます。

動画を更新した後、再生中に新しい動画が表示されないのはなぜですか？

動画を更新した後、最新のデータを取得するために 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: この機能はサポートされていません。

API または SDK を使用して ApsaraVideo VOD で AVI 動画の再生 URL を取得できないのはなぜですか？

GetPlayInfo 操作は、AVI フォーマットの動画ストリームの取得をサポートしていません。したがって、この操作に依存する SDK は、AVI フォーマットの動画ストリームを取得できません。

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

GetPlayInfo 操作が動画再生 URL を取得する際に「The video has no stream to play for the request parameter」というエラーを報告します

次のように問題をトラブルシューティングできます。

1. メディアアセットのストレージクラスが標準であることを確認します。

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

   

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

   トランスコーディングされたストリームを取得するには、まず 動画と音声のトランスコーディング を実行してから GetPlayInfo 操作を呼び出す必要があります。ソースストリームの 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 から動画のサムネイルを取得できませんでした

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

ApsaraVideo VOD での手動レビュー中に動画を再生できない

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

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

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

videoID とは何か、なぜ必要なのか、どうすれば取得できるのか？

セキュリティ上の理由から、メディアファイルを ApsaraVideo VOD にアップロードすると、ファイルの videoID (videoID) を受け取りますが、URL は受け取りません。ApsaraVideo VOD OpenAPI を呼び出して videoID を取得することもできます。詳細については、「動画再生 URL の取得」をご参照ください。

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

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

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

2. 左側のナビゲーションウィンドウで、[メディアライブラリ] > [オーディオ/ビデオ] を選択します。

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

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

AccessKey ID と AccessKey Secret とは何か、どうすれば取得できるのか？

Alibaba Cloud の AccessKey ID と AccessKey Secret は、Alibaba Cloud API にアクセスするための唯一の認証情報です。AccessKey ID は ID 識別子です。AccessKey Secret は、改ざんを防ぐためにアクセスパラメーターに署名するために使用されます。AccessKey Secret はログインパスワードに似ています。誰にも開示しないでください。

取得操作:

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

2. 右上隅のプロファイル画像にマウスポインターを合わせ、ショートカットメニューで [AccessKey の管理] をクリックします。

3. [AccessKey の管理] ページで、AccessKey ペアを作成するか、既存の AccessKey ID の AccessKey Secret を表示します。

playKey とは何か、どうすれば取得できるのか？

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

取得操作:

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

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

3. [キーの取得] セクションで、[一意のアプリ ID] と [オフライン復号秘密鍵] を入力します。

4. [キーの生成とダウンロード] をクリックします。

playauth とは何か、どうすれば取得できるのか？

プレーヤーは、さまざまなシナリオに合わせて 3 つの再生モードをサポートしています。playauth モードが最も安全です。setAuthInfo 再生モードを使用してください。

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

フロー: [サーバーが再生認証情報を取得] > [サーバーが再生認証情報をクライアントに送信] > [動画再生が完了]。

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

2. 動画再生の完了: プレーヤー SDK は、動画 ID と再生認証情報を使用して、ApsaraVideo VOD サービスから動画の再生 URL を取得します。その後、動画ストリームを読み込み、デコードして再生します。