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

:再生に関する共通設定

最終更新日:Jun 25, 2026

ApsaraVideo VOD 再生サービスは、さまざまなシナリオに対応する再生 URL を提供します。ドメイン名設定、トランスコード設定、再生設定を調整することで、取得する再生 URL の種類を制御できます。このトピックでは、共通設定について説明します。

ドメイン名設定

  • ドメイン名の追加

    • アクセラレーションドメイン名の設定:有効な ApsaraVideo VOD ドメイン名に ICP 登録があることを確認してください。詳細については、「ドメイン名の追加基準」をご参照ください。

    • CNAME 名前解決:ドメイン名の CNAME レコードが作成済みであることを確認してください。作成していない場合、再生は失敗します。CNAME レコードを作成するには、「Alibaba Cloud DNS を使用した CNAME レコードの設定」をご参照ください。DNSPod のようなサービスも利用できます。

    • CDN アクセラレーションドメイン名の設定:詳細な手順については、「アクセラレーションドメイン名の追加」をご参照ください。

  • URL 認証設定

    • 有効期限:AuthTimeout パラメーターを使用して、CDN アクセラレーション URL の有効期限を設定できます。URL の有効期限の計算方法については、「URL 認証」の「URL の有効期限」セクションをご参照ください。

    • 二次認証:

      • CDN の二次認証を設定する場合、ReAuthInfo パラメーターを設定して、uid および rand パラメーターを CDN 認証リクエストに追加できます。詳細については、「ReAuthInfo を使用した CDN 二次認証の設定」をご参照ください。

      • CDN の二次認証を設定しない場合、ReAuthInforand パラメーターを使用して、毎回一意の URL を生成できます。たとえば、乱数として UUID を使用できます。詳細については、「ReAuthInfo を使用した CDN 二次認証の設定」をご参照ください。

  • 複数ドメイン名の選択

    オリジンサーバーに複数のドメイン名が設定されている場合、PlayConfig パラメーターの PlayDomain フィールドを設定して、特定の CDN ドメイン名の再生 URL を返すことができます。詳細については、「PlayConfig を使用したメディア再生のカスタマイズ」をご参照ください。

    異なるアクセラレーションドメイン名を使用してさまざまな動画を配信する必要がある場合は、次のいずれかの方法を使用できます。

    • 方法 1:GetPlayInfo API を呼び出す際に、PlayConfig パラメーターの PlayDomain フィールドを使用して、動画ごとに異なるアクセラレーションドメイン名を指定します。たとえば、動画 A には PlayConfig={"PlayDomain":"cdn-a.example.com"} を、動画 B には PlayConfig={"PlayDomain":"cdn-b.example.com"} を設定します。この API は、対応するドメイン名の再生 URL を返します。

    • 方法 2:再生 URL を取得した後、コード内で URL のドメイン名を目的のアクセラレーションドメイン名に置き換えます。たとえば、返された URL の cdn-default.example.comcdn-b.example.com に置き換えます。

    いずれかの方法を使用する前に、[配信とアクセラレーション] > [ドメイン名管理] で複数のアクセラレーションドメイン名を追加し、CNAME 設定を完了してください。

  • HTTPS アクセラレーション

    デフォルトでは、再生 API は HTTP の画像 URL と再生 URL を返します。HTTPS URL を取得するには、CDN ドメイン名で HTTPS アクセラレーションを有効にしてください。詳細な手順については、「HTTPS アクセラレーション」をご参照ください。

トランスコード設定

ApsaraVideo VOD では、アップロードしたメディアファイルをトランスコードするかどうかを選択できます。

  • ファイルをトランスコードする場合、再生サービスはトランスコードされたファイルの再生 URL を返します。形式、画質、暗号化ステータス、ウォーターマーク ID は、トランスコード設定によって異なります。

  • ファイルをトランスコードしない場合、再生サービスはソースビデオとして再生される、アップロードされたソースファイルの再生 URL を返します。MP4、FLV、M3U8、MP3、WEBM 形式のファイルのみが、トランスコードなしで直接再生できます。

詳細については、「トランスコードテンプレート」をご参照ください。

再生設定

再生サービスは、次の 3 つの再生方法をサポートしています。

  • コンソールでのプレビュー:設定は不要です。

  • 再生 URL:GetPlayInfo API を呼び出す際に、さまざまな再生設定を使用して、返される再生 URL をフィルタリングできます。

  • プレーヤー:ApsaraVideo Player SDK で再生設定を構成すると、プレーヤーは自動的に再生 URL をフィルタリングして選択します。

再生 API の設定

ApsaraVideo VOD の GetPlayInfo API を使用すると、さまざまな再生シナリオに合わせて、次の基準で結果をフィルタリングできます。

  • 画質

    Definition パラメーターを使用すると、一度に複数の画質を選択して、ネットワーク状況に応じた画質の切り替えが可能になります。このパラメーターを設定しない場合、再生 API は指定された動画で利用可能なすべての画質の再生 URL を返します。

  • 出力ファイル形式

    Formats パラメーターは、トランスコードされたファイルのコンテナ形式を指定します。現在、MP4MP3M3U8 のみがサポートされています。複数の値を指定できます。

  • 出力ストリームタイプ

    StreamType パラメーターは、ストリームが動画か音声かを指定します。

  • 出力ファイルタイプ

    OutputType パラメーター:

    • CDN アクセラレーションドメイン名を設定しない場合、再生 API はデフォルトで OSS オリジン URL を返します。

    • CDN アクセラレーションドメイン名を設定すると、再生 API はデフォルトで CDN アクセラレーション URL を返します。

    • また、OutputType パラメーターを設定して、OSS オリジン URL または CDN アクセラレーション URL のいずれかを取得することもできます。

  • 出力結果タイプ

    ResultType パラメーター:デフォルトでは、ApsaraVideo VOD は、画質と形式の組み合わせごとに 1 つの再生 URL のみを提供します。すでにトランスコード済みの動画について新しいメディアトランスコードジョブを送信すると、画質と形式の組み合わせごとに複数の再生 URL が作成されます。最新の出力の再生を確実にするため、再生 API はデフォルトで最新のストリームの URL のみを返します。トランスコード済みのすべてのストリームの URL を取得する必要がある場合は、ResultType パラメーターを Multiple に設定します。

    重要

    動画に 100 を超える出力ストリーム URL がある場合、ResultTypeMultiple に設定すると、最大で 100 の出力ストリーム URL が返されます。

プレーヤー設定

ApsaraVideo Player SDK は、再生認証情報を使用して再生 URL を自動的に取得できます。この SDK は、Web (H5 および Flash)、iOS、Android で利用できます。以下のセクションでは、各プラットフォームでサポートされている再生設定について説明します。

  • ApsaraVideo Player SDK for Web

    • H5 プレーヤーでは、出力ストリームタイプ (mediaType)、出力ファイル形式 (format)、画質 (definition) を設定できます。詳細については、「機能」をご参照ください。

    • Flash プレーヤーは、動画ファイルの再生のみをサポートしています。出力ファイル形式 (format) を設定できます。

  • ApsaraVideo Player SDK for iOS

    出力ファイル形式 (format) と優先画質 (quality) を設定できます。

  • ApsaraVideo Player SDK for Android

    出力ファイル形式 (format) と優先画質 (quality) を設定できます。