AliPlayerKit项目介绍-视频点播(VOD)-阿里云帮助中心

本文介绍AliPlayerKit的项目概况，包括项目简介、核心特性、项目结构、快速集成、快速接入、效果演示和相关产品。

项目简介

AliPlayerKit是面向视频业务的核心播放器UI架构设计。

它提供低代码、可扩展的播放器UI组件与场景化解决方案，使应用无需处理复杂的播放器API与UI实现，即可快速构建完整的视频播放能力。

核心特性

低代码接入：无需直接调用底层播放器API，几行代码即可完成视频播放能力接入。
开箱即用的UI组件：提供可配置的播放器UI组件，覆盖基础播放与常见交互能力。
场景化解决方案：内置中长视频、短视频、直播、播放列表等典型业务场景，快速搭建完整播放体验。
高度可扩展的架构设计：插槽系统支持UI自由组合，策略系统支持业务逻辑灵活扩展。

项目下载

如果希望下载项目，请访问AliPlayerKit。项目中提供了清晰的文档结构与步骤说明，便于 AI 与开发者共同理解和执行。未来我们还将提供专门的 Skills 支持，以实现更加完整和便捷的接入体验。

项目结构

在架构层级上，AliPlayerKit位于播放器内核之上，通过统一的UI组件体系与播放场景抽象，承载不同播放业务的共性能力。

项目模块结构如下：

PlayerKit-Android/
├── demo-app/                   # 演示应用：完整功能演示
├── demo-settings/              # 设置模块：演示应用配置界面
├── docs/                       # 项目文档：架构说明、接入指南与API文档
├── playerkit/                  # 核心模块：播放器UI组件
├── playerkit-examples/         # 示例模块：功能演示
└── playerkit-scenes/           # 场景模块：业务场景解决方案

在线阅读

如果需要在线阅读文档，请查阅在线阅读，该地址包含最新AliPlayerKit项目信息。

快速集成

AliPlayerKit采用分层架构设计，提供两种集成和接入方案，您可以根据业务需求灵活选择：

层级	模块	说明	适用场景
组件层	`playerkit`	核心UI组件，提供播放器视图、控制器、数据模型。	需要自定义UI或灵活控制播放行为。
场景层	`playerkit-scenes`	完整场景解决方案，包含UI和业务逻辑。	快速实现标准播放场景。

说明

详细的集成步骤请参阅集成准备和快速开始文档。

效果演示

为了帮助开发者快速体验AliPlayerKit的功能，我们提供两种方式：

项目运行：运行示例工程体验完整功能。
演示应用：直接安装APK进行体验。

项目运行

前置条件

在运行项目前，请确保满足以下条件：

条件	说明
JDK11	配置方式：Preferences → Build Tools → Gradle → Gradle JDK，选择11。
Android Studio	最新版本：Android Studio。
Android SDK	最低API 21（Android 5.0），建议compileSdkVersion 31+。
Gradle	版本不低于7.0。
License	已获取播放器License授权证书和License Key，详见管理License。

运行步骤

步骤1：添加License证书文件

将License证书文件放置到demo-app/src/main/assets/cert/目录下。

步骤2：配置License Key

在demo-app/src/main/AndroidManifest.xml的<application>元素下添加：

<meta-data
    android:name="com.aliyun.alivc_license.licensekey"
    android:value="您的 License Key" />
<meta-data
    android:name="com.aliyun.alivc_license.licensefile"
    android:value="assets/cert/license.crt" />

步骤3：运行项目

使用Android Studio打开项目，运行demo-app模块。

常见问题

修改包名：License与应用包名绑定，如需修改demo-app包名：

重新申请对应包名的License。
更新demo-app/build.gradle中的applicationId。
更新demo-app/src/main/AndroidManifest.xml中的package属性。

重要

如未正确配置License，播放器将无法正常工作，并可能抛出授权异常。

演示应用

为了帮助开发者快速体验AliPlayerKit的功能，我们基于此工程构建了演示包。该演示包可以直接安装到设备上运行，无需配置开发环境。

获取方式：

使用手机扫描以下二维码，即可快速下载并安装演示包：

Demo QR Code

说明

请确保您的设备已开启允许安装第三方应用的权限。