ApsaraVideo Player SDK for Webの概要 - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

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

概要

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

説明

Flash Playerはサービス停止であり、主流のブラウザではサポートされていません。 Internet ExplorerまたはHTML5プレーヤーをサポートしていないブラウザを使用している場合は、Flashプレーヤーを使用できます。

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

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

対応プロトコル

VODシナリオ

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

プレイヤー	ビデオコーデック	ビデオプロトコル	オーディオコーデック	オーディオファイル形式
H5	H.264	MP4 FLV HLS	AAC	MP3
	H.265 説明 H.265ビデオを再生したい場合は、Yidaでリクエストを送信してライセンスを申請する必要があります。特定のブラウザはH.265ビデオの再生をサポートしていません。 H.265ビデオの再生を有効にすると、読み込み時間が延長され、トラフィック消費が増加します。	MP4 FLV HLS	AAC	-
	H.266 説明 H.266ビデオを再生する場合は、Yidaにリクエストを送信してライセンスを申請してください。 H.266ビデオは特定のブラウザではサポートされません。 H.266ビデオの再生を有効にすると、読み込み時間が延長され、トラフィック消費が増加します。	MP4	AAC	-
Flash player (更新停止)	H.264	MP4 FLV HLS RTMP	AAC MP3	MP3

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

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

ビデオコーデック	ビデオプロトコル	オーディオコーデック	オーディオファイル形式
H.264	HLS、FLV、RTS、およびダッシュ	AAC	-
H.265	HLSおよびFLV (コーデックID = 12)	AAC	-
H.266	HLSおよびFLV	AAC	-

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

プロトコル	メリット	デメリット	レイテンシ
HLS	HLSはさまざまなブラウザと互換性があります。	レイテンシが高い。	> 10s
FLV	FLVは高い同時実行性をサポートし、ネイティブアプリケーションに適しています。	ブラウザでビデオを再生するには、ApsaraVideo Player SDK for Webとの統合が必要です。	1s ~ 3s
RTS	RTSは、劣悪なネットワーク条件下で良好に機能する。パケットロス率30% でもスムーズにストリームを再生できます。	ブラウザでビデオを再生するには、ApsaraVideo Player SDK for Webとの統合が必要です。	<1s
ダッシュ	適応ビットレートがサポートされています。	レイテンシが高い。	> 10s

HTML5プレーヤーでサポートされているブラウザ

説明

HTML5プレーヤーは、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以降重要 Internet Explorer 11 for Windows 8以降では、FLV形式のビデオストリームを再生することはできません。これは、Internet Explorer 11のflv.jsファイルで`mseLiveFlvPlayback`の値がfalseであるためです。	Windows 8.1以降のInternet Explorer 11以降	Internet Explorer 9以降
Edge	✓	✓	✓	✓
Opera	✓	✓	✓	✓
Safari	✓	サファリ8以降	サファリ8以降	✓

サポートされているモバイルデバイス

説明

ApsaraVideo Player SDK for Webでは、モバイルブラウザーでHTML5プレーヤーを使用してFLVビデオを再生することはできません。

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

ブラウザ	MP4	FLV	HLS	MP3
Chrome	✓	×	Google Chrome 34以降	✓
Firefox	✓	×	Firefox 49以降	✓
WeChat	✓	×	✓	✓
Edge	✓	×	✓	✓
Opera	✓	×	✓	✓

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

ブラウザ	MP4	FLV	HLS	MP3
Chrome	✓	×	Google Chrome 34以降	✓
Firefox	✓	×	Firefox 49以降	✓
WeChat	✓	×	✓	✓
Edge	✓	×	✓	✓
Opera	✓	×	✓	✓
Safari	✓	×	サファリ8以降	✓

ブラウザでサポートされているHTML5プレーヤーの機能

