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

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

概述

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

License升級說明

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

協議支援

點播情境

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

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

直播情境

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

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

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

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

瀏覽器適配說明

案頭端瀏覽器適配

重要

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

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

移動端瀏覽器適配

說明

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

表 1. Android端H5瀏覽器適配

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

表 2. iOS端H5瀏覽器適配

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

功能適配說明

功能	案頭端	移動端	如何設定
全屏播放	預設非全屏播放。	視頻預設全屏播放，針對不同的情況需要不同的設定。說明 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	支援	如何播放加密視頻
阿里雲私人HLS加密說明出於安全考慮，阿里雲私人加密不支援用真實的加密視頻調試。	Chrome FireFox Safari Edge 說明部分第三方瀏覽器會強制劫持播放器，使得阿里雲私人加密失效，進而導致無法播放。此時建議採用HLS標準加密或DRM加密方案。	支援 iOS 14 以上瀏覽器。說明開啟iOS 17.1以下支援需要自行部署額外的播放器外掛程式指令碼且僅適用於Safari瀏覽器，其它瀏覽器（如微信、DingTalk、QQ瀏覽器）受系統限制暫無法使用，可以引導使用者至Safarl瀏覽器播放，請參考：IOS 17.1以下私人加密外掛程式部署說明。支援 Android 平台大部分瀏覽器。說明由於部分瀏覽器會對視頻播放進行劫持，已知以下瀏覽器不支援阿里雲私人加密播放：UC、夸克、百度，可以引導使用者至其它瀏覽器播放。	如何播放加密視頻
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	如何播放加密視頻