更新记录

1.0.1（2026-03-13） 下载此版本

兼容修改

1.0.0（2026-03-13） 下载此版本

新增

• 初始版本
• 支持流式播放音频数据
• 支持 Android 平台 (MediaPlayer)
• 支持 iOS 平台 (AVPlayer)
• 支持播放、暂停、恢复、停止操作
• 支持获取播放进度
• 支持播放完毕后自动删除临时文件

平台兼容性

uni-app(5.0)

uni-app x(5.0)

fyq-audio-stream-player 音频流播放器

支持边接收边播放的音频流播放器 UTS 插件，适用于 TTS 等需要流式播放的场景。

平台支持

• Android (MediaPlayer)
• iOS (AVPlayer)

安装

将插件放置在 uni_modules/fyq-audio-stream-player 目录下。

使用方法

import {
  playStream,
  appendData,
  stop,
  pause,
  resume,
  getPlayerInfo,
  setDeleteOnComplete
} from '@/uni_modules/fyq-audio-stream-player'

// 开始播放音频流
playStream({
  data: base64AudioData,    // Base64 编码的音频数据
  format: 'mp3',            // 音频格式: 'mp3' | 'wav' | 'pcm'
  deleteOnComplete: true,   // 播放完毕后是否删除临时文件，默认 true
  onPlayStart: () => {
    console.log('开始播放')
  },
  onPlayEnd: () => {
    console.log('播放结束')
  },
  onError: (err) => {
    console.error('播放错误:', err)
  }
})

// 追加更多音频数据（流式播放）
appendData(moreBase64AudioData)

// 暂停播放
pause()

// 恢复播放
resume()

// 停止播放并清理资源
stop()

// 获取播放器状态
const info = getPlayerInfo()
console.log('当前播放位置:', info.currentPosition)
console.log('总时长:', info.duration)
console.log('是否正在播放:', info.isPlaying)

// 设置播放完毕是否删除文件
setDeleteOnComplete(false)

API

playStream(options)

开始播放音频流。

appendData(data)

追加更多音频数据，实现流式播放。

stop()

停止播放并清理资源。

pause()

暂停播放。

resume()

恢复播放。

getPlayerInfo()

获取播放器状态信息。

返回值:

{
  duration: number        // 总时长（毫秒）
  currentPosition: number // 当前播放位置（毫秒）
  isPlaying: boolean      // 是否正在播放
  isPaused: boolean       // 是否暂停
}

setDeleteOnComplete(enable)

设置播放完毕是否删除临时文件。

注意事项

1. Android 平台使用 MediaPlayer 实现
2. iOS 平台使用 AVPlayer 实现
3. 临时文件存放在应用缓存目录
4. 如需后台播放，iOS 需配置 UIBackgroundModes

更新日志

查看 changelog.md