@tarojs/taro 3.7.0-alpha.1 → 3.7.0-alpha.11

package/types/api/device/screen.d.ts

@@ -53,6 +53,41 @@ declare module '../../index' {
     ) => void
   }
 
+  namespace onScreenRecordingStateChanged {
+    interface ScreenRecordingState {
+      /** 开始录屏 */
+      start
+      /** 结束录屏 */
+      stop
+    }
+    /** 用户录屏事件的监听函数 */
+    type Callback = (
+      /** 录屏状态 */
+      state: keyof ScreenRecordingState,
+    ) => void
+  }
+
+  namespace getScreenRecordingState {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (option: SuccessCallbackResult) => void
+    }
+    interface ScreenRecordingState {
+      /** 开始录屏 */
+      start
+      /** 结束录屏 */
+      stop
+    }
+    interface SuccessCallbackResult {
+      /** 录屏状态 */
+      state: keyof ScreenRecordingState
+    }
+  }
+
   namespace getScreenBrightness {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -116,6 +151,15 @@ declare module '../../index' {
       callback: onUserCaptureScreen.Callback,
     ): void
 
+    /** 监听用户录屏事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.onScreenRecordingStateChanged.html
+     */
+    onScreenRecordingStateChanged(
+      /** 用户录屏事件的监听函数 */
+      callback: onScreenRecordingStateChanged.Callback
+    ): void
+
     /** 用户主动截屏事件。取消事件监听。
      * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.offUserCaptureScreen.html
@@ -125,6 +169,23 @@ declare module '../../index' {
       callback: onUserCaptureScreen.Callback,
     ): void
 
+    /** 取消用户录屏事件的监听函数
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.offScreenRecordingStateChanged.html 
+     */
+    offScreenRecordingStateChanged(
+      /** 用户录屏事件的监听函数 */
+      callback: onScreenRecordingStateChanged.Callback
+    ): void
+
+    /** 查询用户是否在录屏
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/screen/wx.getScreenRecordingState.html
+     */
+    getScreenRecordingState(
+      option?: getScreenRecordingState.Option
+    ): Promise<getScreenRecordingState.SuccessCallbackResult>
+
     /**
      * 获取屏幕亮度。
      *

package/types/api/device/sms.d.ts

@@ -0,0 +1,26 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace sendSms {
+    interface Option {
+      /** 预填到发送短信面板的手机号 */
+      phoneNumber?: string
+      /** 预填到发送短信面板的内容 */
+      content?: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  interface TaroStatic {
+    /** 拉起手机发送短信界面
+     * @supported weap
+     * @see declare module '../../index' 
+     */
+    sendSms(option: sendSms.Option): Promise<TaroGeneral.CallbackResul>
+  }
+}

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

