开天辟地 HarmonyOS(鸿蒙) – 媒体: AVPlayer（播放器，用于播放视频或音频）

在 HarmonyOS（鸿蒙） 中，AVPlayer 是用于播放音频和视频内容的核心组件之一。它支持多种格式的视频和音频文件播放，可以非常方便地集成到应用中，以便实现多媒体功能。AVPlayer 提供了全面的控制接口，可以用于播放、暂停、停止、进度控制等常见的多媒体操作。

✅ 一、AVPlayer 概述

AVPlayer 是 HarmonyOS 提供的一个多媒体播放器组件，能够播放本地或网络上的音视频文件。它支持多种媒体格式，包括常见的视频格式（如 .mp4、.avi、.mkv）和音频格式（如 .mp3、.aac 等）。AVPlayer 提供了丰富的控制接口，让开发者能够灵活控制视频和音频的播放。

✅ 二、AVPlayer 的核心功能

1. 支持多种格式：
   • AVPlayer 支持常见的音视频格式，能够播放本地文件和流媒体（网络视频）内容。
2. 播放控制：
   • 提供播放、暂停、停止、跳转等基本操作，支持音视频的精准控制。
3. 播放进度管理：
   • 支持获取当前播放进度、设置播放进度、调节音量等功能。
4. 网络流媒体播放：
   • 支持通过 URL 播放网络视频或音频，适用于视频流媒体应用。
5. 音视频同步播放：
   • 音视频同步播放，提供无缝的视听体验。
6. 回调与事件通知：
   • 提供播放状态回调（如播放开始、播放暂停、播放完成等），可以方便地处理播放过程中发生的各种事件。

✅ 三、如何使用 AVPlayer 播放视频或音频

1. 引入依赖

确保在 build.gradle 文件中包含了音视频相关的依赖库，以便使用 AVPlayer 类。

dependencies {
    implementation 'com.huawei.hms:avmedia:5.0.0'
}

2. 创建 AVPlayer 实例

在 HarmonyOS 中，可以通过 avmedia.createAVPlayer() 方法来创建 AVPlayer 实例。

import avmedia from '@ohos.avmedia';

// 创建 AVPlayer 实例
let player = avmedia.createAVPlayer();

3. 设置播放源

AVPlayer 支持从本地文件和网络 URL 播放视频或音频。通过 setDataSource() 方法设置播放源。

• 播放本地文件：

const filePath = '/path/to/local/video.mp4';
player.setDataSource(filePath);

• 播放网络视频：

const videoUrl = 'https://example.com/video.mp4';
player.setDataSource(videoUrl);

4. 播放视频

设置好数据源后，调用 prepare() 准备播放，并使用 start() 开始播放。

async function playVideo() {
  try {
    // 准备播放
    await player.prepare();
    
    // 开始播放
    player.start();
    console.log('视频开始播放');
  } catch (error) {
    console.error('视频播放失败:', error);
  }
}

5. 播放控制

除了播放、暂停、停止等基本操作，AVPlayer 还支持控制播放进度、音量等。

• 暂停播放：

player.pause();  // 暂停视频播放

• 停止播放：

player.stop();  // 停止视频播放

• 设置音量：

player.setVolume(0.5);  // 设置音量为 50%

• 获取播放进度：

let currentPosition = player.getCurrentPosition();  // 获取当前播放位置
console.log('当前播放进度:', currentPosition);

• 设置播放进度：

player.seekTo(10000);  // 跳转到 10 秒的位置

6. 事件回调

AVPlayer 提供了多种事件回调，帮助开发者在播放过程中处理各种状态变化。

• 播放状态变化：

player.on('statusChanged', (status) => {
  if (status === 'PLAYING') {
    console.log('视频正在播放');
  } else if (status === 'PAUSED') {
    console.log('视频已暂停');
  } else if (status === 'COMPLETED') {
    console.log('视频播放完成');
  }
});

• 播放错误回调：

player.on('error', (error) => {
  console.error('视频播放错误:', error);
});

• 视频缓冲回调：

player.on('buffering', (bufferingProgress) => {
  console.log('缓冲进度:', bufferingProgress);
});

7. 释放资源

播放完成后，及时释放播放器资源，以避免内存泄漏。

player.release();  // 释放播放器资源

✅ 四、AVPlayer 的常见操作与参数

✅ 五、AVPlayer 的应用场景

1. 视频播放器：
   • 用于开发本地和网络视频播放器应用，支持多种视频格式和流媒体播放。
2. 音频播放器：
   • AVPlayer 也支持音频播放，适合开发音乐播放器或语音播放器应用。
3. 视频流媒体应用：
   • 在流媒体应用中，AVPlayer 可以通过 URL 播放实时视频或音频流，适合实时直播、点播等场景。
4. 短视频应用：
   • 在短视频应用中，AVPlayer 提供了高效的视频播放能力，支持视频的快速加载和播放。

✅ 六、总结

📌 一句话总结：

AVPlayer 是 HarmonyOS 中用于播放音视频内容的强大工具，支持本地和网络视频、音频播放，提供了丰富的控制接口，广泛应用于视频播放器、音频播放器和流媒体应用等场景。