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

:ビデオを再生するための再生URLの取得

最終更新日:Jul 07, 2022

ApsaraVideo VODでは、再生URLを使用してオーディオおよびビデオファイルを再生できます。 トランスコードの完了時に送信されるイベント通知から、または再生URLの取得に使用されるAPIまたはSDKを使用して、再生URLを取得できます。 このトピックでは、再生のプロセス、URLの取得方法、および手順について説明します。

再生プロセス

注意

サーバーにはRAMユーザーのAccessKeyが必要で、再生権限が付与されている必要があります。 詳細については、「概要」をご参照ください。

ApsaraVideo Playerを使用する場合は、「ApsaraVideo Playerの使用」をご参照ください。

再生URLの取得

再生URLは、イベント通知から取得するか、再生URLの取得に使用するAPIまたはSDKを使用して取得できます。

  • イベントの通知

    StreamTranscodeCompleteまたはTranscodeCompleteイベント通知を受信すると、再生URLを取得できます。 イベント通知を自分のサーバーに保存した後、自分のサーバーにアクセスして、オーディオおよびビデオファイルを再生するときに保存された再生URLを取得できます。

    使用法ノート:

    • イベント通知から取得される再生URLは固定URLです。 URL認証が有効になっている場合、認証キー (auth_key) を持つ再生URLを生成する必要があります。 再生URLを生成しないと、ビデオの再生は失敗します。

    • 古いドメイン名が無効または削除されている場合は、保存した再生URLのドメイン名を新しいドメイン名に置き換えます。 ドメイン名を置き換えないと、ビデオの再生は失敗します。

    • ビデオ暗号化が設定されている場合、プレーヤーは返された再生URLを復号してビデオを再生する必要があります。

  • API / SDK

    GetPlayInfo操作を呼び出すか、ApsaraVideo VOD APIまたはSDKを使用して再生URLを取得するには、オーディオファイルまたはビデオファイルをアップロードするときに返されるビデオIDを保持する必要があります。

    呼び出しメソッド:

    • サーバーSDKを使用して、API操作を呼び出してメディアアセット情報を取得することを推奨します。 この方法は簡単で効率的です。 詳細については、「使用状況のメモ」をご参照ください。 APIの詳細については、「各API操作のSDKの例」をご参照ください。

    • HTTPまたはHTTPSリクエストを生成する方法の詳細については、「共通パラメーター」および「」をご参照ください。

    制限:

    • デフォルトでは、GetPlayInfo操作は、各定義および形式で最新のトランスコードされたストリームのみを返し、最新のトランスコードされたストリームが毎回再生されるようにします。 GetPlayInfo操作を呼び出すと、ResultTypeMultipleに設定して、オーディオまたはビデオのすべてのトランスコードされたストリームの再生URLを取得できます。

    • Alibaba Cloudビデオ暗号化モードのビデオが暗号化されている場合、ApsaraVideo Player SDKのみがビデオを再生できます。 デフォルトでは、GetPlayInfo操作を呼び出したときに、Alibaba Cloudビデオ暗号化モードで暗号化されたストリームの再生URLは返されません。 これにより、ビデオのセキュリティが保証されます。 ResultType[Multiple] に設定すると、トランスコードされたすべてのストリームの再生URLを取得できます。

    • デフォルトでは、HLS暗号化モードのビデオが暗号化されている場合、システムはHLS暗号化モードでトランスコードされたストリームの再生URLを優先的に返します。

使用方法

ビデオの再生URLを取得してプレーヤーに送信できます。

  • ApsaraVideo Playerは、再生URLを使用してビデオを直接再生できます。 詳細については、「ApsaraVideo Playerの使用」をご参照ください。

  • システムに組み込まれているプレーヤー、オープンソースプレーヤー、または自社開発のプレーヤーを使用することもできます。