@@ -292,83 +292,83 @@ declare module '../../index' {
     /** 音频进入可以播放状态，但不保证后面可以流畅播放
      * @supported weapp, h5, rn
      */
-    onCanplay(callback?: () => void): void
+    onCanplay(callback?: InnerAudioContext.OnCanplayCallback): void
     /** 音频播放事件
      * @supported weapp, h5, rn
      */
-    onPlay(callback?: () => void): void
+    onPlay(callback?: InnerAudioContext.OnPlayCallback): void
     /** 音频暂停事件
      * @supported weapp, h5, rn
      */
-    onPause(callback?: () => void): void
+    onPause(callback?: InnerAudioContext.OnPauseCallback): void
     /** 音频停止事件
      * @supported weapp, h5, rn
      */
-    onStop(callback?: () => void): void
+    onStop(callback?: InnerAudioContext.OnStopCallback): void
     /** 音频自然播放结束事件
      * @supported weapp, h5, rn
      */
-    onEnded(callback?: () => void): void
+    onEnded(callback?: InnerAudioContext.OnEndedCallback): void
     /** 音频播放进度更新事件
      * @supported weapp, h5, rn
      */
-    onTimeUpdate(callback?: () => void): void
+    onTimeUpdate(callback?: InnerAudioContext.OnTimeUpdateCallback): void
     /** 音频播放错误事件
      * @supported weapp, h5, rn
      */
-    onError(callback?: (res: InnerAudioContext.onErrorDetail) => void): void
+    onError(callback?: InnerAudioContext.OnErrorCallback): void
     /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发
      * @supported weapp, h5, rn
      */
-    onWaiting(callback?: () => void): void
+    onWaiting(callback?: InnerAudioContext.OnWaitingCallback): void
     /** 音频进行 seek 操作事件
      * @supported weapp, h5, rn
      */
-    onSeeking(callback?: () => void): void
+    onSeeking(callback?: InnerAudioContext.OnSeekingCallback): void
     /** 音频完成 seek 操作事件
      * @supported weapp, h5, rn
      */
-    onSeeked(callback?: () => void): void
-    /** 取消监听 onCanplay 事件
+    onSeeked(callback?: InnerAudioContext.OnSeekedCallback): void
+    /** 取消监听 canplay 事件
      * @supported weapp, h5, rn
      */
-    offCanplay(callback?: () => void): void
-    /** 取消监听 onPlay 事件
+    offCanplay(callback?: InnerAudioContext.OnCanplayCallback): void
+    /** 取消监听 play 事件
      * @supported weapp, h5, rn
      */
-    offPlay(callback?: () => void): void
-    /** 取消监听 onPause 事件
+    offPlay(callback?: InnerAudioContext.OnPlayCallback): void
+    /** 取消监听 pause 事件
      * @supported weapp, h5, rn
      */
-    offPause(callback?: () => void): void
-    /** 取消监听 onStop 事件
+    offPause(callback?: InnerAudioContext.OnPauseCallback): void
+    /** 取消监听 stop 事件
      * @supported weapp, h5, rn
      */
-    offStop(callback?: () => void): void
-    /** 取消监听 onEnded 事件
+    offStop(callback?: InnerAudioContext.OnStopCallback): void
+    /** 取消监听 ended 事件
      * @supported weapp, h5, rn
      */
-    offEnded(callback?: () => void): void
-    /** 取消监听 onTimeUpdate 事件
+    offEnded(callback?: InnerAudioContext.OnEndedCallback): void
+    /** 取消监听 timeUpdate 事件
      * @supported weapp, h5, rn
      */
-    offTimeUpdate(callback?: () => void): void
-    /** 取消监听 onError 事件
+    offTimeUpdate(callback?: InnerAudioContext.OnTimeUpdateCallback): void
+    /** 取消监听 error 事件
      * @supported weapp, h5, rn
      */
-    offError(callback?: () => void): void
-    /** 取消监听 onWaiting 事件
+    offError(callback?: InnerAudioContext.OnErrorCallback): void
+    /** 取消监听 waiting 事件
      * @supported weapp, h5, rn
      */
-    offWaiting(callback?: () => void): void
-    /** 取消监听 onSeeking 事件
+    offWaiting(callback?: InnerAudioContext.OnWaitingCallback): void
+    /** 取消监听 seeking 事件
      * @supported weapp, h5, rn
      */
-    offSeeking(callback?: () => void): void
-    /** 取消监听 onSeeked 事件
+    offSeeking(callback?: InnerAudioContext.OnSeekingCallback): void
+    /** 取消监听 seeked 事件
      * @supported weapp, h5, rn
      */
-    offSeeked(callback?: () => void): void
+    offSeeked(callback?: InnerAudioContext.OnSeekedCallback): void
   }
 
   namespace InnerAudioContext {
@@ -391,6 +391,26 @@ declare module '../../index' {
       /** 未知错误 */
       '-1'
     }
+    /** 音频进入可以播放状态事件的回调函数 */
+    type OnCanplayCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频播放事件的回调函数 */
+    type OnPlayCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频暂停事件的回调函数 */
+    type OnPauseCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频停止事件的回调函数 */
+    type OnStopCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频自然播放结束事件的回调函数 */
+    type OnEndedCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频播放进度更新事件的回调函数 */
+    type OnTimeUpdateCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频播放错误事件的回调函数 */
+    type OnErrorCallback = (res: onErrorDetail) => void
+    /** 音频加载中事件的回调函数 */
+    type OnWaitingCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频进行 seek 操作事件的回调函数 */
+    type OnSeekingCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
+    /** 音频完成 seek 操作事件的回调函数 */
+    type OnSeekedCallback = (res: Partial<TaroGeneral.CallbackResult>) => void
   }
 
   /** MediaAudioPlayer 实例，可通过 [Taro.createMediaAudioPlayer](./createMediaAudioPlayer) 接口获取实例。

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

@@ -18,11 +18,23 @@ declare module '../../index' {
     interface Option {
       /** 需要预览的图片链接列表。 */
       urls: string[]
