微信小程序API 音頻·InnerAudioContext對(duì)象

InnerAudioContext

InnerAudioContext 實(shí)例，可通過(guò) wx.createInnerAudioContext 接口獲取實(shí)例。

---

屬性

string src

音頻資源的地址，用于直接播放。2.2.3 開(kāi)始支持云文件ID

number startTime

開(kāi)始播放的位置（單位：s），默認(rèn)為 0

boolean autoplay

是否自動(dòng)開(kāi)始播放，默認(rèn)為 false

boolean loop

是否循環(huán)播放，默認(rèn)為 false

boolean obeyMuteSwitch

是否遵循系統(tǒng)靜音開(kāi)關(guān)，默認(rèn)為 true。當(dāng)此參數(shù)為 false 時(shí)，即使用戶(hù)打開(kāi)了靜音開(kāi)關(guān)，也能繼續(xù)發(fā)出聲音。從 2.3.0 版本開(kāi)始此參數(shù)不生效，使用 wx.setInnerAudioOption 接口統(tǒng)一設(shè)置。

number volume

音量。范圍 0~1。默認(rèn)為 1

number playbackRate

播放速度。范圍 0.5-2.0，默認(rèn)為 1。（Android 需要 6 及以上版本）

number duration

當(dāng)前音頻的長(zhǎng)度（單位 s）。只有在當(dāng)前有合法的 src 時(shí)返回（只讀）

number currentTime

當(dāng)前音頻的播放位置（單位 s）。只有在當(dāng)前有合法的 src 時(shí)返回，時(shí)間保留小數(shù)點(diǎn)后 6 位（只讀）

boolean paused

當(dāng)前是是否暫?；蛲Ｖ?fàn)顟B(tài)（只讀）

number buffered

音頻緩沖的時(shí)間點(diǎn)，僅保證當(dāng)前播放時(shí)間點(diǎn)到此時(shí)間點(diǎn)內(nèi)容已緩沖（只讀）

---

方法：

InnerAudioContext.destroy()

銷(xiāo)毀當(dāng)前實(shí)例

