# VideoPlayer

**Repository Path**: harmonyos_samples/video-player

## Basic Information

- **Project Name**: VideoPlayer
- **Description**: 本示例主要展示通过HarmonyOS提供的系统播放器AVPlayer和媒体会话等能力，实现视频类应用的开发。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 33
- **Forks**: 19
- **Created**: 2024-09-12
- **Last Updated**: 2025-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实现视频流畅播放且支持后台与焦点打断功能

### 简介

本示例从用户交互和音频流状态变更两个维度，基于HarmonyOS提供的媒体（AVPlayer）和ArkUI等能力，实现长/短视频的流畅播放，视频支持前后台播放控制、播放形态切换、音频焦点切换、播放设备切换等场景，可以为视频播放应用提供灵活的交互体验和良好的观看效果。

### 效果预览

<img src="screenshots/videoPlayer.gif" width='320'>

### 使用说明

1. 启动应用后显示视频播放列表及首个视频自动播放。

2. 点击页面按钮可切换竖屏或横屏模式。

3. 上下滑动切换视频，并能看到历史播放记录。

4. 拖动进度条或全屏手势滑动可调节播放进度。

5. 应用切换到后台可以持续播放并且可以播控中心进行控制。

6. 全屏播放视频场景下，在屏幕左侧上下滑动可调节音量，在屏幕右侧上下滑动可调节亮度。


### 工程目录

```
├──entry/src/main/ets                              
│  ├──entryability  
│  │  └──EntryAbility.ets               // 程序入口
│  ├──model
│  │  ├──BasicDataSource.ets            // 懒加载DataSource
│  │  └──DataModel.ets                  // 数据类
│  ├──pages                                     
│  │  └──IndexPage.ets                  // 首页
│  ├──utils                                     
│  │  └──WindowUtil.ets                 // 窗口工具类
│  └──view
│     ├──AVPlayer.ets                   // 视频组件
│     ├──VideoList.ets                  // 首页视频列表
│     ├──VideoSide.ets                  // 视频滑动组件
│     └──VideoDetails.ets               // 视频详情信息组件
├──entry/src/main/resources             // 应用资源目录
├──MediaService/src/main/ets
│  ├──common  
│  │  └──CommonConstants.ets            //常量类
│  ├──controller
│  │  ├──AvPlayerController.ets         //视频播放控制
│  │  └──AvSessionController.ets        //媒体会话控制
│  ├──model
│  │  └──VideoData.ets                  //视频数据类
│  └──utils
│      ├──BackgroundTaskManager.ets     // 后台播放功能
│      ├──CommUtils.ets                 // 工具类
│      ├──ImageUtil.ets                 // 图片像素处理类
│      └──Logger.ets                    // 日志
└──MediaService/src/main/resources      // 应用资源目录
```

### 相关权限

1. 后台任务权限：ohos.permission.KEEP_BACKGROUND_RUNNING。

2. Internet网络权限：ohos.permission.INTERNET。

### 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。

2. HarmonyOS系统：HarmonyOS 5.0.0 Release及以上。

3. DevEco Studio版本：DevEco Studio 5.0.0 Release及以上。

4. HarmonyOS SDK版本：HarmonyOS 5.0.0 Release SDK及以上。