阿里云Web播放器SDK可以被業務方的Web應用集成，提供直播、點播場景的視頻播放能力。本文為您介紹阿里云Web播放器SDK的功能說明和瀏覽器適配情況。
概述
阿里云Web播放器SDK通過HTML5（以下簡稱為H5）的<video>標簽以及Flash在Web應用中實現視頻播放。可以兼容 Chrome、Safari等多種瀏覽器，提供多平臺統一視頻播放效果，并結合阿里云視頻直播、視頻點播，提供防盜鏈和版權視頻加密播放、質量監測等功能。
由于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 |
| AAC | MP3 |
H.265 說明
|
| AAC | - | |
H.266 說明
| MP4 | AAC | - | |
Flash（已停止更新） | H.264 |
|
| 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及以上版本 |
重要 由于flv.js在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功能適配說明
功能 | 桌面端 | 移動端 | 如何設置 |
全屏播放 | 默認非全屏播放。 | 視頻默認全屏播放，針對不同的情況需要不同的設置。 說明
| |
自動播放 | 限制來源于瀏覽器自身而不是Web播放器SDK。
| 默認禁止。開啟需要特殊設置。 說明 不排除部分瀏覽器和WebView允許自動播放，Android系統中較為常見。 | |
音量調節 | 支持 | 由于 | |
倍速播放 | 支持 | 部分移動端瀏覽器不支持設置倍速，比如Android系統的微信瀏覽器。 | |
HLS標準加密視頻播放 |
| 支持 | |
阿里云私有加密視頻播放 說明 出于安全考慮，阿里云私有加密不支持用真實的加密視頻調試。 |
說明 部分第三方瀏覽器會強制劫持播放器，使得阿里云私有加密失效，進而導致無法播放。此時建議采用HLS標準加密或DRM加密方案。 |
| |
視頻直播DRM加密視頻播放 | Windows系統
macOS系統
| iOS平臺
Android平臺
| |
點播DRM加密視頻播放 | Windows系統
macOS系統
| iOS平臺
Android平臺
|
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個月的版本 |
|