菜鸟-创作你的创作

HarmonyOS系统利用AVPlayer开发视频播放功能

lichongyang

下面给你整理一份 《HarmonyOS 系统利用 AVPlayer 开发视频播放功能》详细指南，涵盖基础概念、开发流程、示例代码以及注意事项，适合初学者快速上手视频播放功能开发。

HarmonyOS 利用 AVPlayer 开发视频播放功能指南

在 HarmonyOS 中，AVPlayer 是官方提供的多媒体播放组件，可播放本地和网络视频，支持控制播放状态、监听播放事件等功能。

一、基础概念

名称说明
AVPlayer视频播放核心类，负责加载和播放媒体资源
Video页面上的 UI 组件，用于显示 AVPlayer 输出的视频画面
PlayerController用于控制播放状态，如播放、暂停、停止
MediaSource视频资源来源，可以是本地路径或网络 URL

二、开发前准备

  1. 开发环境
    • DevEco Studio 3.3 及以上
    • HarmonyOS 3.x SDK
    • 配置好模拟器或真机调试环境
  2. 项目依赖
    build.gradle 中确保引入多媒体模块： dependencies { implementation 'ohos.multimedia.media:1.0.0' }

三、AVPlayer 基本使用流程

  1. 创建 AVPlayer 实例 AVPlayer avPlayer = new AVPlayer(getContext());
  2. 设置视频源avPlayer.setSource(new Source(srcUrl));
    • srcUrl 可以是本地路径："file:///data/media/0/test.mp4"
    • 或网络 URL："https://www.example.com/video.mp4"
  3. 绑定显示组件 Video video = (Video) findComponentById(ResourceTable.Id_video); video.setPlayer(avPlayer);
  4. 控制播放 avPlayer.prepare(); // 准备播放 avPlayer.play(); // 开始播放 avPlayer.pause(); // 暂停 avPlayer.stop(); // 停止

四、监听播放事件

AVPlayer 支持多种监听器：

avPlayer.setPlayerCallback(new IPlayerCallback() {
    @Override
    public void onPrepared() {
        System.out.println("视频准备完成");
        avPlayer.play();
    }

    @Override
    public void onError(int errorCode, int extraCode) {
        System.out.println("播放出错: " + errorCode);
    }

    @Override
    public void onCompletion() {
        System.out.println("播放完成");
    }

    @Override
    public void onBufferingUpdate(int percent) {
        System.out.println("缓冲进度：" + percent + "%");
    }
});

五、UI 控件示例（.xml）

在 HarmonyOS 页面的 .xml 文件中定义视频组件：

<Video
    ohos:id="$+id:video"
    ohos:layout_width="match_parent"
    ohos:layout_height="match_parent"
    videoBackgroundColor="#000000"
/>

通过 findComponentById 获取 Video 控件并绑定 AVPlayer。

六、示例完整代码（Ability）

public class VideoAbilitySlice extends AbilitySlice {

    private AVPlayer avPlayer;
    private Video video;

    @Override
    protected void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_video);

        video = (Video) findComponentById(ResourceTable.Id_video);
        avPlayer = new AVPlayer(getContext());

        // 设置视频源
        Source source = new Source("https://www.example.com/video.mp4");
        avPlayer.setSource(source);

        // 绑定到 Video 组件
        video.setPlayer(avPlayer);

        // 设置监听器
        avPlayer.setPlayerCallback(new IPlayerCallback() {
            @Override
            public void onPrepared() {
                avPlayer.play();
            }

            @Override
            public void onError(int errorCode, int extraCode) {
                System.out.println("播放出错：" + errorCode);
            }

            @Override
            public void onCompletion() {
                System.out.println("播放完成");
            }
        });

        // 准备播放
        avPlayer.prepare();
    }

    @Override
    protected void onStop() {
        super.onStop();
        if (avPlayer != null) {
            avPlayer.stop();
            avPlayer.release();
        }
    }
}

七、注意事项

  1. 网络视频需在 Ability 中开启网络权限： <ohos:permission name="ohos.permission.INTERNET"/>
  2. AVPlayer 生命周期管理
    • 页面 onStop 或 onBackground 时，必须调用 stop() 或 release()
    • 避免资源泄漏
  3. 支持多种格式
    • 推荐 MP4、HLS（.m3u8）
    • 需要注意编码兼容性，最好使用 H.264 视频
  4. 缓冲与播放体验优化
    • 可监听 onBufferingUpdate 动态显示缓冲进度
    • 对长视频可使用 seekTo(time) 支持跳转

八、扩展功能

九、总结

使用 HarmonyOS 的 AVPlayer 可以快速实现 在线视频播放、本地视频播放，并提供：

结合 AbilitySlice 生命周期管理，可实现稳定、高性能的视频播放功能。

退出移动版