@tarojs/taro 3.3.13 → 3.3.17

package/types/api/media/audio.d.ts

@@ -1,136 +1,68 @@
-declare namespace Taro {
+import Taro from '../../index'
+
+declare module '../../index' {
   namespace stopVoice {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
-  /** 结束播放语音。
-   * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html) 接口**
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.startRecord({
-   *   success: function (res) {
-   *     const filePath = res.tempFilePath
-   *     Taro.playVoice({ filePath })
-   *
-   *     setTimeout(Taro.stopVoice, 5000)
-   *   }
-   * })
-   * ```
-   * @example
-   * ```tsx
-   * Taro.startRecord(params).then(res => {
-   *   const filePath = res.tempFilePath
-   *   Taro.playVoice({ filePath })
-   *
-   *   setTimeout(Taro.stopVoice, 5000)
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.stopVoice.html
-   */
-  function stopVoice(option?: stopVoice.Option): void
 
   namespace setInnerAudioOption {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 是否与其他音频混播，设置为 true 之后，不会终止其他应用或微信内的音乐 */
       mixWithOther?: boolean
       /** （仅在 iOS 生效）是否遵循静音开关，设置为 false 之后，即使是在静音模式下，也能播放声音 */
       obeyMuteSwitch?: boolean
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
 
-  /** 设置 [InnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/InnerAudioContext.html) 的播放选项。设置之后对当前小程序全局生效。
-   * @supported weapp
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.setInnerAudioOption.html
-   */
-  function setInnerAudioOption(option: setInnerAudioOption.Option): Promise<General.CallbackResult>
-
   namespace playVoice {
     interface Option {
       /** 需要播放的语音文件的文件路径 */
       filePath: string
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 指定录音时长，到达指定的录音时长后会自动停止录音，单位：秒 */
       duration?: number
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
-  /** 开始播放语音。同时只允许一个语音文件正在播放，如果前一个语音文件还没播放完，将中断前一个语音播放。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.startRecord({
-   *   success: function (res) {
-   *     const tempFilePath = res.tempFilePath
-   *     Taro.playVoice({
-   *       filePath: tempFilePath,
-   *       complete: function () { }
-   *     })
-   *   }
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.playVoice.html
-   */
-  function playVoice(option: playVoice.Option): Promise<General.CallbackResult>
 
   namespace pauseVoice {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
-  /** 暂停正在播放的语音。再次调用 [Taro.playVoice](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.playVoice.html) 播放同一个文件时，会从暂停处开始播放。如果想从头开始播放，需要先调用 [Taro.stopVoice](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.stopVoice.html)。
-   * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html) 接口**
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.startRecord({
-   *   success: function (res) {
-   *     var tempFilePath = res.tempFilePath
-   *       Taro.playVoice({
-   *       filePath: tempFilePath
-   *     })
-   *     setTimeout(function() {
-   *         //暂停播放
-   *       Taro.pauseVoice()
-   *     }, 5000)
-   *   }
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.pauseVoice.html
-   */
-  function pauseVoice(option?: pauseVoice.Option): void
 
   namespace getAvailableAudioSources {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
     }
-    interface SuccessCallbackResult extends General.CallbackResult {
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
       /** 支持的音频输入源列表，可在 [RecorderManager.start()](https://developers.weixin.qq.com/miniprogram/dev/api/media/recorder/RecorderManager.start.html) 接口中使用。返回值定义参考 https://developer.android.com/reference/kotlin/android/media/MediaRecorder.AudioSource */
       audioSources: Array<keyof audioSources>
       /** 调用结果 */
@@ -154,46 +86,6 @@ declare namespace Taro {
       'voice_recognition'
     }
   }
-  /** 获取当前支持的音频输入源
-   * @supported weapp
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.getAvailableAudioSources.html
-   */
-  function getAvailableAudioSources(option?: getAvailableAudioSources.Option): Promise<getAvailableAudioSources.SuccessCallbackResult>
-
-  /** 创建内部 audio 上下文 InnerAudioContext 对象。
-   * @supported weapp, h5
-   * @example
-   * ```tsx
-   * const innerAudioContext = Taro.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)
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html
-   */
-  function createInnerAudioContext(): InnerAudioContext
-
-  /** 创建 audio 上下文 AudioContext 对象。
-   * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html) 接口**
-   * @supported weapp
-   * @example
-   * ```tsx
-   * const audioCtx = Taro.createAudioContext('myAudio')
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createAudioContext.html
-   */
-  function createAudioContext(
-    /** [audio](https://developers.weixin.qq.com/miniprogram/dev/component/audio.html) 组件的 id */
-    id: string,
-    /** 在自定义组件下，当前组件实例的this，以操作组件内 [audio](https://developers.weixin.qq.com/miniprogram/dev/component/audio.html) 组件 */
-    component?: General.IAnyObject,
-  ): AudioContext
 
   /** `AudioContext` 实例，可通过 `Taro.createAudioContext` 获取。
    * `AudioContext` 通过 `id` 跟一个 `audio` 组件绑定，操作对应的 audio 组件。
@@ -356,7 +248,7 @@ declare namespace Taro {
   }
 
   namespace InnerAudioContext {
-    interface onErrorDetail extends General.CallbackResult {
+    interface onErrorDetail extends TaroGeneral.CallbackResult {
       /** 错误码 */
       errCode: number
       /** 错误信息 */
@@ -376,4 +268,120 @@ declare namespace Taro {
       '-1'
     }
   }
+
+  interface TaroStatic {
+    /** 结束播放语音。
+     * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html) 接口**
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.startRecord({
+     *   success: function (res) {
+     *     const filePath = res.tempFilePath
+     *     Taro.playVoice({ filePath })
+     *
+     *     setTimeout(Taro.stopVoice, 5000)
+     *   }
+     * })
+     * ```
+     * @example
+     * ```tsx
+     * Taro.startRecord(params).then(res => {
+     *   const filePath = res.tempFilePath
+     *   Taro.playVoice({ filePath })
+     *
+     *   setTimeout(Taro.stopVoice, 5000)
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.stopVoice.html
+     */
+    stopVoice(option?: stopVoice.Option): void
+
+    /** 设置 [InnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/InnerAudioContext.html) 的播放选项。设置之后对当前小程序全局生效。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.setInnerAudioOption.html
+     */
+    setInnerAudioOption(option: setInnerAudioOption.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 开始播放语音。同时只允许一个语音文件正在播放，如果前一个语音文件还没播放完，将中断前一个语音播放。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.startRecord({
+     *   success: function (res) {
+     *     const tempFilePath = res.tempFilePath
+     *     Taro.playVoice({
+     *       filePath: tempFilePath,
+     *       complete: function () { }
+     *     })
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.playVoice.html
+     */
+    playVoice(option: playVoice.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 暂停正在播放的语音。再次调用 [Taro.playVoice](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.playVoice.html) 播放同一个文件时，会从暂停处开始播放。如果想从头开始播放，需要先调用 [Taro.stopVoice](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.stopVoice.html)。
+     * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html) 接口**
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.startRecord({
+     *   success: function (res) {
+     *     var tempFilePath = res.tempFilePath
+     *       Taro.playVoice({
+     *       filePath: tempFilePath
+     *     })
+     *     setTimeout(function() {
+     *         //暂停播放
+     *       Taro.pauseVoice()
+     *     }, 5000)
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.pauseVoice.html
+     */
+    pauseVoice(option?: pauseVoice.Option): void
+
+    /** 获取当前支持的音频输入源
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.getAvailableAudioSources.html
+     */
+    getAvailableAudioSources(option?: getAvailableAudioSources.Option): Promise<getAvailableAudioSources.SuccessCallbackResult>
+
+    /** 创建内部 audio 上下文 InnerAudioContext 对象。
+     * @supported weapp, h5
+     * @example
+     * ```tsx
+     * const innerAudioContext = Taro.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)
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html
+     */
+    createInnerAudioContext(): InnerAudioContext
+
+    /** 创建 audio 上下文 AudioContext 对象。
+     * **注意：1.6.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.createInnerAudioContext](https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createInnerAudioContext.html) 接口**
+     * @supported weapp
+     * @example
+     * ```tsx
+     * const audioCtx = Taro.createAudioContext('myAudio')
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/wx.createAudioContext.html
+     */
+    createAudioContext(
+      /** [audio](https://developers.weixin.qq.com/miniprogram/dev/component/audio.html) 组件的 id */
+      id: string,
+      /** 在自定义组件下，当前组件实例的this，以操作组件内 [audio](https://developers.weixin.qq.com/miniprogram/dev/component/audio.html) 组件 */
+      component?: TaroGeneral.IAnyObject,
+    ): AudioContext
+  }
 }

package/types/api/media/background-audio.d.ts

@@ -1,140 +1,68 @@
-declare namespace Taro {
+import Taro from '../../index'
+
+declare module '../../index' {
   namespace stopBackgroundAudio {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
-  /**
-   * 停止播放音乐。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.stopBackgroundAudio()
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.stopBackgroundAudio.html
-   */
-  function stopBackgroundAudio(option?: stopBackgroundAudio.Option): void
 
   namespace seekBackgroundAudio {
     interface Option {
       /** 音乐位置，单位：秒 */
       position: number
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
-  /** 控制音乐播放进度。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.seekBackgroundAudio({
-   *   position: 30
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.seekBackgroundAudio.html
-   */
-  function seekBackgroundAudio(option: seekBackgroundAudio.Option): Promise<General.CallbackResult>
 
   namespace playBackgroundAudio {
     interface Option {
       /** 音乐链接，目前支持的格式有 m4a, aac, mp3, wav */
       dataUrl: string
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 封面URL */
       coverImgUrl?: string
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
       /** 音乐标题 */
       title?: string
     }
   }
-  /** 使用后台播放器播放音乐，对于微信客户端来说，只能同时有一个后台音乐在播放。当用户离开小程序后，音乐将暂停播放；当用户点击“显示在聊天顶部”时，音乐不会暂停播放；当用户在其他小程序占用了音乐播放器，原有小程序内的音乐将停止播放。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.playBackgroundAudio({
-   *   dataUrl: '',
-   *   title: '',
-   *   coverImgUrl: ''
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.playBackgroundAudio.html
-   */
-  function playBackgroundAudio(option: playBackgroundAudio.Option): Promise<General.CallbackResult>
 
   namespace pauseBackgroundAudio {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
-      success?: (res: General.CallbackResult) => void
+      success?: (res: TaroGeneral.CallbackResult) => void
     }
   }
-  /** 暂停播放音乐。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.pauseBackgroundAudio()
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.pauseBackgroundAudio.html
-   */
-  function pauseBackgroundAudio(option?: pauseBackgroundAudio.Option): void
-
-  /** 监听音乐停止。
-   *
-   * **bug & tip：**
-   *
-   * 1.  `bug`: `iOS` `6.3.30` Taro.seekBackgroundAudio 会有短暂延迟
-   * @supported weapp
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.onBackgroundAudioStop.html
-   */
-  function onBackgroundAudioStop(
-    /** 音乐停止事件的回调函数 */
-    callback: (res: General.CallbackResult) => void,
-  ): void
-
-  /** 监听音乐播放。
-   * @supported weapp
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.onBackgroundAudioPlay.html
-   */
-  function onBackgroundAudioPlay(
-    /** 音乐播放事件的回调函数 */
-    callback: (res: General.CallbackResult) => void,
-  ): void
-
-  /** 监听音乐暂停。
-   * @supported weapp
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.onBackgroundAudioPause.html
-   */
-  function onBackgroundAudioPause(
-    /** 音乐暂停事件的回调函数 */
-    callback: (res: General.CallbackResult) => void,
-  ): void
 
   namespace getBackgroundAudioPlayerState {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
-      complete?: (res: General.CallbackResult) => void
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
-      fail?: (res: General.CallbackResult) => void
+      fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
     }
-    interface SuccessCallbackResult extends General.CallbackResult {
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
       /** 选定音频的播放位置（单位：s），只有在音乐播放中时返回 */
       currentPosition: number
       /** 歌曲数据链接，只有在音乐播放中时返回 */
@@ -157,42 +85,6 @@ declare namespace Taro {
       2
     }
   }
-  /** 获取后台音乐播放状态。
-   * **注意：1.2.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.getBackgroundAudioManager](https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html) 接口**
-   * @supported weapp
-   * @example
-   * ```tsx
-   * Taro.getBackgroundAudioPlayerState({
-   *   success: function (res) {
-   *     var status = res.status
-   *     var dataUrl = res.dataUrl
-   *     var currentPosition = res.currentPosition
-   *     var duration = res.duration
-   *     var downloadPercent = res.downloadPercent
-   *   }
-   * })
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioPlayerState.html
-   */
-  function getBackgroundAudioPlayerState(option?: getBackgroundAudioPlayerState.Option): Promise<getBackgroundAudioPlayerState.SuccessCallbackResult>
-
-  /** 获取**全局唯一**的背景音频管理器。
-   * 小程序切入后台，如果音频处于播放状态，可以继续播放。但是后台状态不能通过调用API操纵音频的播放状态。
-   *
-   * 从微信客户端6.7.2版本开始，若需要在小程序切后台后继续播放音频，需要在 [app.json](https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html) 中配置 `requiredBackgroundModes` 属性。开发版和体验版上可以直接生效，正式版还需通过审核。
-   * @supported weapp
-   * @example
-   * ```tsx
-   * const backgroundAudioManager = Taro.getBackgroundAudioManager()
-   * backgroundAudioManager.title = '此时此刻'
-   * backgroundAudioManager.epname = '此时此刻'
-   * backgroundAudioManager.singer = '许巍'
-   * backgroundAudioManager.coverImgUrl = 'http://y.gtimg.cn/music/photo_new/T002R300x300M000003rsKF44GyaSk.jpg?max_age=2592000'
-   * backgroundAudioManager.src = 'http://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46' // 设置了 src 之后会自动播放
-   * ```
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html
-   */
-  function getBackgroundAudioManager(): BackgroundAudioManager
 
   /** BackgroundAudioManager 实例，可通过 [Taro.getBackgroundAudioManager](https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html) 获取。
    * @example
@@ -273,4 +165,121 @@ declare namespace Taro {
     /** 背景音频完成跳转操作事件 */
     onSeeked(callback?: () => void): void
   }
+
+  interface TaroStatic {
+    /**
+     * 停止播放音乐。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.stopBackgroundAudio()
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.stopBackgroundAudio.html
+     */
+    stopBackgroundAudio(option?: stopBackgroundAudio.Option): void
+
+    /** 控制音乐播放进度。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.seekBackgroundAudio({
+     *   position: 30
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.seekBackgroundAudio.html
+     */
+    seekBackgroundAudio(option: seekBackgroundAudio.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 使用后台播放器播放音乐，对于微信客户端来说，只能同时有一个后台音乐在播放。当用户离开小程序后，音乐将暂停播放；当用户点击“显示在聊天顶部”时，音乐不会暂停播放；当用户在其他小程序占用了音乐播放器，原有小程序内的音乐将停止播放。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.playBackgroundAudio({
+     *   dataUrl: '',
+     *   title: '',
+     *   coverImgUrl: ''
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.playBackgroundAudio.html
+     */
+    playBackgroundAudio(option: playBackgroundAudio.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 暂停播放音乐。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.pauseBackgroundAudio()
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.pauseBackgroundAudio.html
+     */
+    pauseBackgroundAudio(option?: pauseBackgroundAudio.Option): void
+
+    /** 监听音乐停止。
+     *
+     * **bug & tip：**
+     *
+     * 1.  `bug`: `iOS` `6.3.30` Taro.seekBackgroundAudio 会有短暂延迟
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.onBackgroundAudioStop.html
+     */
+    onBackgroundAudioStop(
+      /** 音乐停止事件的回调函数 */
+      callback: (res: TaroGeneral.CallbackResult) => void,
+    ): void
+
+    /** 监听音乐播放。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.onBackgroundAudioPlay.html
+     */
+    onBackgroundAudioPlay(
+      /** 音乐播放事件的回调函数 */
+      callback: (res: TaroGeneral.CallbackResult) => void,
+    ): void
+
+    /** 监听音乐暂停。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.onBackgroundAudioPause.html
+     */
+    onBackgroundAudioPause(
+      /** 音乐暂停事件的回调函数 */
+      callback: (res: TaroGeneral.CallbackResult) => void,
+    ): void
+
+    /** 获取后台音乐播放状态。
+     * **注意：1.2.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.getBackgroundAudioManager](https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html) 接口**
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.getBackgroundAudioPlayerState({
+     *   success: function (res) {
+     *     var status = res.status
+     *     var dataUrl = res.dataUrl
+     *     var currentPosition = res.currentPosition
+     *     var duration = res.duration
+     *     var downloadPercent = res.downloadPercent
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioPlayerState.html
+     */
+    getBackgroundAudioPlayerState(option?: getBackgroundAudioPlayerState.Option): Promise<getBackgroundAudioPlayerState.SuccessCallbackResult>
+
+    /** 获取**全局唯一**的背景音频管理器。
+     * 小程序切入后台，如果音频处于播放状态，可以继续播放。但是后台状态不能通过调用API操纵音频的播放状态。
+     *
+     * 从微信客户端6.7.2版本开始，若需要在小程序切后台后继续播放音频，需要在 [app.json](https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html) 中配置 `requiredBackgroundModes` 属性。开发版和体验版上可以直接生效，正式版还需通过审核。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * const backgroundAudioManager = Taro.getBackgroundAudioManager()
+     * backgroundAudioManager.title = '此时此刻'
+     * backgroundAudioManager.epname = '此时此刻'
+     * backgroundAudioManager.singer = '许巍'
+     * backgroundAudioManager.coverImgUrl = 'http://y.gtimg.cn/music/photo_new/T002R300x300M000003rsKF44GyaSk.jpg?max_age=2592000'
+     * backgroundAudioManager.src = 'http://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46' // 设置了 src 之后会自动播放
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html
+     */
+    getBackgroundAudioManager(): BackgroundAudioManager
+  }
 }