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

InnerAudioContext

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

---

屬性

string src

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

number startTime

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

boolean autoplay

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

boolean loop

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

boolean obeyMuteSwitch

是否遵循系統(tǒng)靜音開關(guān)，默認(rèn)為 true。當(dāng)此參數(shù)為 false 時(shí)，即使用戶打開了靜音開關(guān)，也能繼續(xù)發(fā)出聲音。從 2.3.0 版本開始此參數(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)前音頻的長度（單位 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()

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

InnerAudioContext.offCanplay(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offEnded(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offError(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offPause(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offPlay(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offSeeked(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offSeeking(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offStop(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offTimeUpdate(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.offWaiting(function callback)

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

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

參數(shù)

function callback

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

InnerAudioContext.onCanplay(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onEnded(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onError(function callback)

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

參數(shù)

function callback

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

參數(shù)

Object res

屬性	類型	說明
errMsg	string
errCode	number

errCode 的合法值

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

InnerAudioContext.onPause(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onPlay(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onSeeked(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onSeeking(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onStop(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onTimeUpdate(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.onWaiting(function callback)

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

參數(shù)

function callback

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

InnerAudioContext.pause()

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

InnerAudioContext.play()

播放

InnerAudioContext.seek(number position)

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

參數(shù)

number position

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

InnerAudioContext.stop()

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

---

支持格式

格式	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('開始播放')
})
innerAudioContext.onError((res) => {
  console.log(res.errMsg)
  console.log(res.errCode)
})