HarmonyOS鸿蒙Next中如何获取网络音频播放时长？

HarmonyOS鸿蒙Next中如何获取网络音频播放时长？ 如何获取网络音频播放时长，有相关的文档嘛？为什么获取倒的时间为-1不是正确时间。

3 回复 
import media from '@ohos.multimedia.media';
import { BusinessError } from '@ohos.base';

/**
 * 获取网络音频时长（使用 prepare 机制）
 * @param url 网络音频地址
 * @returns Promise<number> 时长（毫秒），失败返回 -1
 */
export async function getNetworkAudioDuration(url: string): Promise<number> {
  return new Promise(async (resolve, reject) => {
    let avPlayer: media.AVPlayer | undefined = undefined;
    let isResolved = false;

    // 清理资源的辅助函数
    const releasePlayer = async () => {
      if (avPlayer) {
        try {
          await avPlayer.release();
        } catch (e) {}
      }
    };

    // 超时保护 (10秒)
    const timeoutId = setTimeout(() => {
      if (!isResolved) {
        console.error('[AudioDuration] 获取超时');
        isResolved = true;
        releasePlayer();
        resolve(-1);
      }
    }, 10000);

    try {
      avPlayer = await media.createAVPlayer();

      avPlayer.on('stateChange', async (state: media.AVPlayerState) => {
        console.info(`[AudioDuration] 当前状态: ${state}`);

        switch (state) {
          case 'initialized':
            // 【关键】状态变为 initialized 后，必须调用 prepare()
            // 这会触发底层去解析网络流的元数据
            console.info('[AudioDuration] 已初始化，正在调用 prepare()...');
            avPlayer?.prepare();
            break;

          case 'prepared':
            // 【关键】只有在 prepared 状态，时长才是准确的
            const duration = avPlayer?.duration ?? -1;
            console.info(`[AudioDuration] 准备就绪 (prepared)，获取时长: ${duration} ms`);

            if (!isResolved) {
              isResolved = true;
              clearTimeout(timeoutId);
              // 获取到结果后释放资源
              await releasePlayer();
              resolve(duration);
            }
            break;

          case 'error':
          case 'released':
            // 异常处理
            if (!isResolved) {
              releasePlayer(); // 确保释放
            }
            break;
        }
      });

      avPlayer.on('error', (err: BusinessError) => {
        console.error(`[AudioDuration] 错误: ${err.message}`);
        if (!isResolved) {
          isResolved = true;
          clearTimeout(timeoutId);
          releasePlayer();
          resolve(-1);
        }
      });

      // 设置 URL，触发生命周期
      avPlayer.url = url;

    } catch (error) {
      console.error(`[AudioDuration] 异常: ${JSON.stringify(error)}`);
      resolve(-1);
    }
  });
}

在鸿蒙 AVPlayer 的生命周期中，initialized 状态对于网络资源来说，往往太早了。

当状态变为 initialized 时，只是代表“播放器创建了并设置了 URL”，但此时网络流的元数据（Metadata，包含时长信息）可能还没有完全下载解析完毕。在 initialized 状态时，主动调用 avPlayer.prepare()，然后等待状态变为 prepared。

在 prepared 状态下，系统保证已经缓冲了足够的数据并且解析完了头部信息，此时获取时长是 100% 准确的。

更多关于HarmonyOS鸿蒙Next中如何获取网络音频播放时长？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中，获取网络音频播放时长可通过media.AVPlayer实现。首先创建AVPlayer实例并设置音频源URL，然后监听stateChange事件。当状态变为prepared时，调用getDuration()方法即可获取音频总时长（毫秒）。注意需在音频加载完成后获取，否则可能返回0。

在HarmonyOS Next中，获取网络音频的播放时长（总时长）是音频播放开发中的常见需求。您遇到的获取结果为 -1 的情况，通常是因为在音频元数据（如时长信息）尚未加载完成时就尝试获取。

以下是核心方法和解释：

1. 关键API：AVPlayer

HarmonyOS Next的媒体播放核心是AVPlayer。获取总时长主要使用其 duration 属性。

import media from '@ohos.multimedia.media';
import fs from '@ohos.file.fs';

// 1. 创建AVPlayer实例
let avPlayer: media.AVPlayer;
media.createAVPlayer().then((player: media.AVPlayer) => {
  avPlayer = player;
  // 2. 监听状态变化，特别是'prepared'状态
  avPlayer.on('stateChange', (state: string, reason: media.StateChangeReason) => {
    if (state === 'prepared') { // 当播放器准备就绪，元数据已加载
      // 3. 此时可以安全获取总时长（单位：毫秒）
      let totalDuration: number = avPlayer.duration;
      console.info(`音频总时长: ${totalDuration} ms`);
      // 通常需要转换为秒：totalDuration / 1000
    }
  });
  // 4. 设置网络音频源并准备
  avPlayer.url = 'https://example.com/your-audio-file.mp3';
  avPlayer.prepare();
});

2. 为什么获取到 -1？

  • 时机不正确：如果在调用 prepare() 方法之前，或者在 prepared 状态触发之前（例如在 idle 或 initialized 状态）直接访问 avPlayer.duration，系统可能无法确定时长，从而返回 -1。
  • 资源元数据缺失：极少数情况下，网络音频流本身可能不包含标准的时长元数据信息。

3. 确保获取正确时长的要点

  • 在 prepared 状态后获取：这是最关键的一点。必须等待 stateChange 回调通知状态变为 'prepared'，此时媒体资源已解析，duration 属性才有效。
  • 使用异步监听：不要同步地、在设置url后立即获取时长，必须通过事件监听。
  • 错误处理：始终监听 error 事件，以处理网络或资源格式问题。
    avPlayer.on('error', (error: media.BusinessError) => {
  console.error(`播放器发生错误: ${error.code}, ${error.message}`);
});

4. 相关文档

HarmonyOS Next的媒体API文档是您最权威的参考：

  • @ohos.multimedia.media (媒体服务)：这是包含AVPlayer的核心Kit。
  • 开发指南：在DevEco Studio的API文档中，查找 “媒体播放开发” 或 “AVPlayer开发指导”。
  • API参考：直接查看 AVPlayer 类的详细说明，重点关注 duration 属性、stateChange 事件以及 prepare() 方法。

总结：您遇到 -1 的根本原因极大概率是获取时机过早。请将获取 duration 的逻辑移至 stateChange 事件回调中，并确保状态为 'prepared'。请参考官方媒体开发文档以获取更完整的上下文和示例代码。

回到顶部