機能	PC	モバイルデバイス	関連ドキュメント
フルスクリーン再生	デフォルトでは、フルスクリーン再生機能は無効になっています。	デフォルトでは、フルスクリーン再生機能が有効になっています。必要に応じて機能を無効にできます。説明 iOS 10より前のバージョンのiOSデバイスのSafariでは、フルスクリーン再生機能を無効にすることはできません。インラインモードでビデオを再生する場合は、トランスコードされたビデオの解像度に基づいてビデオサイズを変更する必要があります。そうでなければ、黒いバーが表示され得る。	高度な機能
自動再生	ApsaraVideo Player SDK for Webが提供する自動再生機能は、特定のブラウザではサポートされていません。 macOS High SierraのSafari 11以降では自動再生はサポートされていません。自動再生はGoogle Chrome 55以降ではサポートされていません。	デフォルトでは、自動再生は無効になっています。この機能を有効にするには、特定の設定を行う必要があります。説明特定のブラウザとWebViewベースのアプリで自動再生が可能です。これは一般的にAndroidデバイスで発生します。	高度な機能
音量調整	対応	`video.volume`プロパティは、iOSおよび特定のAndroidシステムでは読み取り専用です。したがって、ApsaraVideo Player SDK for Webが提供する`getVolume`および`setVolume`メソッドは、iOSおよび特定のAndroidシステムでは無効です。	基本機能
再生速度	対応	Android用のWeChatブラウザを含む特定のモバイルブラウザでは再生速度を設定できません。	基本機能
HLSによる暗号化ビデオの再生	Chrome ファイヤーフォックス Safari Edge Windows 8.1以降のInternet Explorer 11以降	対応	暗号化されたビデオを再生する
Alibaba Cloud独自の暗号化を使用して暗号化されたビデオの再生説明セキュリティ上の理由から、Alibaba Cloud独自の暗号化を使用して暗号化された実際のビデオをデバッグに使用することはできません。	Google Chrome (推奨) ファイヤーフォックス Safari Edge Windows 8.1以降のInternet Explorer 11以降説明特定のサードパーティブラウザは、お客様の権限や知識なしにApsaraVideo Player SDKの設定を変更する場合があります。この場合、Alibaba Cloud独自の暗号を使用して暗号化されたビデオは再生できません。この問題を解決するには、HLSまたはデジタル著作権管理 (DRM) 暗号化方式を使用してビデオを暗号化することを推奨します。	この機能はiOS 14以降でサポートされています。説明 iOS 17.1以前のバージョンでこの機能を使用するには、プレーヤープラグインをインストールする必要があります。詳細については、「暗号化ビデオの再生」をご参照ください。この機能は、ほとんどのAndroidブラウザでサポートされています。説明特定のブラウザは、ユーザーの許可や知識なしにApsaraVideo Player SDKの設定を変更し、ビデオ再生をハイジャックする場合があります。ブラウザには、iOS 17.1以前のバージョンのUC、Quark、Baidu、Wechat、DingTalk、QQ Browserが含まれます。この場合、Alibaba Cloud独自の暗号を使用して暗号化されたビデオは再生できません。他のブラウザでビデオを再生するようにユーザーに指示できます。
DRMを使用して暗号化されたライブストリームの再生	Windows Chrome Opera ファイヤーフォックス Edge macOS Chrome Safari ファイヤーフォックス Opera Edge	iOS Chrome Safari アンドロイド Android 10以降のGoogle Chrome Edge
DRM暗号化されたVODファイルの再生	Windows Chrome Opera ファイヤーフォックス Edge macOS Chrome Safari ファイヤーフォックス Opera Edge	iOS Chrome Safari アンドロイド Android 10以降のGoogle Chrome Edge

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

FlashプレーヤーはPCブラウザでのみサポートされています。次の表に、特定のブラウザーでFlashプレーヤーで再生できるさまざまな形式のビデオを示します。

説明

Internet Explorer 8でFlash playerを使用するには、ブラウザでjson.min.jsファイルへの参照を追加する必要があります。詳細については、「クイック統合」をご参照ください。

ブラウザ	MP4	FLV	HLS	RTMP	MP3
Chrome	✓	✓	✓	✓	✓
Firefox	✓	✓	✓	✓	✓
IE	Internet Explorer 8以降	Internet Explorer 8以降	Internet Explorer 8以降	Internet Explorer 8以降	Internet Explorer 8以降
Edge	✓	✓	✓	✓	✓
Opera	✓	✓	✓	✓	✓
Safari	✓	✓	✓	✓	✓

バージョンの状態と技術サポートポリシー

ユーザーエクスペリエンスを最適化するために、ApsaraVideo PlayerはプレーヤーSDKを更新し続け、新機能をリリースし、プレーヤーのパフォーマンスを向上させ、問題を修正します。 ApsaraVideo VODは、バージョン更新中にAPIの互換性を大幅に維持します。再生エクスペリエンスを向上させるために、できるだけ早い機会にプレーヤーSDKを最新バージョンに更新することをお勧めします。

ApsaraVideo Player SDKのバージョンは、リリース日に基づいて、推奨、サポート対象、非推奨、サポート対象外の4つの状態に分類されます。 ApsaraVideo VODは、さまざまな州のプレーヤーSDKに対してさまざまな技術サポートサービスを提供します。

ApsaraVideo Player SDK For Webのバージョンの詳細については、「ApsaraVideo Player SDK for Webのリリースノート」をご参照ください。次の表に、ApsaraVideo Player SDK for Webのバージョン状態とテクニカルサポートポリシーを示します。

バージョン状態	分類	説明
推奨推奨	最新バージョン。	最新バージョンには、最新の機能とバグ修正が含まれています。プレーヤーSDKを最新バージョンに更新することを推奨します。 ApsaraVideo VODは、最新バージョンのplayer SDKの包括的なテクニカルサポートを提供します。
対応サポート	最新バージョンの6か月前にリリースされたバージョン。	これらのバージョンには比較的新しい機能が含まれており、主要な問題を修正します。 ApsaraVideo VODは、これらのバージョンのプレーヤーSDKの一般的なテクニカルサポートを提供します。
推奨されない落ち込んだ	最新バージョンの6〜12か月前にリリースされたバージョン。	これらのバージョンには、推奨されない機能、根本的な問題、またはブラウザの更新によって引き起こされる未知の問題が含まれる場合があります。 ApsaraVideo VODは、これらのバージョンのプレーヤーSDKの一般的な技術サポートを提供しますが、トラブルシューティングの効率や正確性を保証することはできません。プレーヤーSDKを最新バージョンに更新することを推奨します。新機能とバグ修正に加えて、新しいバージョンはトラブルシューティングを最適化します。これにより、自己トラブルシューティングとテクニカルサポートの効率が向上します。
サポートされていない未サポート	最新バージョンの12か月以上前にリリースされたバージョン。	これらのバージョンの機能はおそらく廃止され、現在のブラウザ環境に基づいて最適化は実行されません。これらのバージョンのプレーヤーSDKを本番環境に使用しないことを推奨します。 ApsaraVideo VODは、重大な問題が発生しない限り、これらのバージョンのテクニカルサポートを提供しません。できるだけ早い機会に、プレーヤーSDKを最新バージョンに更新することをお勧めします。