InnerAudioContext.offCanplay(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻進(jìn)入可以播放狀態(tài)的事件

參數(shù)

function callback

音頻進(jìn)入可以播放狀態(tài)的事件的回調(diào)函數(shù)

InnerAudioContext.offEnded(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻自然播放至結(jié)束的事件

參數(shù)

function callback

音頻自然播放至結(jié)束的事件的回調(diào)函數(shù)

InnerAudioContext.offError(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻播放錯(cuò)誤事件

參數(shù)

function callback

音頻播放錯(cuò)誤事件的回調(diào)函數(shù)

InnerAudioContext.offPause(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻暫停事件

參數(shù)

function callback

音頻暫停事件的回調(diào)函數(shù)

InnerAudioContext.offPlay(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻播放事件

參數(shù)

function callback

音頻播放事件的回調(diào)函數(shù)

InnerAudioContext.offSeeked(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻完成跳轉(zhuǎn)操作的事件

參數(shù)

function callback

音頻完成跳轉(zhuǎn)操作的事件的回調(diào)函數(shù)

InnerAudioContext.offSeeking(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻進(jìn)行跳轉(zhuǎn)操作的事件

參數(shù)

function callback

音頻進(jìn)行跳轉(zhuǎn)操作的事件的回調(diào)函數(shù)

InnerAudioContext.offStop(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻停止事件

參數(shù)

function callback

音頻停止事件的回調(diào)函數(shù)

InnerAudioContext.offTimeUpdate(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻播放進(jìn)度更新事件

參數(shù)

function callback

音頻播放進(jìn)度更新事件的回調(diào)函數(shù)

InnerAudioContext.offWaiting(function callback)

基礎(chǔ)庫(kù) 1.9.0 開(kāi)始支持，低版本需做兼容處理。

取消監(jiān)聽(tīng)音頻加載中事件

參數(shù)

function callback

音頻加載中事件的回調(diào)函數(shù)

InnerAudioContext.onCanplay(function callback)

監(jiān)聽(tīng)音頻進(jìn)入可以播放狀態(tài)的事件。但不保證后面可以流暢播放

參數(shù)

function callback

音頻進(jìn)入可以播放狀態(tài)的事件的回調(diào)函數(shù)

InnerAudioContext.onEnded(function callback)

監(jiān)聽(tīng)音頻自然播放至結(jié)束的事件

參數(shù)

function callback

音頻自然播放至結(jié)束的事件的回調(diào)函數(shù)

InnerAudioContext.onError(function callback)

監(jiān)聽(tīng)音頻播放錯(cuò)誤事件

參數(shù)

function callback

音頻播放錯(cuò)誤事件的回調(diào)函數(shù)

參數(shù)

Object res

屬性	類(lèi)型	說(shuō)明
errMsg	string
errCode	number

errCode 的合法值

值	說(shuō)明	最低版本
10001	系統(tǒng)錯(cuò)誤
10002	網(wǎng)絡(luò)錯(cuò)誤
10003	文件錯(cuò)誤
10004	格式錯(cuò)誤
-1	未知錯(cuò)誤

InnerAudioContext.onPause(function callback)

監(jiān)聽(tīng)音頻暫停事件

參數(shù)

function callback

音頻暫停事件的回調(diào)函數(shù)

InnerAudioContext.onPlay(function callback)

監(jiān)聽(tīng)音頻播放事件

參數(shù)

function callback

音頻播放事件的回調(diào)函數(shù)

InnerAudioContext.onSeeked(function callback)

監(jiān)聽(tīng)音頻完成跳轉(zhuǎn)操作的事件

參數(shù)

function callback

音頻完成跳轉(zhuǎn)操作的事件的回調(diào)函數(shù)

InnerAudioContext.onSeeking(function callback)

監(jiān)聽(tīng)音頻進(jìn)行跳轉(zhuǎn)操作的事件

參數(shù)

function callback

音頻進(jìn)行跳轉(zhuǎn)操作的事件的回調(diào)函數(shù)

InnerAudioContext.onStop(function callback)

監(jiān)聽(tīng)音頻停止事件

參數(shù)

function callback

音頻停止事件的回調(diào)函數(shù)

InnerAudioContext.onTimeUpdate(function callback)

監(jiān)聽(tīng)音頻播放進(jìn)度更新事件

參數(shù)

function callback

音頻播放進(jìn)度更新事件的回調(diào)函數(shù)

InnerAudioContext.onWaiting(function callback)

監(jiān)聽(tīng)音頻加載中事件。當(dāng)音頻因?yàn)閿?shù)據(jù)不足，需要停下來(lái)加載時(shí)會(huì)觸發(fā)

參數(shù)

function callback

音頻加載中事件的回調(diào)函數(shù)

InnerAudioContext.pause()

暫停。暫停后的音頻再播放會(huì)從暫停處開(kāi)始播放

InnerAudioContext.play()

播放

InnerAudioContext.seek(number position)

跳轉(zhuǎn)到指定位置

參數(shù)

number position

跳轉(zhuǎn)的時(shí)間，單位 s。精確到小數(shù)點(diǎn)后 3 位，即支持 ms 級(jí)別精確度

InnerAudioContext.stop()

停止。停止后的音頻再播放會(huì)從頭開(kāi)始播放。

---

支持格式

格式	iOS	Android
flac	x	√
m4a	√	√
ogg	x	√
ape	x	√
amr	x	√
wma	x	√
wav	√	√
mp3	√	√
mp4	x	√
aac	√	√
aiff	√	x
caf	√	x

---

示例代碼：

const innerAudioContext = wx.createInnerAudioContext()
innerAudioContext.autoplay = true
innerAudioContext.src = 'http://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46'
innerAudioContext.onPlay(() => {
  console.log('開(kāi)始播放')
})
innerAudioContext.onError((res) => {
  console.log(res.errMsg)
  console.log(res.errCode)
})