# AliPlayer-Android

**Repository Path**: lengjiye/AliPlayer-Android

## Basic Information

- **Project Name**: AliPlayer-Android
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Language: 中文简体 | [English](README-EN.md)

# **AliPlayer-Android**

[![Platform](https://img.shields.io/badge/Platform-Android-brightgreen)](https://www.android.com/) [![Docs](https://img.shields.io/badge/Docs-AliPlayer-blue?logo=aliyun)](https://help.aliyun.com/zh/vod/developer-reference/apsaravideo-player-sdk-for-android/) [![website](https://img.shields.io/badge/Product-VOD-FF6A00)](https://www.aliyun.com/product/vod)

---

## **📌 项目简介**

本仓库为阿里云播放器 AliPlayer 在 Android 平台上的**完整示例工程**，提供从基础集成到高级功能的全方位解决方案，帮助开发者快速构建专业级音视频播放应用。

### **✨ 核心特性**

- 🚀 **快速集成** - 提供完整的 SDK 集成指南和最佳实践
- 🎯 **功能全面** - 涵盖基础播放、高级控制、场景化应用等多种功能
- 📱 **多场景支持** - 短剧列表、信息流播放、画中画等丰富场景
- 🔧 **模块化设计** - 采用模块化架构，便于理解和定制开发
- 📚 **详细文档** - 提供中英文双语文档和 API 参考

---

## **🗂️ 目录结构**

```
AliPlayer-Android/
├── Demo/                     # 完整功能演示 App
├── API-Example/              # Java 编写的 API 示例项目
├── SDK/                      # SDK 文件与文档
│   ├── README.md             # SDK 使用说明（中文）
│   └── README-EN.md          # SDK 使用说明（英文）
├── PlayerKit/                # 播放器含 UI 集成方案
│   ├── README.md             # PlayerKit 使用说明（中文）
│   └── README-EN.md          # PlayerKit 使用说明（英文）
├── README.md                 # 项目说明（中文）
├── README-EN.md              # 项目说明（英文）
└── LICENSE                   # 开源协议
```

### **📚 模块详解**

* **🎯 Demo - 完整功能演示**

  提供生产级别的播放器应用演示，包含多种播放场景和 UI 组件。

* **🔧 API-Example - 单功能演示**

  采用模块化设计，每个模块专注单一功能演示。

* **📦 SDK - 播放器 SDK 资源**

  包含阿里云播放器 SDK 的完整集成指南、API 文档和故障排查资源。

* **🎨 PlayerKit - 播放器含 UI 集成方案**

  提供低代码、可扩展的播放器 UI 组件与场景化解决方案，支持极简接入。

---

## **🚀 快速开始**

### **🔐 License 配置**

在运行项目前，请先配置播放器 SDK License：

1. **获取 License**：[播放器 SDK License 申请](https://help.aliyun.com/zh/vod/developer-reference/obtain-the-player-sdk-license)
2. **配置 License**：[License 接入指南](https://help.aliyun.com/zh/vod/developer-reference/access-to-license)

### **📦 项目运行**

选择适合您需求的项目进行体验：

| 项目类型        | 适用场景                | 快速启动                                             |
| --------------- | ----------------------- | ---------------------------------------------------- |
| **Demo**        | 完整功能体验与场景演示  | [查看 Demo 运行指南](./Demo/README.md)               |
| **API-Example** | 单一功能学习与 API 验证 | [查看 API-Example 运行指南](./API-Example/README.md) |
| **PlayerKit**   | 低代码播放器含 UI 集成  | [查看 PlayerKit 指南](./PlayerKit/README.md)         |

----

## **⚠️ 重要提示**

- **SDK 版本**：请使用阿里云官网最新发布的 SDK 版本
- **License 配置**：正式使用前必须配置有效的播放器 SDK License
- **设备要求**：建议在真机设备上进行测试，模拟器可能存在兼容性问题

----

## **🎥 相关产品**

- [阿里云视频点播（VOD）](https://www.aliyun.com/product/vod)
- [阿里云视频直播（Live）](https://www.aliyun.com/product/live)
- [音视频终端 SDK](https://help.aliyun.com/zh/apsara-video-sdk/)


---

## **📞 联系我们**

如遇到问题或需要技术支持，可通过以下方式获取帮助：

- 📘 **官方文档**：[播放器帮助中心](https://help.aliyun.com/zh/vod/)
- 💬 **GitHub Issues**：[欢迎提交反馈与建议](https://github.com/MediaBox-Demos/AliPlayer-Android/issues)
- 🔍 **控制台**：[视频点播控制台](https://vod.console.aliyun.com)

---