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

ApsaraVideo VOD:メディア再生

最終更新日:Feb 13, 2026

ApsaraVideo VOD は、セキュアで安定したメディア再生機能をアプリケーションに迅速に追加するのに役立ちます。再生認証情報、URL 署名、ビデオ暗号化などを含む完全なセキュリティシステムを提供します。また、ApsaraVideo VOD はクロスプラットフォームの SDK も提供しており、ビデオ再生を迅速に実装し、開発コストを削減するのに役立ちます。このトピックでは、メディア再生の仕組み、再生 URL、再生方法、および再生セキュリティについて説明します。

仕組み

オーディオまたはビデオファイルが再生可能かどうかは、その ステータスによって決まります。ステータスが Normal の動画(Status フィールドの値が Normal)のみが再生可能です。これらの動画の再生用 URL は、ApsaraVideo VOD API または SDK を使用して取得できます。

説明

審査中またはブロック済み状態の動画は、ApsaraVideo VOD コンソールでのみプレビューできるか、設定された審査セキュリティ IP アドレスからのみアクセスできます。

以下の図は、アップロードから再生までの動画のステータス変更を示しています。

  • トランスコーディングあり

    image
  • トランスコーディングなし

    image

したがって、再生 URL を取得する前に、動画のステータスが Normal であることを確認する必要があります。

判定方法

動画をアップロードした後、すぐに再生できるわけではありません。ApsaraVideo VOD はまず動画が受信されたことを確認する必要があります。アップロードされた動画がいつ再生可能になるかを判断するには、イベント通知を使用します。

  • トランスコーディングされない動画または音声ファイルは、動画アップロード完了のイベント通知を受信した後に再生できます。その後、GetPlayInfo 操作を呼び出して再生 URL を取得できます。トランスコーディングなしで直接再生できるのは、次のフォーマットのファイルのみです:MP4、FLV、M3U8、MP3、WEBM。

  • トランスコーディングされた動画は、単一解像度トランスコーディング完了のイベント通知を受信した後に再生できます。すべての解像度が利用可能であることを確認するには、動画を処理する前に トランスコーディング完了のイベント通知を待ってください。

前提条件

  • 高速化ドメイン名の設定詳細については、「ドメイン名の要件」をご参照ください。

  • ドメイン名の CNAME レコードの解決:ドメイン名に CNAME レコードをアタッチしていることを確認してください。そうしないと、再生が失敗します。詳細については、「Alibaba Cloud DNS で CNAME レコードを設定する」または「DNSPod で CNAME レコードを設定する」をご参照ください。

  • トランスコーディング設定の確認:ApsaraVideo VOD は、アップロードしたメディアファイルをトランスコーディングするか、トランスコーディングしないかを選択できます。詳細については、「音声と動画のトランスコーディング」をご参照ください。

  • セキュリティ設定の確認:ApsaraVideo VOD は、動画コンテンツを保護するために複数のセキュリティ機能を提供します。これらには、アクセス制御、URL 署名リモート認証ビデオ暗号化セキュアダウンロードが含まれます。これらのセキュリティ設定によって、動画が再生できるかどうかが決まります。詳細については、「ビデオセキュリティ」をご参照ください。

再生 URL

  • 高速化ドメイン名の設定

    ApsaraVideo VOD コンソールで高速化ドメイン名を設定すると、再生 URL は CDN ファイル URL になります。URL は、コンソールの [音声/動画] > [管理] > [動画 URL] ページで確認できます。再生 URL は、固定または動的にすることができます。これは、ドメイン名管理で URL 署名を有効にするかどうかによって決まります。URL 署名を有効にして設定する方法については、「URL 署名」をご参照ください。

    • 固定アドレス

      セキュリティ要件が低いシナリオに適しており、アドレスは永続的に有効です。つまり、認証スイッチを無効化した後に認証情報を含まないアドレス(URL 内の auth_key パラメーターの値が認証情報です)。デフォルトでは、ドメイン名をコンソールに追加すると、認証スイッチは無効化されます。

    • 動的アドレス

      動的 URL は、セキュリティ要件が高いシナリオに適しています。動的 URL は動的に生成され、特定の期間が経過すると有効期限切れになります。動的 URL のデフォルトの有効期間は、URL 署名で設定した デフォルトの有効期間 です。また、「再生用 URL の生成」または「動画再生用 URL の取得」を行う際に、有効期限を設定することもできます。URL の有効期限が切れた場合、Alibaba Cloud CDN はアクセス時に HTTP 403 を返します。

      動的 URL の例:

      http://example.aliyundoc.com/video/aliyun-sample.mp4?auth_key=1500523200-0-0-80cd3862d699b7118eed99103f2a****
      説明

      この例では、auth_key パラメーターの値は 1500523200 で始まります。これは、2017 年 7 月 20 日 12:00:00 に対応します。[デフォルトの有効期間] が 60 分に設定されている場合、URL は 2017 年 7 月 20 日 13:00:00 に有効期限が切れます。

  • 高速化ドメイン名が設定されていない場合

    • 高速化ドメイン名が設定されていない場合、返される再生用URLはOSSファイルのURLになります。この場合、URL署名は利用できませんが、OSS認証情報はデフォルトで生成されます。詳細については、「OSS - URLに署名を含める」をご参照ください。動画再生用URLを取得するために「動画再生用URLの取得」API を呼び出す場合、AuthTimeout パラメーターを使用して動画のOSS URLの生存時間 (TTL) を指定できますが、AccessKey に基づいて認証情報をカスタマイズすることはできません。

    • コンソールの[ストレージ管理]ページでストレージBucket公開読み取りに設定すると、OSS 認証情報を無視できます(詳細については、「ストレージ管理」をご参照ください)。この場合、URL は永続的に有効になりますが、ホットリンクや不正ダウンロードのリスクがあります。したがって、ストレージBucketは可能な限り非公開に設定する必要があります。

