# alpha_player_plugin

**Repository Path**: aicoding123/alpha_player_plugin

## Basic Information

- **Project Name**: alpha_player_plugin
- **Description**: https://github.com/pengboboer/alpha_player_plugin.git
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-30
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

csdn：https://blog.csdn.net/pengbo6665631/article/details/130409316

掘金：https://juejin.cn/post/7226641471946948667

# alpha_player_plugin
对字节跳动官方原生组件AlphaPlayer一个flutter plugin封装

具体实现功能见字节跳动官方github:
https://github.com/bytedance/AlphaPlayer

### 运行效果

<img src="./demo_show.gif" width=320 />

### 特点
* 支持android和ios双端
* 支持播放手机本地mp4文件
* 简单易用，直接传入path地址

### 快速接入

#### 添加依赖
`alpha_player_plugin: ^0.0.1`

#### 用法
##### AlphaPlayerView
```
AlphaPlayerController controller = AlphaPlayerController();

AlphaPlayerView(
  controller: controller,
  width: xxx,
  height: xxx,
)

controller.start(videoPath);
```
##### AlphaPlayerSimpleView(对AlphaPlayerView的简单封装)

```
AlphaPlayerSimpleView(
  path: videoPath,
  width: xxx,
  height: xxx,
)

AlphaPlayerSimpleView(
  path: videoPath,
  width: xxx,
  height: xxx,
  isLooping: false,
  onStarted: (ct) {
    // 可以拿到controller,进行其他操作
    controller = ct;
  },
  onCompleted: (videoPath) {
    // isLooping为false 才能拿到播放结束的回调
  },
)
```
##### AlphaPlayerSimpleView说明
| 属性     | 描述                                   |
| ------------ | ---------------------------------|
| path          | 视频文件路径                    |
| width | 宽度 |
| height | 高度 |
| align | 视频裁剪对齐方式，详见AlphaPlayerScaleType |
| isLooping | 是否循环播放 |
| onStarted | 视频开始播放，可拿到controller |
| onCompleted | 视频播放结束（仅在isLooping为false时生效） |

### 小提示
项目目录下test_video文件夹下提供了测试视频，可以传到手机上运行example进行测试


视频横向分辨率最好不要超过1920，真实视频的960，因为部分低端android手机不支持太高分辨率的播放
https://github.com/google/ExoPlayer/issues/4966


### 其他
如果对你有帮助，动动小手给一个star，谢谢。

目前该库支持的就是上述这些功能，如果有其他需求问题或者bug，欢迎提issue，会尽力帮助大家解决