本文介绍AliPlayerKit的项目概况，包括项目简介、核心特性、项目结构、快速集成、快速接入、效果演示和相关产品。
项目简介
AliPlayerKit 是一套面向业务的 低代码播放器 UI 组件 与 场景化解决方案。通过对播放器能力和 UI 交互的高度封装，帮助客户以极低的接入成本快速完成 App 播放能力建设，无需直接调用底层播放器 API，也无需自行实现复杂的播放器 UI。
它提供低代码、可扩展的播放器UI组件与场景化解决方案，使应用无需处理复杂的播放器API与UI实现，即可快速构建完整的视频播放能力。
核心特性
低代码接入：无需直接调用底层播放器API，几行代码即可完成视频播放能力接入。
开箱即用的UI组件：提供可配置的播放器UI组件，覆盖基础播放与常见交互能力。
场景化解决方案：内置中长视频、短视频、直播、播放列表等典型业务场景，快速搭建完整播放体验。
高度可扩展的架构设计：插槽系统支持UI自由组合，策略系统支持业务逻辑灵活扩展。
项目下载
如果希望下载项目，请访问AliPlayerKit。项目中提供了清晰的文档结构与步骤说明，便于 AI 与开发者共同理解和执行。未来我们还将提供专门的 Skills 支持，以实现更加完整和便捷的接入体验。
扫码体验
为了帮助开发者快速体验AliPlayerKit的功能，我们基于此工程构建了演示包。该演示包可以直接安装到设备上运行，无需配置开发环境。
获取方式：
使用手机扫描以下二维码，即可快速下载并安装演示包：
请确保您的设备已开启允许安装第三方应用的权限。
项目结构
在架构层级上，AliPlayerKit 位于播放器内核之上，通过统一的 UI 组件体系与播放场景抽象，承载不同播放业务的共性能力。
项目模块结构如下：
PlayerKit-iOS/
├── PlayerKit/ # 核心模块：播放器 UI 组件
├── PlayerKitScenes/ # 场景模块：业务场景解决方案
├── PlayerKitUsages/ # 示例模块：功能演示
├── DemoSettings/ # Demo 配置模块：应用级配置与链接管理（SceneLive 场景依赖）
├── App/ # 演示应用：完整功能演示
├── Example/ # Xcode 工程配置
└── docs/ # 项目文档：架构说明、接入指南与 API 文档在线阅读
如果需要在线阅读文档，请查阅在线阅读，该地址包含最新AliPlayerKit项目信息。
快速集成
AliPlayerKit采用分层架构设计，提供两种集成和接入方案，您可以根据业务需求灵活选择：
层级 | 模块 | 说明 | 适用场景 |
组件层 |
| 核心UI组件，提供播放器视图、控制器、数据模型。 | 需要自定义UI或灵活控制播放行为。 |
场景层 |
| 完整场景解决方案，包含UI和业务逻辑。 | 快速实现标准播放场景。 |
PlayerKit 使用 Objective-C 开发，对于 Swift 工程，推荐参考 Swift-Call-OC-Example 方案完成 PlayerKit 的集成与使用。
项目运行
前置条件
在运行项目前，请确保满足以下条件：
条件 | 说明 |
Xcode | 15.0+，推荐最新稳定版 |
iOS | 最低 9.0，推荐真机运行 |
CocoaPods | 1.13.0+ |
License | 已获取播放器 License 授权证书和 License Key，详见 管理License。 |
运行步骤
步骤1：安装依赖
cd Example
pod install步骤2：打开工程
使用 Xcode 打开 Example/Example.xcworkspace（请使用 .xcworkspace 而非 .xcodeproj）。
步骤 3：配置License
播放器 SDK 需要有效的 License 授权才能正常工作。请参阅管理License完成 License 的获取与配置。
步骤 4：运行项目
选择目标设备，点击运行（Cmd + R）。
常见问题
License问题：License 与应用 Bundle ID 绑定，如未正确配置将导致播放器无法正常工作。详情请参见管理License。
如未正确配置License，播放器将无法正常工作，并可能抛出授权异常。
相关产品
AliPlayerKit 基于阿里云音视频能力构建，建议结合以下云产品使用，通过端云结合获得更好的播放能力和视频体验：