再生 URL の一般的な設定に関する詳細については、「一般的な再生設定」をご参照ください。

再生 URL は、次のいずれかの方法で取得できます:

  • 直接:トランスコーディング完了後のイベント通知を表示するか、GetPlayInfo 操作を呼び出します。

  • 再生認証情報の使用:ApsaraVideo Player SDK を使用し、GetVideoPlayAuth 操作を呼び出して再生認証情報を取得します。ApsaraVideo Player SDK は、その認証情報を自動的に使用して再生 URL を取得します。

再生方法

  • ApsaraVideo VOD コンソールでのプレビュー

    ApsaraVideo VOD のプレビュープレーヤーは、早送り、音量コントロール、字幕、音声トラック、解像度切り替え、弾幕などの機能を提供します。これらの機能により、動画を簡単にプレビューできます。预览视频

    • コンソールの 音声/動画 ページで、プレビューする動画を選択します。暗号化ストリームはデフォルトで再生されます。

    • コンソールの [音声/動画] > [管理] > [動画 URL] ページで、プレビューするストリームを選択します。ビデオセキュリティを確保するため、暗号化されていないストリームのみプレビューできます。

  • ApsaraVideo Player SDK の統合

    • サーバーから再生認証情報を取得し、再生のためにクライアントに送信します。この方法は高いセキュリティを提供します。詳細については、「再生認証情報の取得」をご参照ください。

    • ApsaraVideo Player は URL ベースの再生をサポートしています。取得した再生 URL を直接プレーヤーに渡すことができます。詳細については、「再生 URL を使用した動画の再生」をご参照ください。

  • サードパーティ製プレーヤーの統合

    • サードパーティ製プレーヤーを統合して、再生 URL を使用して動画を再生します。

    • 再生 URL を取得した後、それをプレーヤーに渡します。この方法は柔軟ですが、解像度切り替えや例外処理などの機能を実装する必要があります。

再生セキュリティ (再生とダウンロードの制限)

  • ビデオセキュリティ

    動画コンテンツを保護するため、ApsaraVideo VOD は複数のセキュリティ機能を提供します。これらには、ブラックリストとホワイトリストURL 署名、およびビデオ暗号化 (Alibaba Cloud 専用の暗号化HLS 暗号化) が含まれます。詳細については、「ビデオセキュリティの概要」をご参照ください。

  • アカウントのセキュリティ

    アカウントのセキュリティを確保するため、クライアント、特に Web クライアントで Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ペアを使用して ApsaraVideo VOD にアクセスしないでください。詳細については、「概要」をご参照ください。

課金に関する説明

  • 高速化ドメイン名を設定した場合、音声または動画ファイルが再生されるとCDN サービスに対して課金されます。

  • 高速化ドメイン名を設定しない場合、音声または動画ファイルが再生されるとストレージからのアウトバウンドトラフィックに対して課金されます。

詳細については、「基本サービスの課金」をご参照ください。

よくある質問

動画の再生失敗のトラブルシューティング方法は?

  1. ネットワークの確認:クライアントが正常なネットワーク接続を持っていることを確認します。

  2. 動画のステータスを確認します。「音声および動画の再生 URL の取得」API を呼び出すか、コンソールで動画のステータスが Normal であることを確認します。

  3. 再生 URL または認証情報を確認します: auth_key が期限切れになっていないか、または署名が有効であるかを確認してください。

  4. プレーヤーの確認:プレーヤーが動画フォーマットをサポートしていることを確認します。ApsaraVideo Player がサポートするフォーマットについては、「ApsaraVideo Player SDK の機能」をご参照ください。

その他のエラーのトラブルシューティングに関する詳細については、「再生エラーのトラブルシューティング」をご参照ください。

暗号化された動画を再生するにはどうすればよいですか?

ApsaraVideo VOD は、Alibaba Cloud 専用の暗号化や HLS 暗号化など、複数の暗号化方法を提供しています。暗号化を使用するには、暗号化トランスコーディングテンプレートグループを設定して動画をトランスコーディングします。その後、ApsaraVideo Player SDK を使用して動画を復号化し、再生します。詳細については、「ビデオ暗号化」をご参照ください。