阿里雲Web播放器SDK簡介 - ApsaraVideo VOD

阿里雲Web播放器SDK可以被業務方的Web應用整合，提供直播、點播情境的視頻播放能力。本文為您介紹阿里雲Web播放器SDK的功能說明和瀏覽器適配情況。

概述

阿里雲Web播放器SDK通過HTML5（以下簡稱為H5）的<video>標籤以及Flash在Web應用中實現視頻播放。可以相容 Chrome、Safari等多種瀏覽器，提供多平台統一視頻播放效果，並結合阿里雲ApsaraVideo for Live、ApsaraVideo for VOD，提供防盜鏈和著作權視頻加密播放、品質監測等功能。

說明

由於Flash Player已停止服務，主流瀏覽器均不支援Flash播放。在Internet Explorer及其他不支援H5播放的瀏覽器下使用需要切換至Flash模式。

License升級說明

自2024年12月1日起，阿里雲Web播放器SDK（2.28.0版本開始）的整合使用需要接入License服務，接入請參見管理License。如果您使用的是2.28.0之前的版本，雖然不受此次變更影響，但我們建議您升級到最新版，以享受更全面的服務和支援。

協議支援

點播情境

Web播放器SDK支援的點播播放協議及編碼格式如下：

播放模式	視頻編碼格式	視頻協議	音頻編碼格式	音頻檔案格式
H5	H.264	MP4 FLV HLS	AAC	MP3
	H.265 說明如需支援播放H.265編碼的視頻流，您需要先填寫表單申請License授權。部分瀏覽器不支援播放H.265編碼的視頻。如果開啟了支援播放H.265編碼視頻的功能，會導致額外的流量消耗，以及起播速度的延緩。	MP4 FLV HLS	AAC	-
	H.266 說明如需支援播放H.266編碼的視頻流，您需要先填寫表單申請License授權。部分瀏覽器不支援播放H.266編碼的視頻。如果開啟了支援播放H.266編碼視頻的功能，會導致額外的流量消耗，以及起播速度的延緩。	MP4	AAC	-
Flash（已停止更新）	H.264	MP4 FLV HLS RTMP	AAC MP3	MP3

直播情境

Web播放器SDK支援的直播播放協議及編碼格式如下：

視頻編碼格式	視頻協議	音頻編碼格式	音頻檔案格式
H.264	HLS、FLV、RTS、DASH	AAC	-
H.265	HLS、FLV（codecId=12）	AAC	-
H.266	HLS、FLV	AAC	-

各直播播放協議的優缺點如下：

直播播放協議	優點	缺點	延遲
HLS	瀏覽器安全色性較高。	延遲較高。	＞10s
FLV	支援高並發情境，更適合Native App。	瀏覽器需要整合阿里雲播放器SDK才能播放。	1s~3s
RTS	抗弱網能力強，在丟包30%的情況下可以流暢播放。	瀏覽器需要整合阿里雲播放器SDK才能播放。	＜1s
DASH	自適應位元速率。	延遲較高。	＞10s

H5瀏覽器適配說明

說明

H5模式同時支援案頭端和移動端瀏覽器環境。
建議使用下述瀏覽器進行播放，否則可能會導致播放失敗。

案頭端瀏覽器適配

重要

案頭端瀏覽器播放FLV、HLS視頻時需啟用跨域訪問。

瀏覽器	MP4	FLV	HLS	MP3
Chrome	✓	34及以上版本	34及以上版本	✓
Firefox	✓	49及以上版本	49及以上版本	✓
IE	IE 9及以上版本	點播視訊：Windows 8.1及以上、IE 11及以上版本直播視頻：Windows 8.1及以上、IE 11以上版本重要由於flv.js在IE 11瀏覽器下的`mseLiveFlvPlayback`屬性為false，FLV的直播流在Windows 8及以上系統的IE 11瀏覽器下無法播放。	Windows 8.1及以上、IE 11及以上版本	IE 9及以上版本
Edge	✓	✓	✓	✓
Opera	✓	✓	✓	✓
Safari	✓	8及以上版本	8及以上版本	✓

移動端瀏覽器適配

說明

Web播放器H5模式在移動端不支援播放FLV視頻。

表 1. Android端H5瀏覽器適配

瀏覽器	MP4	FLV	HLS	MP3
Chrome	✓	×	34及以上版本	✓
Firefox	✓	×	49及以上版本	✓
微信	✓	×	✓	✓
Edge	✓	×	✓	✓
Opera	✓	×	✓	✓

表 2. iOS端H5瀏覽器適配

瀏覽器	MP4	FLV	HLS	MP3
Chrome	✓	×	34及以上版本	✓
Firefox	✓	×	49及以上版本	✓
微信	✓	×	✓	✓
Edge	✓	×	✓	✓
Opera	✓	×	✓	✓
Safari	✓	×	8及以上版本	✓

H5功能適配說明

