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

ApsaraVideo VOD:ApsaraVideo Player SDK for Web

最終更新日:Mar 06, 2025

ApsaraVideo Player SDK for Web を Web アプリケーションに統合し、SDK を使用してライブストリーミングとビデオのオンデマンド再生を行うことができます。このトピックでは、ApsaraVideo Player SDK for Web の機能とブラウザとの互換性について説明します。

概要

ApsaraVideo Player SDK for Web は、HTML5 プレーヤーの <video> タグを使用して、Web アプリケーションでビデオを再生します。 ApsaraVideo Player SDK for Web は、Chrome や Safari など複数のブラウザと互換性があり、複数のプラットフォームで統一されたビデオ再生効果を提供します。 ApsaraVideo Player SDK for Web は、ホットリンク保護、暗号化ビデオ再生、ApsaraVideo Live と ApsaraVideo VOD に基づく品質監視などの機能もサポートしています。

ライセンスサービスの更新

2024 年 12 月 1 日以降、ApsaraVideo Player SDK for Web 2.28.0 以降を使用するには、ライセンスサービスが必要になります。詳細については、「ライセンスを管理する」をご参照ください。 2.28.0 より前のバージョンは、この変更の影響を受けません。 ただし、より包括的なサービスとサポートを受けるために、最新バージョンにアップグレードすることをお勧めします。

サポートされているプロトコル

VOD シナリオ

次の表に、ApsaraVideo Player SDK for Web でサポートされている再生プロトコルとコーデックを示します。

ビデオコーデック

ビデオプロトコル

オーディオファイル形式

オーディオコーデック

H.264

  • MP4

  • FLV

  • HLS

MP3

AAC

H.265

説明
  • H.265 ビデオを再生するには、Yida でリクエストを送信してライセンスを申請する必要があります。

  • 特定のブラウザでは、H.265 ビデオの再生はサポートされていません。

  • H.265 ビデオの再生を有効にすると、読み込み時間が長くなり、トラフィック消費が増加します。

  • MP4

  • FLV

  • HLS

-

H.266

説明
  • H.266 ビデオを再生するには、Yida でリクエストを送信してライセンスを申請してください。

  • H.266 ビデオは、特定のブラウザではサポートされていません。

  • H.266 ビデオの再生を有効にすると、読み込み時間が長くなり、トラフィック消費が増加します。

MP4

-

ライブストリーミングシナリオ

次の表に、ApsaraVideo Player SDK for Web でサポートされているライブストリーミングプロトコルとコーデックを示します。

ビデオコーデック

ビデオプロトコル

オーディオコーデック

オーディオファイル形式

H.264

HLS、FLV、RTS、および DASH

AAC

-

H.265

HLS および FLV (コーデック ID = 12)

H.266

HLS および FLV

次の表に、各ライブストリーミングプロトコルの利点と制限を示します。

プロトコル

利点

欠点

レイテンシ

HLS

HLS はさまざまなブラウザと互換性があります。

レイテンシが高くなります。

> 10 秒

FLV

FLV は高い同時実行性をサポートしており、ネイティブアプリケーションに適しています。

ブラウザでビデオを再生するには、ApsaraVideo Player SDK for Web との統合が必要です。

1 秒~ 3 秒

RTS

RTS は、ネットワーク状態が悪い場合でも良好に動作します。 30% のパケット損失率でもストリームをスムーズに再生できます。

ブラウザでビデオを再生するには、ApsaraVideo Player SDK for Web との統合が必要です。

< 1 秒

DASH

アダプティブビットレートがサポートされています。

レイテンシが高くなります。

> 10 秒

ブラウザへの適応

PC でサポートされているブラウザ

重要

PC 上のブラウザを使用して FLV または HLS 形式でビデオを再生するには、オリジン間リソース共有 (CORS) を有効にする必要があります。 詳細については、「CORS を構成する」をご参照ください。

ブラウザ

MP4

FLV

HLS

MP3

Chrome

Google Chrome 34 以降

Google Chrome 34 以降

Firefox

Firefox 49 以降

Firefox 49 以降

IE

Internet Explorer 9 以降

  • VOD: Windows 8.1 以降向けの Internet Explorer 11 以降

  • ライブストリーミング: Windows 8.1 以降向けの Internet Explorer 11 以降

重要

Windows 8 以降向けの Internet Explorer 11 では、FLV 形式のビデオストリームを再生できません。 これは、Internet Explorer 11 の flv.js ファイルで mseLiveFlvPlayback の値が false であるためです。

Windows 8.1 以降向けの Internet Explorer 11 以降

Internet Explorer 9 以降

Edge

Opera

Safari

Safari 8 以降

Safari 8 以降

モバイルデバイスでサポートされているブラウザ

説明

ApsaraVideo Player SDK for Web では、モバイルブラウザで FLV 形式のビデオストリームを再生することはできません。

表 1. Android デバイスでサポートされているブラウザ

