ApsaraVideo VOD:ApsaraVideo Player SDK for Web の統合

URL ベースの再生

source パラメーターを、サードパーティサービスまたは ApsaraVideo VOD のメディアファイルの再生 URL に設定します。

ApsaraVideo VOD のメディアファイルの再生 URL を取得するには、GetPlayInfo API を呼び出します。複雑な署名計算を避けるため、ApsaraVideo VOD SDK の統合を推奨します。OpenAPI Explorer で API をお試しください。

var player = new Aliplayer(
  {
    id: "J_prismPlayer",
    source: "<your play URL>", // サードパーティ VOD サービスまたは ApsaraVideo VOD に保存されているメディアファイルの再生 URL。
  },
  function (player) {
    console.log("プレーヤーが作成されました。");
  }
);

VID と PlayAuth に基づく再生

vid をメディア ID に、playauth を再生認証情報に設定します。

1. メディアファイルをアップロードした後、ApsaraVideo VOD コンソールの [メディアファイル] > [オーディオ/ビデオ] でその ID を確認できます。または、SearchMedia API を呼び出します。

2. GetVideoPlayAuth API を呼び出して再生認証情報を取得します。複雑な署名計算を避けるため、ApsaraVideo VOD SDK の統合を推奨します。OpenAPI Explorer で API をお試しください。

VidAuth ベースの再生は、シンプルさとセキュリティの観点から STS よりも推奨されます。比較については、「認証情報方式と STS 方式の比較」をご参照ください。

var player = new Aliplayer(
  {
    id: "J_prismPlayer",
    width: "100%",
    vid: "<your video ID>", // 必須。メディアファイルの ID。例：1e067a2831b641db90d570b6480f****。
    playauth: "<your PlayAuth>", // 必須。再生認証情報。
    // authTimeout: 7200, // 再生 URL の有効期間。単位：秒。この設定は、ApsaraVideo VOD コンソールで設定した有効期間を上書きします。このパラメータを空のままにすると、デフォルト値 7200 が使用されます。有効期間は動画の実際の長さよりも長くする必要があります。そうしないと、再生が完了する前に再生 URL の有効期限が切れます。
  },
  function (player) {
    console.log("プレーヤーが作成されました。");
  }
);

STS に基づく再生

STS ベースの再生では、再生認証情報の代わりに一時的な STS トークンを使用します。AssumeRole API を呼び出して STS トークンを取得します。詳細については、「STS トークンの取得」をご参照ください。

var player = new Aliplayer(
  {
    id: "J_prismPlayer",
    width: "100%",
    vid: "<your video ID>", // 必須。オーディオまたはビデオファイルをアップロードした後、ApsaraVideo VOD コンソールにログインし、[メディアファイル] > [オーディオ/ビデオ] を選択してオーディオまたはビデオファイルの ID を確認できます。または、ApsaraVideo VOD SDK が提供する SearchMedia API を呼び出して ID を取得できます。例：1e067a2831b641db90d570b6480f****。
    accessKeyId: "<your AccessKey ID>", // 必須。一時 STS トークンの生成時に返される AccessKey ID。
    securityToken: "<your STS token>", // 必須。STS トークン。STS トークンを取得するには、AssumeRole API を呼び出します。
    accessKeySecret: "<your AccessKey Secret>", // 必須。一時 STS トークンの生成時に返される AccessKey Secret。
    region: "<region of your video>", // 必須。メディアアセットがあるリージョンの ID (cn-shanghai、eu-central-1、ap-southeast-1 など) 。
    // authTimeout: 7200, // 再生 URL の有効期間。単位：秒。この設定は、ApsaraVideo VOD コンソールで設定した有効期間を上書きします。このパラメータを空のままにすると、デフォルト値 7200 が使用されます。有効期間は動画の実際の長さよりも長くする必要があります。そうしないと、再生が完了する前に再生 URL の有効期限が切れます。
  },
  function (player) {
    console.log("プレーヤーが作成されました。");
  }
);

STS を使用してプレーヤーを初期化すると、ApsaraVideo Player SDK は GetPlayInfo リクエストを vod.{region}.aliyuncs.com に送信して再生 URL を取得します。ネットワークがこのドメインにアクセスできない場合 (例：イントラネット環境) 、リクエストがタイムアウトまたは失敗し、初期化コールバック関数が呼び出されず、「プレーヤーが作成されました。」 がコンソールに出力されません。ネットワークが vod.{region}.aliyuncs.com および CDN アクセラレーションドメイン名にアクセスできることを確認してください。

暗号化再生

ApsaraVideo VOD は、Alibaba Cloud 独自の暗号化と DRM 暗号化に対応しています。「Web ブラウザで暗号化された動画を再生する」をご参照ください。

URL ベースのライブストリーミング

source をストリーミング URL に、isLive を true に設定します。

ストリーミング URL は、サードパーティサービスまたは ApsaraVideo Live から取得できます。ApsaraVideo Live コンソールの「URL ジェネレータ」を使用して URL を生成します。

var player = new Aliplayer(
  {
    id: "J_prismPlayer",
    source: "<your play URL>", // ストリーミング URL は、サードパーティのストリーミング URL または ApsaraVideo Live で生成されたストリーミング URL です。
    isLive: true, // ライブストリームを再生するかどうかを指定します。
  },
  function (player) {
    console.log("プレーヤーが作成されました。");
  }
);

DRM 暗号化ライブストリーミング

DRM 暗号化ライブストリーミングについては、「暗号化された動画の再生」をご参照ください。