功能	案頭端	移動端	如何設定
全屏播放	預設非全屏播放。	視頻預設全屏播放，針對不同的情況需要不同的設定。說明 iOS 10以下版本的Safari瀏覽器無法禁止視頻自動全屏播放。非全屏播放時，需要根據視頻轉碼的解析度比例調整視頻大小，否則可能會產生黑邊。	進階功能
自動播放	限制來源於瀏覽器自身而不是Web播放器SDK。 macOS High Sierra Safari 11及以上版本限制自動播放。 Chrome 55及以上版本限制自動播放。	預設禁止。開啟需要特殊設定。說明不排除部分瀏覽器和WebView允許自動播放，Android系統中較為常見。	進階功能
音量大小	支援	由於`video.volume`在iOS 和一些Android系統中是可讀屬性，阿里雲Web播放器提供的音量大小方法`getVolume`和`setVolume`在iOS系統和部分Android系統會失效。	基礎功能
倍速播放	支援	部分移動端瀏覽器不支援設定倍速，比如Android系統的微信瀏覽器。	基礎功能
HLS標準加密視頻播放	Chrome FireFox Safari Edge IE（僅支援在Windows 8.1及以上系統的IE 11及以上版本的IE瀏覽器）	支援	視頻加密播放
阿里雲私人加密視頻播放說明出於安全考慮，阿里雲私人加密不支援用真實的加密視頻調試。	（推薦）Chrome FireFox Safari Edge IE（僅支援在Windows 8.1及以上系統的IE 11及以上版本的IE瀏覽器）說明部分第三方瀏覽器會強制劫持播放器，使得阿里雲私人加密失效，進而導致無法播放。此時建議採用HLS標準加密或DRM加密方案。	支援 iOS 14 以上瀏覽器。說明開啟 iOS 17.1 以下支援需要您自行部署額外的播放器外掛程式指令碼，請參考：IOS 17.1以下私人加密外掛程式部署說明。支援 Android 平台大部分瀏覽器說明由於部分瀏覽器會對視頻播放進行劫持，已知以下瀏覽器不支援阿里雲私人加密播放：UC、夸克、百度，以及 iOS 17.1 以下的微信、DingTalk和QQ瀏覽器，您可以引導使用者至其它瀏覽器播放。
ApsaraVideo for LiveDRM加密視頻播放	Windows系統 Chrome Opera FireFox Edge macOS系統 Chrome Safari FireFox Opera Edge	iOS平台 Chrome Safari Android平台 Android 10及以上的Chrome Edge
點播DRM加密視頻播放	Windows系統 Chrome Opera FireFox Edge macOS系統 Chrome Safari FireFox Opera Edge	iOS平台 Chrome Safari Android平台 Android 10及以上的Chrome Edge

Flash瀏覽器適配說明

Flash模式僅支援案頭端瀏覽器環境。具體的瀏覽器支援如下：

說明

在IE 8瀏覽器使用Flash模式播放時，需要在頁面添加json.min.js的引用。詳情請參見快速接入。

瀏覽器	MP4	FLV	HLS	RTMP	MP3
Chrome	✓	✓	✓	✓	✓
Firefox	✓	✓	✓	✓	✓
IE	IE 8及以上版本	IE 8及以上版本	IE 8及以上版本	IE 8及以上版本	IE 8及以上版本
Edge	✓	✓	✓	✓	✓
Opera	✓	✓	✓	✓	✓
Safari	✓	✓	✓	✓	✓

版本狀態劃分及支援人員策略

為了持續最佳化使用者體驗，阿里雲播放器會不斷迭代版本，帶來新的功能、效能提升以及問題修複。在迭代過程中，我們會盡量保持原有API的相容性，因此推薦您及時更新播放器到最新版本，以獲得更好的體驗。

根據發布時間，我們將阿里雲播放器的版本分為推薦、支援、不推薦以及不支援四個狀態，我們提供的支援人員服務將根據播放器版本的狀態有所差異。

Web播放器SDK的各版本請參見Web播放器SDK發布歷史，版本狀態的劃分及支援人員策略說明如下：

版本狀態	劃分標準	說明
推薦 RECOMMENDED	最新發行的版本	版本包含最新的功能特性和問題修複，我們推薦所有客戶儘可能升級。我們會對最新版本提供全面的支援人員。
支援 SUPPORTED	距離最新版本發布6個月以內的版本	版本包含了近期的新功能和主要問題修複。我們會對這些版本提供支援人員。
不推薦 DEPRECATED	距離最新版本發布6~12個月的版本	版本可能包含過時的功能或者潛在的問題，且隨著使用者普遍的瀏覽器版本升級，可能會產生未知問題。我們會對這些版本提供支援人員，但不保證問題排查的效率和準確性。我們強烈建議您升級到【推薦】的版本，因為除了新的特性和問題修複，新版本還會包含問題診斷系統的最佳化，可以大大提升開發人員自助解決問題或者我們支援人員的效率。
不支援 UNSUPPORTED	距離最新版本發布超過12個月的版本	版本的功能極大可能已淘汰、且沒有針對最新的瀏覽器環境進行最佳化，我們不建議在生產環境繼續使用這些版本。除非存在嚴重問題，否則我們不會對此狀態的版本提供支援人員，您需要儘快升級至【推薦】的版本。