ブラウザ

HLS

MP4

MP3

FLV

Chrome

Google Chrome 34 以降

×

Firefox

Firefox 49 以降

WeChat

Edge

Opera

表 2. iOS デバイスでサポートされているブラウザ

ブラウザ

HLS

MP4

MP3

FLV

Chrome

Google Chrome 34 以降

×

Firefox

Firefox 49 以降

WeChat

Edge

Opera

Safari

Safari 8 以降

ブラウザでサポートされている機能

機能

PC

モバイルデバイス

参照

フルスクリーン再生

デフォルトでは、フルスクリーン再生機能は無効になっています。

デフォルトでは、フルスクリーン再生機能は有効になっています。 必要に応じて、この機能を無効にすることができます。

説明
  • iOS 10 より前のバージョンの iOS デバイスの Safari では、フルスクリーン再生機能を無効にすることはできません。

  • インラインモードでビデオを再生する場合は、トランスコードされたビデオの解像度に基づいてビデオサイズを変更する必要があります。 そうしないと、黒枠が表示される場合があります。

詳細については、「API 操作」をご参照ください。

自動再生

ApsaraVideo Player SDK for Web によって提供される自動再生機能は、特定のブラウザではサポートされていません。

  • macOS High Sierra 上の Safari 11 以降では、自動再生はサポートされていません。

  • Google Chrome 55 以降では、自動再生はサポートされていません。

デフォルトでは、自動再生は無効になっています。 この機能を有効にするには、特定の設定を行う必要があります。

説明

特定のブラウザと WebView ベースのアプリでは、自動再生が許可されています。 これは、Android デバイスでよく発生します。

詳細については、「自動再生」をご参照ください。

音量調整

サポートされています

iOS および特定の Android システムでは、video.volume プロパティは読み取り専用です。 そのため、ApsaraVideo Player SDK for Web によって提供される getVolume メソッドと setVolume メソッドは、iOS および特定の Android システムでは無効です。

詳細については、「音量を調整する」をご参照ください。

再生速度

サポートされています

Android 向け WeChat ブラウザなど、特定のモバイルブラウザでは再生速度を設定できません。

詳細については、「再生速度を設定する」をご参照ください。

HLS を使用して暗号化されたビデオの再生

  • Chrome

  • FireFox

  • Safari

  • Edge

  • Windows 8.1 以降向けの Internet Explorer 11 以降

サポートされています

詳細については、「ApsaraVideo Player SDK for Web を使用する」をご参照ください。

Alibaba Cloud 専用 HLS 暗号化

説明

セキュリティ上の理由から、Alibaba Cloud 専用の暗号化を使用して暗号化された実際のビデオをデバッグに使用することはできません。

  • Chrome

  • FireFox

  • Safari

  • Edge

  • Windows 8.1 以降向けの Internet Explorer 11 以降

説明

特定のサードパーティ製ブラウザでは、ユーザーの許可または認識なしに ApsaraVideo Player SDK の設定が変更される場合があります。 この場合、Alibaba Cloud 専用の暗号化を使用して暗号化されたビデオは再生できません。 この問題を解決するには、HLS またはデジタル著作権管理 (DRM) 暗号化方式を使用してビデオを暗号化することをお勧めします。

  • この機能は、iOS 14 以降でサポートされています。

    説明

    iOS 17.1 以前のバージョンでこの機能を使用するには、プレーヤープラグインをインストールする必要があります。 詳細については、「暗号化されたビデオを再生する」をご参照ください。

  • この機能は、ほとんどの Android ブラウザでサポートされています。

    説明

    特定のブラウザでは、ユーザーの許可または認識なしに ApsaraVideo Player SDK の設定が変更され、ビデオ再生がハイジャックされる場合があります。 これらのブラウザには、UC、Quark、Baidu、および iOS 17.1 以前のバージョンにおける Wechat、DingTalk、QQ ブラウザが含まれます。 この場合、Alibaba Cloud 専用の暗号化を使用して暗号化されたビデオは再生できません。 ユーザーに他のブラウザでビデオを再生するように指示できます。

詳細については、「ApsaraVideo Player SDK for Web を使用する」をご参照ください。

DRM を使用して暗号化されたライブストリームの再生

Windows

  • Chrome

  • Opera

  • FireFox

  • Edge

macOS

  • Chrome

  • Safari

  • FireFox

  • Opera

  • Edge

iOS

  • Chrome

  • Safari

Android

  • Android 10 以降向けの Google Chrome

  • Edge

詳細については、「ApsaraVideo Player SDK for Web を使用する」をご参照ください。

DRM で暗号化された VOD ファイルの再生

Windows

  • Chrome

  • Opera

  • FireFox

  • Edge

macOS

  • Chrome

  • Safari

  • FireFox

  • Opera

  • Edge

iOS

  • Chrome

  • Safari

Android

  • Android 10 以降向けの Google Chrome

  • Edge