播放器SDK简介 ============================= 阿里云播放器SDK（ApsaraVideo Player SDK，以下简称播放器SDK）是阿里云自研的全端音视频播放工具，为音视频播放提供稳定、流畅、丰富的服务。配合视频点播服务，播放器SDK能够为客户提供云端协同的优异播放体验，以及多场景的解决方案，满足客户的业务需求。播放器SDK具有集成便捷、全端覆盖、播放性能优秀等特点，助力您的业务快速腾飞。 客户价值 ------------------------- 通过集成播放器SDK，您能够更好地连接视频点播服务，打造完善的音视频点播业务闭环。 * 优异性能：播放器SDK稳定支撑海量播放，结合最佳实践综合使用网络优化、预加载、本地缓存等技术实现首屏秒开、极低卡顿率，为用户提供流畅的播放体验。 * 全端覆盖：播放器SDK支持Web、Android、iOS、Flutter、HarmonyOS NEXT平台，有效支撑多屏播放的业务场景，满足客户多样需求。播放器SDK在不同平台下提供统一的接口设计，显性降低开发者跨平台集成的工作量。 * 消费数据：播放器SDK提供详实的播放数据埋点，可视化的数据看板，帮您把握音视频消费的宏观数据、洞察用户需求。详情请参见[播放数据统计](t1959287.md#title-ghd-rip-8ph)。 核心优势 ------------------------- * 稳定流畅的播放体验 播放器SDK质量稳定可靠，轻松支撑过亿每日播放vv（video view）、秒开率大于95%、百秒卡顿时长小于100 ms。综合播放策略、设备适配软硬解方案确保播放流畅性。 * 全平台覆盖一次性集成 播放器SDK支持Web、Android、iOS、Flutter、HarmonyOS NEXT平台，有效支撑多屏播放的业务场景，满足客户多样需求。播放器SDK在不同平台下提供统一的接口设计，显性降低开发者跨平台集成的工作量。 * 丰富多样的播放玩法 播放器SDK提供DASH伪直播、防遮弹幕、ASS字幕、端侧画质增强等多种功能，为客户提供多场景的解决方案，满足客户的业务需求。 * 复合视频安全方案支持 视频点播提供标准加密、阿里云视频加密（私有加密）和DRM加密方案，播放器SDK支持上述方案的加密解码，有效解决恶意下载扩散等侵权问题。 * 完善的数据服务体系 通过播放器SDK埋点，我们提供全盘宏观统计、实时质量监控。针对播放异常，我们提供用户级和播放会话（video view）级的全链路追溯能力，快速定位异常原因，避免负体验影响扩散。 * 直播点播一体服务 播放器SDK同时支持常见的视频直播、视频点播功能，一次集成多场景使用。 使用场景 ------------------------- * 短视频 播放器SDK搭配网络优化、预加载、本地缓存等复合最佳实践实现首屏秒开，为您提供流畅的播放体验。 * 长视频 播放器SDK提供多码率自适应、变速不变调、端侧画质增强等功能，结合云端服务为长视频观影提供进度条缩略图、防遮弹幕、ASS字幕等多样玩法，配合多重安全策略确保视频安全。 * 在线教育 播放器SDK全端覆盖充分满足您的业务需求，现已支持移动端（Android、iOS、HarmonyOS NEXT）和跨端方案（Web、Flutter）；支持多种加密方案实现有效的版权保护，包含标准加密、阿里云视频加密（私有加密）和DRM加密，您可以按需选择。 * 直播与直播转点播 播放器SDK同时支持视频直播、音视频点播常见协议，无缝对接直播服务，支持直播时移、伪直播、直播录制视频回看，帮助您实现音视频业务闭环。 License说明 ------------------------------ 1. 播放器SDK移动端已于2025年2月14日（7.0.0版本开始）开启正式收费，您可以选择[免费试用](t2846867.md#acf0f633059s3)或[获取播放器SDK License](t2846867.md#a492d8b9cb51x)，同时还有更优惠的组合购买套餐供您选择。购买后授权操作指引[接入播放器License](t2355407.md#150c40a00eehv)。 2. 购买视频点播、视频直播、智能媒体服务的资源达到一定金额时，可获赠播放器SDK标准版或专业版一年License授权。更多信息，请参见[播放器SDK计费](t1989015.md#a67e3ec974jsh)。 3. 新购买的播放器SDK Web端标准版License仅支持2.29.1及以上版本，新购买的播放器SDK移动端专业版License仅支持7.0.0及以上版本，在购买前请确认您应用内接入的播放器SDK版本号。 License说明 -------------------------- 1. 播放器SDK移动端已于2025年2月14日（7.0.0版本开始）在标准版基础上增加了专业版区分，获取专业版请联系商务。获取后授权操作指引[接入播放器License](t2355407.md#150c40a00eehv)。 2. 购买视频点播、视频直播、智能媒体服务的资源达到一定金额时，可获赠播放器SDK专业版一年License授权。更多信息，请参见[播放器SDK计费](t1989015.md#a67e3ec974jsh)。 3. 新获取的播放器SDK移动端专业版License仅支持7.0.0及以上版本，在获取前请确认您应用内接入的播放器SDK版本号。 **版本状态划分及技术支持策略** ---------------------------------- 为了持续优化用户体验，阿里云播放器会不断迭代版本，带来新的功能、性能提升以及问题修复。在迭代过程中，我们会尽量保持原有API的兼容性，因此推荐您及时更新播放器到最新版本，以获得更好的体验。 根据发布时间，我们将阿里云播放器的版本分为 **推荐** 、 **支持** 、 **不推荐** 以及 **不支持** 四个状态，我们提供的技术支持服务将根据播放器版本的状态有所差异。 播放器SDK的各版本请参见[下载播放器SDK](t2190718.md#title-1t4-go4-yqb)，版本状态的划分及技术支持策略说明如下： |---------------------------------|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **版本状态** | **划分标准** | **说明** | | 推荐 RECOMMENDED | 最新发布的版本 | * 版本包含最新的功能特性和问题修复，我们推荐所有客户尽可能升级。 * **我们会对最新版本提供全面的技术支持** 。 | | 支持 SUPPORTED | 距离最新版本发布6个月以内的版本 | * 版本包含了近期的新功能和主要问题修复。 * 我们会对这些版本提供技术支持。 | | 不推荐 DEPRECATED | 距离最新版本发布6\~12个月的版本 | * 版本可能包含过时的功能或者潜在的问题，且随着用户普遍的浏览器版本升级，可能会产生未知问题。 * 我们会对这些版本提供技术支持，但不保证问题排查的效率和准确性。我们强烈建议您升级到【推荐】的版本，因为除了新的特性和问题修复，新版本还会包含问题诊断系统的优化，可以大大提升开发者自主解决问题或者我们技术支持的效率。 | | 不支持 UNSUPPORTED | 距离最新版本发布超过12个月的版本 | * 版本的功能极大可能已过时、且没有针对最新的浏览器环境进行优化，我们不建议在生产环境继续使用这些版本。 * 除非存在严重问题，否则我们不会对此状态的版本提供技术支持，您需要尽快升级至【推荐】的版本。 | 相关文档 ------------------------- * 如需了解更多播放器SDK功能，请参见[播放器SDK功能详情](t2152614.md#title-e2w-dib-izd)。 * 如需下载播放器SDK，请参见[下载播放器SDK](t2190718.md#title-1t4-go4-yqb)。 * 如需了解接入License相关功能，请参见[License管理](t2225391.md#)。 * 如需集成播放器SDK，请根据您的实际业务需要选择播放器SDK类型。详细信息如下： * [Web播放器快速接入](t1959851.md#title-v1q-lp4-5pv) * [Android播放器快速接入](t1959844.md#title-lr3-5xj-9rt) * [iOS播放器快速接入](t1959838.md#title-lr3-5xj-9rt) * [Flutter播放器快速接入](t2024540.md#title-ha9-cwl-fvv) * [Harmony播放器快速接入](t2608158.md#) 相关文档 --------------------- * 如需了解更多播放器SDK功能，请参见[播放器SDK功能详情](t2152614.md#title-e2w-dib-izd)。 * 如需下载播放器SDK，请参见[下载播放器SDK](t2190718.md#title-1t4-go4-yqb)。 * 如需了解接入License相关功能，请参见[License管理](t2225391.md#)。 * 如需集成播放器SDK，请根据您的实际业务需要选择播放器SDK类型。详细信息如下： * [Web播放器快速接入](t1959851.md#title-v1q-lp4-5pv) * [Android播放器快速接入](t1959844.md#title-lr3-5xj-9rt) * [iOS播放器快速接入](t1959838.md#title-lr3-5xj-9rt) * [Flutter播放器快速接入](t2024540.md#title-ha9-cwl-fvv) 播放器SDK =========================== 阿里云播放器SDK（ApsaraVideo Player SDK，以下简称播放器SDK）是音视频终端SDK的子产品之一，本文为您介绍播放器SDK的核心优势及详细功能说明。 产品简介 ------------------------- 播放器SDK提供直播、点播场景的音视频播放能力，结合阿里云视频直播、视频点播或智能媒体服务使用，可以获得全面、稳定、流畅的音视频播放体验。播放器SDK具有集成便捷、全端覆盖、播放性能优秀等特点，满足客户对音视频播放的主流需求，提升开发效率和业务体验。 核心优势 ------------------------- 稳定可靠 播放器SDK质量稳定可靠，轻松支撑过亿每日播放vv（video view）；对中低端设备、大屏设备覆盖率高。 优异性能 播放器SDK播放性能优异，综合运用预加载、网络优化和自适应等策略确保清晰流畅的播放体验；秒开率大于85%，百秒卡顿时长小于100 ms。 视频安全 播放器SDK支持商业DRM、AES-128标准加密、阿里云视频加密（私有加密）等加密方案，配合阿里云视频直播、视频点播的URL鉴权、访问限制、溯源水印等功能形成完整的安全方案，提升长视频、在线教培等场景的版权安全水平，有效降低恶意下载扩散等侵权风险。 数据支持 播放器SDK提供全链路数据统计、实时质量监控和轻便的数据分析工具，帮助业务高效洞察消费质量。针对播放异常，我们提供用户及和播放会话（video view）级的全链路追溯能力，快速定位异常原因，避免负体验影响扩散。 集成便捷 播放器SDK的接口设计简单易用，提供产品级Demo源码供业务方复用；Demo包含Native App端的短视频、信息流、长视频业务场景，节省自行开发人力、周期，加速业务上线效率。 全平台覆盖 播放器SDK支持Web、Android、iOS、Flutter、Windows、macOS和Linux等平台，有效支撑多屏播放的业务场景，满足客户多样需求。播放器SDK在不同平台下提供统一的接口设计，显著降低开发者跨平台集成的工作量。 功能列表 ------------------------- 播放器SDK在各端上都提供丰富的音视频点播、直播功能，主要平台支持的功能列表如下： **说明** 目前列表只覆盖Web、Android和iOS。 | **分类** | **功能点** | **功能说明** | **Web播放器SDK** | **Android播放器SDK** | **iOS播放器SDK** | |-----------|---------------|--------------------------------------------------------|------------------------------------------------------------------------------------------------|----------------------------------|----------------------------------| | 支持协议 | 音视频格式 | 支持FLV、HLS、MP4、MP3、RTMP等常见的音视频点播、直播格式。 | ✓ | ✓ | ✓ | | 支持协议 | HLS协议 | 支持HLS、多码率HLS、标准AES-128加密HLS视频流播放。 | ✓ | ✓ | ✓ | | 支持协议 | DASH协议 | 支持标准协议的DASH视频流播放，例如：SegmentBase 、SegmentTemplate。 | × | ✓ | ✓ | | 支持协议 | URL播放 | 支持在线视频、本地视频以URL的方式播放。例如：UrlSource播放。 | ✓ | ✓ | ✓ | | 支持协议 | Vid播放 | 支持Vid方式播放，同时对视频下发多个清晰度的播放地址（若有）。例如：VidAuth播放、VidSts播放。 | ✓ | ✓ | ✓ | | 支持协议 | 完整UI | SDK包含完整UI，集成方可以根据自身需求选用。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 基础控制 | 支持开始、结束、暂停、seek、自动播放等播放控制功能。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | seek | 支持拖动到指定位置（UI支持手势）；支持已经缓冲的视频内容在拖动时不清除缓冲内容并快速拖动。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 精确seek | 支持精确到帧级别拖动到指定位置。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 续播 | 支持设置续播起播时间点。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 循环播放 | 支持音视频播放结束后自动重播。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 列表播放 | 支持（短视频）列表播放功能，提升加载速度。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 倍速播放 | 支持变速播放，支持音频变速不变调。 | ✓ **说明** 支持的倍速范围为0.5\~2倍。 | ✓ **说明** 支持的倍速范围为0.5\~5倍。 | ✓ **说明** 支持的倍速范围为0.5\~5倍。 | | 基础功能-播放控制 | 清晰度（手动）切换 | 支持视频点播的多路清晰度流切换。 | ✓ | ✓ | ✓ | | 基础功能-播放控制 | 截图 | 支持截取当前播放画面帧并保存为静态图片。 | 部分支持 **说明** 受平台、播放模式的影响略有差异。 | ✓ | ✓ | | 基础功能-播放控制 | 渲染数据输出 | 支持边渲染边输出PCM和YUV数据。 | × | ✓ | ✓ | | 基础功能-播放控制 | 事件回调 | 支持对播放状态回调、首帧回调、播放完成或失败回调。 | ✓ | ✓ | ✓ | | 基础功能-显示效果 | 填充 | 支持画面填充和画面裁剪两种填充模式。 | ✓ | ✓ | ✓ | | 基础功能-显示效果 | 旋转 | 支持0°、90°、180°和270°四个视频画面渲染角度设置。 | ✓ | ✓ | ✓ | | 基础功能-显示效果 | 镜像 | 支持无镜像、水平镜像和垂直镜像三种镜像模式设置。 | ✓ | ✓ | ✓ | | 基础功能-显示效果 | 亮度调节 | 支持系统的亮度调节（UI支持手势）。 | ✓ | ✓ | ✓ | | 基础功能-显示效果 | 自定义播放器尺寸 | 支持自定义设置播放器的宽高。 | ✓ | ✓ | ✓ | | 基础功能-显示效果 | HDR视频播放 | 支持HDR10/HLG等多种HDR格式；支持根据机型画像精确判断是否支持HDR及规格实现精确选流。 | × | ✓ | ✓ | | 基础功能-显示效果 | 画中画（小窗）播放 | 支持切换到画中画以小窗形式播放。 | ✓ | ✓ | 部分支持 **说明** 不支持在集成的App外画中画播放。 | | 基础功能-音量效果 | 音量调节 | 支持播放视频时调节系统音量。 | ✓ **说明** 支持软件音量0\~1倍调节。 | ✓ **说明** 支持软件音量0\~2倍放大。 | ✓ **说明** 支持软件音量0\~2倍放大。 | | 基础功能-音量效果 | 静音 | 支持开启和关闭静音功能。 | ✓ | ✓ | ✓ | | 基础功能-音量效果 | 纯音频播放 | 支持只播放视频文件中的音频和常见的音频文件，例如：MP3、AAC。 | ✓ | ✓ | ✓ | | 基础功能-音量效果 | 后台播放 | 支持界面切到后台后继续播放音频。 | ✓ | ✓ | ✓ | | 进阶功能-播放性能 | 播放失败重试 | 播放失败时自动重试。 | ✓ | ✓ | ✓ | | 进阶功能-播放性能 | HTTP 2.0 | 支持HTTP 2.0协议。 | 部分支持 **说明** 取决于浏览器是否支持。更多信息，请参见[HTTP 2](https://caniuse.com/?search=http2)。 | ✓ | ✓ | | 进阶功能-播放性能 | HTTPDNS | 支持HTTPDNS，实现域名防劫持、精准调度、实时解析生效。 | × | ✓ | ✓ | | 进阶功能-播放性能 | 本地缓存 | 支持视频播放的同时缓存下载后面的内容到本地，满足短视频场景下的循环播放，节约用户流量。 | × | ✓ | ✓ | | 进阶功能-播放性能 | 预加载 | 对本地缓存功能的升级，提升视频的起播速度。 | × | ✓ | ✓ | | 进阶功能-播放性能 | 软硬解切换 | 支持H.264和H.265的硬解码、软解码功能，并支持切换。 | 部分支持 **说明** Web播放器SDK不支持H.265。 | ✓ | ✓ | | 进阶功能-播放性能 | 解码策略黑名单 | 支持设置硬解码黑名单。 | ✓ | ✓ | ✓ | | 进阶功能-播放性能 | 网络自适应播放多码率视频流 | 支持多码率HLS、DASH的无缝切换。 | ✓ | ✓ | ✓ | | 进阶功能-播放性能 | 网速显示 | 支持播放器实例的实时网速上报。 | × | ✓ | ✓ | | 进阶功能-互动功能 | 字幕 | 支持导入自定义的字幕文件。 | ✓ **说明** 目前仅支持WebVTT格式的字幕。 | ✓ **说明** 支持SRT、SSA、ASS、VTT格式的字幕。 | ✓ **说明** 支持SRT、SSA、ASS、VTT格式的字幕。 | | 进阶功能-互动功能 | 弹幕 | 支持弹幕、防遮弹幕。 | ✓ | ✓ | ✓ | | 进阶功能-视频安全 | HLS标准加密 | 支持标准AES-128加密方案。 | ✓ | ✓ | ✓ | | 进阶功能-视频安全 | 阿里云加密（私有加密） | 支持阿里云加密（私有加密）方案，防止视频泄露和盗链问题。 | 部分支持 **说明** Web播放器SDK在iOS平台不支持私有加密。 | ✓ | ✓ | | 进阶功能-视频安全 | 安全下载 | 支持通过唯一应用下载视频并进行加密。 | 部分支持 **说明** Web播放器SDK在iOS平台不支持安全下载。 | ✓ | ✓ | | 进阶功能-视频安全 | DRM加密 | 支持Widevine、Fairplay等DRM加密方案。 | ✓ | ✓ | ✓ | | 数据服务 | 日志上报 | 支持上报播放器SDK日志，统计音视频点播、直播相关播放埋点信息。 | ✓ | ✓ | ✓ | | 数据服务 | 播放数据大盘 | 支持观测播放量、播放用户数等宏观数据。 | ✓ | ✓ | ✓ | | 数据服务 | 播放异常追溯 | 支持按照指定用户、播放会话对播放历史进行追溯，定位播放异常原因。 | × | ✓ | ✓ | | 直播功能 | 低延时直播 | 支持LHLS、DASH的低延时流播放。 | ✓ | ✓ | ✓ | | 直播功能 | **超低延时直播** | 支持阿里云RTS超低延时播放。 | ✓ | ✓ | ✓ | | 直播功能 | 自动重连 | 支持直播的自动重连功能。 | ✓ | ✓ | ✓ | | 直播功能 | 动态追帧 | 支持直播的动态追帧，降低延时。 | ✓ | ✓ | ✓ |