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

ApsaraVideo VOD:Web 用 ApsaraVideo Player SDK

最終更新日:Nov 09, 2025

Web 用 ApsaraVideo Player SDK を Web アプリケーションに統合できます。このソフトウェア開発キット (SDK) は、ライブストリーミングおよびビデオオンデマンド (VOD) シナリオ向けのビデオ再生機能を提供します。このトピックでは、Web 用 ApsaraVideo Player SDK の機能とブラウザの互換性について説明します。

概要

Web 用 ApsaraVideo Player SDK は、HTML5 (H5) の <video> タグを使用して Web アプリケーションでビデオを再生します。この SDK は、Chrome や Safari などの複数のブラウザと互換性があり、さまざまなプラットフォームで一貫したビデオ再生を保証します。ApsaraVideo Live および ApsaraVideo VOD と併用すると、Web 用 ApsaraVideo Player SDK は、ホットリンク保護、著作権で保護されたビデオの暗号化再生、品質監視などの機能もサポートします。

ライセンスのアップグレード

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

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

VOD シナリオ

次の表に、Web 用 ApsaraVideo Player SDK でサポートされている VOD 再生プロトコルとエンコード形式を示します。

ビデオエンコード形式

ビデオプロトコル

オーディオファイル形式

オーディオコーディング形式

H.264

  • MP4

  • FLV

  • HLS

MP3

AAC

H.265

説明
  • H.265 でエンコードされたビデオストリームを再生するには、まずフォームに記入してライセンスを申請する必要があります。

  • 一部のブラウザは H.265 ビデオの再生をサポートしていません。

  • H.265 ビデオ再生を有効にすると、トラフィック消費量と起動レイテンシーが増加します。

  • MP4

  • FLV

  • HLS

-

H.266

説明
  • H.266 でエンコードされたビデオストリームを再生するには、まずフォームに記入してライセンスを申請する必要があります。

  • 一部のブラウザは H.266 ビデオの再生をサポートしていません。

  • H.266 ビデオ再生を有効にすると、トラフィック消費量と起動レイテンシーが増加します。

MP4

-

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

次の表に、Web 用 ApsaraVideo Player SDK でサポートされているライブストリーミング再生プロトコルとエンコード形式を示します。

ビデオエンコード形式

ビデオプロトコル

オーディオコーディング形式

オーディオファイル形式

H.264

HLS, FLV, RTS, DASH

AAC

-

H.265

HLS, FLV (codecId=12)

H.266

HLS, FLV

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

ライブストリーミングプロトコル

利点

欠点

レイテンシ

HLS

ブラウザの互換性が高い。

レイテンシーが高い。

> 10秒

FLV

高同時実行シナリオをサポートし、ネイティブアプリにより適しています。

再生するには、ブラウザを Web 用 ApsaraVideo Player SDK と統合する必要があります。

1 秒から 3 秒

RTS

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

再生するには、ブラウザを Web 用 ApsaraVideo Player SDK と統合する必要があります。

< 1秒

DASH

アダプティブビットレート。

レイテンシーが高い。

> 10秒

ブラウザの互換性

デスクトップブラウザの互換性

重要

デスクトップブラウザで FLV および HLS ビデオを再生するには、クロスドメインアクセスを有効にする必要があります。

ブラウザ

MP4

FLV

HLS

MP3

Chrome

34 以降

34 以降

Firefox

49 以降

49 以降

Edge

Opera

Safari

8 以降

8 以降

モバイルブラウザの互換性

説明

Web 用 ApsaraVideo Player SDK は、モバイルデバイスでの FLV ビデオ再生をサポートしていません。

表 1. Android での H5 ブラウザの互換性

ブラウザ

HLS

MP4

MP3

FLV

Chrome

34 以降

×

Firefox

49 以降

WeChat

Edge

Opera

表 2. iOS での H5 ブラウザの互換性

ブラウザ

