阿里云Web播放器SDK的功能说明和浏览器适配情况 - 音视频终端SDK

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

概述

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

协议支持

点播场景

播放模式	编码协议	视频协议	音频编码格式	音频文件格式
H5	H.264	MP4、FLV、HLS	AAC	MP3
H5	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播放器提供的音量调节方法`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平台不支持。 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个月的版本	版本的功能极大可能已过时、且没有针对最新的浏览器环境进行优化，我们不建议在生产环境继续使用这些版本。除非存在严重问题，否则我们不会对此状态的版本提供技术支持，您需要尽快升级至【推荐】的版本。