阿里云Web播放器SDK简介 - 视频点播

阿里云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	MP4 FLV HLS	AAC	MP3
	H.265 说明如需支持播放H.265编码的视频流，您需要先填写表单申请License授权。部分浏览器不支持播放H.265编码的视频。如果开启了支持播放H.265编码视频的功能，会导致额外的流量消耗，以及起播速度的延缓。	MP4 FLV HLS	AAC	-
	H.266 说明如需支持播放H.266编码的视频流，您需要先填写表单申请License授权。部分浏览器不支持播放H.266编码的视频。如果开启了支持播放H.266编码视频的功能，会导致额外的流量消耗，以及起播速度的延缓。	MP4	AAC	-
Flash（已停止更新）	H.264	MP4 FLV HLS RTMP	AAC MP3	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及以上版本	点播视频：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视频。

表 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功能适配说明

功能	桌面端	移动端	如何设置
全屏播放	默认非全屏播放。	视频默认全屏播放，针对不同的情况需要不同的设置。说明 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 14 以上浏览器。说明开启 iOS 17.1 以下支持需要您自行部署额外的播放器插件脚本，请参考：IOS 17.1以下私有加密插件部署说明。支持 Android 平台大部分浏览器说明由于部分浏览器会对视频播放进行劫持，已知以下浏览器不支持阿里云私有加密播放：UC、夸克、百度，以及 iOS 17.1 以下的微信、钉钉和QQ浏览器，您可以引导用户至其它浏览器播放。
视频直播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个月的版本	版本的功能极大可能已过时、且没有针对最新的浏览器环境进行优化，我们不建议在生产环境继续使用这些版本。除非存在严重问题，否则我们不会对此状态的版本提供技术支持，您需要尽快升级至【推荐】的版本。