更新记录

1.0.1（2025-09-25） 下载此版本

新增文档使用说明

1.0.0（2025-09-25） 下载此版本

完整声音播放功能

平台兼容性

uni-app(4.71)

uni-app x(4.71)

其他

hp-soundpool

插件介绍

hp-soundpool 是一个基于 Android SoundPool 封装的音频播放插件，适用于 UniApp 开发环境。该插件主要用于播放短音频文件（如音效、提示音等），具有低延迟、高效的特点。

使用说明

1. 初始化音频资源

在使用前，首先需要初始化音频资源列表。通过 soundPoolInit 方法传入音频资源配置数组。

参数说明：

• list: 音频资源配置数组，每项包含 sid（音频ID）、url（音频文件路径）和 key（音频标识）

示例代码：

import { soundPoolInit, soundPoolPlay } from '@/uni_modules/hp-soundpool';

// 初始化音频资源
soundPoolInit([
  {
    sid: 0,  // 音频ID，初始化后会被实际加载的ID覆盖
    url: 'sound1.mp3',  // 音频文件路径，相对于assets目录
    key: 'sound1'  // 音频标识，用于后续播放调用
  },
  {
    sid: 0,
    url: 'sound2.mp3',
    key: 'sound2'
  }
]);

2. 播放音频

使用 soundPoolPlay 方法播放指定的音频文件。

参数说明：

• key: 音频标识，与初始化时设置的 key 对应

示例代码：

import { soundPoolPlay } from '@/uni_modules/hp-soundpool';

// 播放指定音频
soundPoolPlay('sound1');

3. 注意事项

• 音频文件需要放置在项目的 nativeResources/android/assets/ 目录下
• 建议只用于播放短音频文件（如音效、提示音等），不适合播放较长的音乐文件
• 音频文件格式支持 Android SoundPool 所支持的格式，如 MP3、WAV 等

原生Android媒体播放器与SoundPool播放器的区别

SoundPool 的优势在于它可以预先加载多个短音频到内存中，并以极低的延迟播放，非常适合需要频繁播放简短音效的场景，如游戏、应用交互反馈等。

常见问题

音频文件放在哪里？

请将音频文件放置在项目的 nativeResources/android/assets/ 目录下，如果没有该目录，请手动创建。

播放没有声音怎么办？

1. 检查设备音量是否开启
2. 确认音频文件路径是否正确
3. 确保先调用了 soundPoolInit 方法进行初始化
4. 检查 soundPoolPlay 方法的参数是否正确，确保传入的 key 与初始化时设置的 key 对应

是否需要重新打自定义基座

需要，请将音频文件放置在项目的 nativeResources/android/assets/ 目录下，重新打自定义基座方可生效

关于不同音频文件的区别

在 Android SoundPool 中播放不同格式的音频文件会有不同的性能表现和特点。以下是常见音频格式在 SoundPool 中的对比：

选择建议：

• 对于体积敏感的应用，优先考虑 MP3 或 OGG 格式
• 对于音质要求高且文件大小不是主要问题的场景，选择 WAV 格式
• 一般情况下，MP3 格式是最常用的选择，因为它在文件大小和音质之间取得了较好的平衡
• 注意：SoundPool 对音频文件大小有限制，过大的文件可能无法正常加载（建议单个文件不超过 1MB）

版本更新记录

v1.0.1

• 增加使用文档说明

v1.0.0

• 首次发布
• 实现基本的音频初始化和播放功能
• 支持多个音频资源同时加载和播放