更新记录

1.0.1（2026-02-28）

seek方法的单位改为秒（原单位为毫秒）

1.0.0（2026-02-28）

初次发布，可能有一些问题。 以后添加循环播放；倍速播放；播放列表等功能。

平台兼容性

uni-app(4.15)

uni-app x(4.15)

UTS环境兼容性

uyultax-uts-player

使用说明

支持mp3,mp4,m4a 使用方法相同与微信唯一背景音乐播放器

interface IUyultaxPlayer {
    //网络音频链接。暂不支持本地资源
    src : string
    //标题
    title : string
    //艺术家
    singer : string
    //缩略图
    cover : string
    //专辑标题
    episode : string
    //音频长度
    readonly duration : number
    //音频当前时间
    readonly currentTime : number
    //播放-暂停状态
    readonly paused : boolean
    //音频资源就绪-(duration)=>{ 音频长度 }
    onCanplay(callback : OnCanplayCallback) : void
    //音频缓冲事件
    (callback : OnCommonCallback) : void
    //播放结束事件
    (callback : OnCommonCallback) : void
    //播放器被停止事件
    onStop(callback : OnCommonCallback) : void
    //媒体通知和媒体控制器的下一曲按钮事件
    onNext(callback : OnCommonCallback) : void
    //媒体通知和媒体控制器的下一曲按钮事件
    onPrev(callback : OnCommonCallback) : void
    //播放器错误事件-看下面错误码 {code,extra,message}
    onError(callback : OnErrorCallback) : void
    //开始播放事件
    onPlay(callback : OnCommonCallback) : void
    //暂停播放事件
    onPause(callback : OnCommonCallback) : void
    //播放时间更新事件
    (callback : dCallback) : void
    //用进度条快进结束事件
    ed(callback : OnCommonCallback) : void
    //播放
    play() : void
    //暂停
    pause() : void
    //停止
    stop() : void
    //快进-如果时间超出媒体长度，调整位最后5秒
    seek(time : number) : void
}

错误码

示例

import {
    createUyultaxPlayer
} from '@/uni_modules/uyultax-uts-player/';

let player = createUyultaxPlayer()

player.src = "https://media.example.com/audio.mp3"
player.title = "xxx-集"
player.singer = "xxx艺术家"
player.episode = "xxx录音室"
player.cover = "图片缩略图"
player.play()

player.onNext(() => {
    goNext()
    player.src = data.list[data.current]
})

player.onPrev(() => {
    goPrev()
    player.src = data.list[data.current]
})

player.onCanplay(duration=>{
    console.log(duration)
})

player.onEnded(() => {
    goNext()
    console.log("触发播放结束", data.current)
    player.src = data.list[data.current]
})

注意事项

src必须要其他参数（title,singer,episode,cover）后面进行赋值