全部產品
Search
文件中心

Apsara Video SDK:Web播放器SDK簡介

更新時間:Jul 13, 2024

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

概述

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

協議支援

點播情境

播放模式

編碼協議

視頻協議

音頻編碼格式

音頻檔案格式

H5

H.264

MP4、FLV、HLS

AAC

MP3

H.265

MP4、FLV

AAC

-

Flash

(已停止更新)

H.264

MP4、FLV、HLS、RTMP

AAC、MP3

MP3

說明
  • 如需支援播放H.265編碼的視頻流,您需要先填寫表單申請License授權。

  • 部分瀏覽器不支援播放H.265編碼的視頻。

  • 如果開啟了支援播放H.265編碼視頻的功能,會導致額外的流量消耗,以及起播速度的延緩。

直播情境

編碼協議

視頻協議

音頻編碼格式

音頻檔案格式

H.264

HLS、FLV、RTS

AAC

-

H.265

FLV(codecId=12)

AAC

-

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

視頻協議

優點

缺點

延遲

HLS

瀏覽器安全色性較高。

延遲較高。

>10s

FLV

支援高並發情境,更適合Native App。

瀏覽器需要整合阿里雲播放器SDK才能播放。

1s~3s

RTS

抗弱網能力強,在丟包30%的情況下可以流暢播放。

瀏覽器需要整合阿里雲播放器SDK才能播放。

<1s

適配說明

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視頻。

  • Android端

    瀏覽器

    MP4

    FLV

    HLS

    MP3

    Chrome

    ×

    34及以上版本

    Firefox

    ×

    49及以上版本

    微信

    ×

    Edge

    ×

    Opera

    ×

  • iOS端

    瀏覽器

    MP4

    FLV

    HLS

    MP3

    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播放器提供的音量大小方法getVolumesetVolume在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平台不支援。

Android平台僅Chrome for Android支援。

ApsaraVideo for LiveDRM加密視頻播放

Windows系統

  • Chrome

  • Opera

  • FireFox

  • Edge

macOS系統

  • Chrome

  • Safari

  • FireFox

  • Opera

  • Edge

iOS平台

  • Chrome

  • Safari

Android平台

  • Android 10及以上的Chrome

  • Edge

ApsaraVideo for VODDRM加密視頻播放

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個月的版本

  • 版本的功能極大可能已淘汰、且沒有針對最新的瀏覽器環境進行最佳化,我們不建議在生產環境繼續使用這些版本。

  • 除非存在嚴重問題,否則我們不會對此狀態的版本提供支援人員,您需要儘快升級至【推薦】的版本。