HLS

MP4

MP3

FLV

Chrome

34 以降

×

Firefox

49 以降

WeChat

Edge

Opera

Safari

8 以降

機能の互換性

機能

デスクトップ

モバイル

設定方法

フルスクリーン再生

デフォルトでは、ビデオは全画面で再生されません。

デフォルトでは、ビデオは全画面で再生されます。シナリオごとに異なる設定が必要です。

説明
  • iOS 10 より前のバージョンのデバイスの Safari では、自動全画面再生を無効にすることはできません。

  • 非全画面モードでビデオを再生する場合は、トランスコードされたビデオ解像度の縦横比に基づいてビデオサイズを調整し、黒枠を回避します。

全画面設定

自動再生

この制限は、Web 用 ApsaraVideo Player SDK からではなく、ブラウザからのものです。

  • macOS High Sierra の Safari 11 以降では、自動再生が制限されています。

  • Chrome 55 以降では、自動再生が制限されています。

デフォルトでは無効になっています。有効にするには特別な設定が必要です。

説明

一部のブラウザと WebView では自動再生が許可される場合があります。これは Android システムで一般的です。

自動再生

音量調整

サポートされています

iOS および一部の Android システムでは video.volume プロパティが読み取り専用であるため、Web 用 ApsaraVideo Player SDK が提供する getVolume および setVolume メソッドは iOS および一部の Android システムでは機能しません。

音量調整

再生速度

サポートされています

Android の WeChat など、一部のモバイルブラウザは再生速度の調整をサポートしていません。

再生速度

HLS 標準暗号化ビデオ再生

  • Chrome

  • FireFox

  • Safari

  • Edge

サポートされています

暗号化されたビデオの再生方法

Alibaba Cloud 専用 HLS 暗号化

説明

セキュリティ上の理由から、Alibaba Cloud 専用の暗号化では、実際の暗号化されたビデオを使用したデバッグはサポートされていません。

  • Chrome

  • FireFox

  • Safari

  • Edge

説明

一部のサードパーティ製ブラウザは、プレーヤーを強制的にハイジャックします。これにより、Alibaba Cloud 専用の暗号化が無効になり、再生が失敗します。この場合は、HLS 標準暗号化または DRM 暗号化を使用してください。

  • iOS 14 以降のブラウザでサポートされています。

    説明

    iOS 17.1 より前のバージョンをサポートするには、追加のプレーヤープラグインスクリプトをデプロイする必要があります。このスクリプトは Safari ブラウザにのみ適用されます。WeChat、DingTalk、QQ Browser などの他のブラウザは、システムの制限により使用できません。ユーザーに Safari ブラウザでビデオを再生するように案内できます。詳細については、「iOS 17.1 より前のバージョンでの専用暗号化プラグインのデプロイ手順」をご参照ください。

  • Android プラットフォームのほとんどのブラウザでサポートされています。

    説明

    一部のブラウザはビデオ再生をハイジャックするため、UC Browser、Quark、Baidu などのブラウザは、Alibaba Cloud 専用の暗号化で暗号化されたビデオの再生をサポートしていないことが知られています。ユーザーに他のブラウザでビデオを再生するように案内できます。

暗号化されたビデオの再生方法

DRM 暗号化ライブストリームの再生

Windows

  • Chrome

  • Opera

  • FireFox

  • Edge

macOS

  • Chrome

  • Safari

  • FireFox

  • Opera

  • Edge

iOS

  • Chrome

  • Safari

Android

  • Android 10 以降の Chrome

  • Edge

暗号化されたビデオの再生方法

DRM 暗号化された VOD ストリームの再生

Windows

  • Chrome

  • Opera

  • FireFox

  • Edge

macOS

  • Chrome

  • Safari

  • FireFox

  • Opera

  • Edge

iOS

  • Chrome

  • Safari

Android

  • Android 10 以降の Chrome

  • Edge