文档

Web播放器SDK简介

更新时间:

阿里云Web播放器SDK可以被业务方的Web应用集成,提供直播、点播场景的视频播放能力。本文为您介绍阿里云Web播放器SDK的功能说明和浏览器适配情况。

概述

阿里云Web播放器SDK通过HTML5的<video>标签以及Flash在Web应用中实现视频播放。可以兼容 Chrome、Safari等多种浏览器,提供多平台统一视频播放效果,并结合阿里云视频直播、视频点播,提供防盗链和版权视频加密播放、质量监测等功能。

协议支持

点播场景

播放模式

编码协议

视频协议

音频编码格式

音频文件格式

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支持。

视频直播DRM加密视频播放

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

  • 版本的功能极大可能已过时、且没有针对最新的浏览器环境进行优化,我们不建议在生产环境继续使用这些版本。

  • 除非存在严重问题,否则我们不会对此状态的版本提供技术支持,您需要尽快升级至【推荐】的版本。