InnerAudioContext · 微信小游戲開發API官方文檔

# InnerAudioContext ### InnerAudioContext InnerAudioContext 實例，可通過 [wx.createInnerAudioContext](/read/wechat-game-api/97.md) 接口獲取實例。 #### 屬性 ##### string src 音頻資源的地址，用于直接播放。2.2.3 開始支持云文件ID ##### number startTime 開始播放的位置（單位：s），默認為 0 ##### boolean autoplay 是否自動開始播放，默認為 `false` ##### boolean loop 是否循環播放，默認為 `false` ##### boolean obeyMuteSwitch 是否遵循系統靜音開關，默認為 `true`。當此參數為 `false` 時，即使用戶打開了靜音開關，也能繼續發出聲音 ##### number volume > 支持版本 >= 1.9.90 音量。范圍 0~1。默認為 1 ##### number duration 當前音頻的長度（單位 s）。只有在當前有合法的 src 時返回（只讀） ##### number currentTime 當前音頻的播放位置（單位 s）。只有在當前有合法的 src 時返回，時間保留小數點后 6 位（只讀） ##### boolean paused 當前是是否暫停或停止狀態（只讀） ##### number buffered 音頻緩沖的時間點，僅保證當前播放時間點到此時間點內容已緩沖（只讀） #### 方法 ##### InnerAudioContext.play() 播放 ##### InnerAudioContext.pause() 暫停。暫停后的音頻再播放會從暫停處開始播放 ##### InnerAudioContext.stop() 停止。停止后的音頻再播放會從頭開始播放。 ##### InnerAudioContext.seek(number position) 跳轉到指定位置 ##### InnerAudioContext.destroy() 銷毀當前實例 ##### InnerAudioContext.onCanplay(function callback) 監聽音頻進入可以播放狀態的事件，但不保證后面可以流暢播放 ##### InnerAudioContext.offCanplay(function callback) 取消監聽音頻進入可以播放狀態的事件，但不保證后面可以流暢播放 ##### InnerAudioContext.onPlay(function callback) 監聽音頻播放事件 ##### InnerAudioContext.offPlay(function callback) 取消監聽音頻播放事件 ##### InnerAudioContext.onPause(function callback) 監聽音頻暫停事件 ##### InnerAudioContext.offPause(function callback) 取消監聽音頻暫停事件 ##### InnerAudioContext.onStop(function callback) 監聽音頻停止事件 ##### InnerAudioContext.offStop(function callback) 取消監聽音頻停止事件 ##### InnerAudioContext.onEnded(function callback) 監聽音頻自然播放至結束的事件 ##### InnerAudioContext.offEnded(function callback) 取消監聽音頻自然播放至結束的事件 ##### InnerAudioContext.onTimeUpdate(function callback) 監聽音頻播放進度更新事件 ##### InnerAudioContext.offTimeUpdate(function callback) 取消監聽音頻播放進度更新事件 ##### InnerAudioContext.onError(function callback) 監聽音頻播放錯誤事件 ##### InnerAudioContext.offError(function callback) 取消監聽音頻播放錯誤事件 ##### InnerAudioContext.onWaiting(function callback) 監聽音頻加載中事件，當音頻因為數據不足，需要停下來加載時會觸發 ##### InnerAudioContext.offWaiting(function callback) 取消監聽音頻加載中事件，當音頻因為數據不足，需要停下來加載時會觸發 ##### InnerAudioContext.onSeeking(function callback) 監聽音頻進行跳轉操作的事件 ##### InnerAudioContext.offSeeking(function callback) 取消監聽音頻進行跳轉操作的事件 ##### InnerAudioContext.onSeeked(function callback) 監聽音頻完成跳轉操作的事件 ##### InnerAudioContext.offSeeked(function callback) 取消監聽音頻完成跳轉操作的事件 #### 示例代碼 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">const innerAudioContext = wx.createInnerAudioContext()</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">innerAudioContext.autoplay = true</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">innerAudioContext.src = 'http://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46'</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">innerAudioContext.onPlay(() => {</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> console.log('開始播放')</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">})</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">innerAudioContext.onError((res) => {</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> console.log(res.errMsg)</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> console.log(res.errCode)</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">})</code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/media/audio/InnerAudioContext.html>