-      /** 当前显示图片的链接 */
-      current?: string
-      /** @support weapp 最低版本：2.13.0。是否显示长按菜单，默认值：true */
+      /**
+       * 微信端为当前显示图片的链接，支付宝端为当前显示图片的索引值
+       */
+      current?: string | number
+      /**
+       * 是否支持长按下载图片
+       * @supported alipay 基础库: 1.13.0
+       */
+      enablesavephoto?: boolean
+      /**
+       * 是否在右下角显示下载入口
+       * @supported alipay 基础库: 1.13.0
+       */
+      enableShowPhotoDownload?: boolean
+      /** @supported weapp 最低版本：2.13.0。是否显示长按菜单，默认值：true */
       showmenu?: boolean
-      /** @support weapp 最低版本：2.13.0。origin: 发送完整的referrer; no-referrer: 不发送。格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；默认值：no-referrer */
+      /** @supported weapp 最低版本：2.13.0。origin: 发送完整的referrer; no-referrer: 不发送。格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；默认值：no-referrer */
       referrerPolicy?: string
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
@@ -46,7 +58,7 @@ declare module '../../index' {
       /** 需要预览的资源列表 */
       sources: Sources[]
       /** 当前显示的资源序号，默认值：0 */
-      current?:	number
+      current?: number
       /** 是否显示长按菜单	2.13.0，默认值：true */
       showmenu?: boolean
       /** origin: 发送完整的referrer; no-referrer: 不发送。格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；默认值：no-referrer */
@@ -127,19 +139,30 @@ declare module '../../index' {
 
   namespace chooseImage {
     interface Option {
+      /** 最多可以选择的图片张数
+       * @default 9
+       * @supported weapp, alipay, swan, tt, h5, rn
+       */
+      count?: number
+      /** 所选的图片的尺寸
+       * @default ['original', 'compressed']
+       * @supported weapp, alipay, swan, tt, rn
+       */
+      sizeType?: Array<keyof sizeType>
+      /** 选择图片的来源
+       * @default ['album', 'camera']
+       * @supported weapp, alipay, swan, tt, h5, rn
+       */
+      sourceType?: Array<keyof sourceType>
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
-      /** 最多可以选择的图片张数 */
-      count?: number
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
-      /** 所选的图片的尺寸 */
-      sizeType?: Array<keyof sizeType>
-      /** 选择图片的来源 */
-      sourceType?: Array<keyof sourceType>
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
-      /** 用来上传的input元素ID（仅h5端）@supported h5 */
+      /** 用来上传的input元素ID（仅h5端
+       * @supported h5
+       */
       imageId?: string
     }
     /** 图片的尺寸 */
@@ -301,7 +324,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 保存图片到系统相册。需要[用户授权](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html) scope.writePhotosAlbum
-     * @supported weapp, rn, alipay, swan, tt
+     * @supported weapp, alipay, swan, tt, h5, rn
      * @example
      * ```tsx
      * Taro.saveImageToPhotosAlbum({
@@ -325,7 +348,7 @@ declare module '../../index' {
     previewMedia(option: previewMedia.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
-     * @supported weapp, h5, rn, alipay, swan, tt
+     * @supported weapp, alipay, swan, tt, h5, rn
      * @example
      * ```tsx
      * Taro.previewImage({
@@ -338,7 +361,7 @@ declare module '../../index' {
     previewImage(option: previewImage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 获取图片信息。网络图片需先配置download域名才能生效。
-     * @supported weapp, h5, rn, alipay, swan, tt
+     * @supported weapp, alipay, swan, tt, h5, rn
      * @example
      * ```tsx
      * Taro.getImageInfo({
@@ -377,7 +400,7 @@ declare module '../../index' {
     editImage(option: editImage.Option): Promise<editImage.SuccessCallbackResult>
 
     /** 压缩图片接口，可选压缩质量
-     * @supported weapp, rn, tt
+     * @supported weapp, tt, rn
      * @example
      * ```tsx
      * Taro.compressImage({
@@ -408,7 +431,7 @@ declare module '../../index' {
 
     /**
      * 从本地相册选择图片或使用相机拍照。
-     * @supported weapp, h5, rn, alipay, swan, tt
+     * @supported weapp, alipay, swan, tt, h5, rn
      * @example
      * ```tsx
      * Taro.chooseImage({

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

@@ -227,6 +227,14 @@ declare module '../../index' {
     toggleTorch(option?: LivePusherContext.ToggleTorchOption): void
   }
   namespace LivePlayerContext {
+    interface ExitCastingOption {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
     interface ExitFullScreenOption {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
@@ -267,6 +275,14 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
     }
+    interface ReconnectCastingOption {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void      
+    }
     interface RequestFullScreenOption {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
@@ -316,6 +332,14 @@ declare module '../../index' {
       /** 调用结果 */
       errMsg: string
     }
+    interface StartCastingOption {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
     interface StopOption {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
@@ -324,6 +348,14 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
     }
+    interface SwitchCastingOption {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
   }
 
   /** `LivePlayerContext` 实例，可通过 `Taro.createLivePlayerContext` 获取。
@@ -332,6 +364,11 @@ declare module '../../index' {
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.html
    */
   interface LivePlayerContext {
+    /** 退出投屏。仅支持在 tap 事件回调内调用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.exitCasting.html
+     */
+    exitCasting(option?: LivePlayerContext.ExitCastingOption): void
     /** 退出全屏
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.exitFullScreen.html
@@ -357,6 +394,11 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.play.html
      */
     play(option?: LivePlayerContext.PlayOption): void
+    /** 重连投屏设备。仅支持在 tap 事件回调内调用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.reconnectCasting.html
+     */
+    reconnectCasting(option?: LivePlayerContext.ReconnectCastingOption): void
     /** 进入全屏
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.requestFullScreen.html
@@ -381,11 +423,21 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.snapshot.html
      */
     snapshot(option?: LivePlayerContext.SnapshotOption): void
+    /** 开始投屏, 拉起半屏搜索设备。仅支持在 tap 事件回调内调用
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.startCasting.html
+     */
+    startCasting(option?: LivePlayerContext.StartCastingOption): void
     /** 停止
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.stop.html
      */
     stop(option?: LivePlayerContext.StopOption): void
+    /** 切换投屏设备。仅支持在 tap 事件回调内调用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/live/LivePlayerContext.switchCasting.html
+     */
+    switchCasting(option?: LivePlayerContext.SwitchCastingOption): void
   }
 
   interface TaroStatic {

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

@@ -233,30 +233,42 @@ declare module '../../index' {
 
   namespace chooseVideo {
     interface Option {
-      /** 默认拉起的是前置或者后置摄像头。部分 Android 手机下由于系统 ROM 不支持无法生效 */
+      /** 默认拉起的是前置或者后置摄像头。部分 Android 手机下由于系统 ROM 不支持无法生效
+       * @default "back"
+       * @supported weapp, h5
+       */
       camera?: keyof Camera
+      /** 是否压缩所选择的视频文件
+       * @default true
+       * @supported weapp
+       */
+      compressed?: boolean
+      /** 拍摄视频最长拍摄时间，单位秒
+       * @default 60
+       * @supported weapp
+       */
+      maxDuration?: number
+      /** 视频选择的来源
+       * @default ['album', 'camera']
+       * @supported weapp, h5
+       */
+      sourceType?: Array<keyof sourceType>
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
-      /** 是否压缩所选择的视频文件 */
-      compressed?: boolean
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
-      /** 拍摄视频最长拍摄时间，单位秒 */
-      maxDuration?: number
-      /** 视频选择的来源 */
-      sourceType?: Array<keyof sourceType>
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
     }
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 选定视频的临时文件路径 */
+      tempFilePath: string
       /** 选定视频的时间长度 */
       duration: number
-      /** 返回选定视频的高度 */
-      height: number
       /** 选定视频的数据量大小 */
       size: number
-      /** 选定视频的临时文件路径 */
-      tempFilePath: string
+      /** 返回选定视频的高度 */
+      height: number
       /** 返回选定视频的宽度 */
       width: number
       /** 调用结果 */
@@ -276,30 +288,53 @@ declare module '../../index' {
     }
   }
 
-
   namespace chooseMedia {
     interface Option {
-      /** 最多可以选择的文件个数 */
+      /** 最多可以选择的文件个数
+       * @default 9
+       * @supported weapp, h5
+       */
       count?: number
-      /** 文件类型 */
+      /** 文件类型
+       * @default ['image', 'video']
+       * @supported weapp, h5
+       */
       mediaType?: Array<keyof mediaType>
-      /** 图片和视频选择的来源 */
+      /** 图片和视频选择的来源
+       * @default ['album', 'camera']
+       * @supported weapp, h5
+       */
       sourceType?: Array<keyof sourceType>
-      /** 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 30s 之间 */
+      /** 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 60s 之间
+       * @default 10
+       * @supported weapp
+       */
       maxDuration?: number
-      /** 仅对 mediaType 为 image 时有效，是否压缩所选文件 */
+      /** 是否压缩所选文件
+       * @default ['original', 'compressed']
+       * @supported weapp
+       */
       sizeType?: Array<'original' | 'compressed'>
-      /** 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头 */
+      /** 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头
+       * @default "back"
+       * @supported weapp, h5
+       */
       camera?: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
+      /** 用来上传的input元素ID
+       * @supported h5
+       */
+      mediaId?: string
     }
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
       /** 本地临时文件列表 */
       tempFiles: ChooseMedia[]
-      /** 文件类型，有效值有 image 、video */
+      /** 文件类型，有效值有 image 、video、mix */
       type: string
     }
     /** 本地临时文件列表 */
@@ -316,6 +351,12 @@ declare module '../../index' {
       width: number
       /** 视频缩略图临时文件路径 */
       thumbTempFilePath: string
+      /** 选择的文件的类型 */
+      fileType: string
+      /** 原始的浏览器 File 对象
+       * @supported h5
+       */
+      originalFileObj?: File
     }
     interface mediaType {
       /** 只能拍摄视频或从相册选择视频 */
@@ -346,11 +387,11 @@ declare module '../../index' {
      * **Bug & Tip：**
      *
      * 1.  `tip`: camera 参数在部分 Android 手机下由于系统 ROM 不支持无法生效
-     * @supported weapp, rn
+     * @supported weapp, h5, rn
      * @example
      ```tsx
      * Taro.saveVideoToPhotosAlbum({
-     *   filePath: 'wxfile://xxx',
+     *   filePath: 'file://xxx',
      *   success: function (res) {
      *     console.log(res.errMsg)
      *   }
@@ -447,7 +488,7 @@ declare module '../../index' {
     compressVideo(option: compressVideo.Option): Promise<compressVideo.SuccessCallbackResult>
 
     /** 拍摄视频或从手机相册中选视频。
-     * @supported weapp, rn
+     * @supported weapp, h5, rn
      * @example
      * ```tsx
      * Taro.chooseVideo({
@@ -464,7 +505,7 @@ declare module '../../index' {
     chooseVideo(option: chooseVideo.Option): Promise<chooseVideo.SuccessCallbackResult>
 
     /** 拍摄或从手机相册中选择图片或视频。
-     * @supported weapp
+     * @supported weapp, h5
      * @example
      * ```tsx
      * Taro.chooseMedia({