@tarojs/taro 3.4.0-beta.2 → 3.4.2

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

@@ -72,11 +72,11 @@ declare module '../../index' {
       /** 选定音频的长度（单位：s），只有在音乐播放中时返回 */
       duration: number
       /** 播放状态 */
-      status: keyof status
+      status: keyof Status
       /** 调用结果 */
       errMsg: string
     }
-    interface status {
+    interface Status {
       /** 暂停中 */
       0
       /** 播放中 */
@@ -86,84 +86,90 @@ declare module '../../index' {
     }
   }
 
-  /** BackgroundAudioManager 实例，可通过 [Taro.getBackgroundAudioManager](https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html) 获取。
+  /** BackgroundAudioManager 实例，可通过 [Taro.getBackgroundAudioManager](/docs/apis/media/background-audio/getBackgroundAudioManager) 获取。
    * @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.coverImgUrl = 'https://y.gtimg.cn/music/photo_new/T002R300x300M000003rsKF44GyaSk.jpg?max_age=2592000'
    * // 设置了 src 之后会自动播放
-   * backgroundAudioManager.src = 'http://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46'
+   * backgroundAudioManager.src = 'https://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46'
    * ```
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/BackgroundAudioManager.html
    */
   interface BackgroundAudioManager {
-    /** 音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
-     * @readonly
-     */
-    buffered: number
+    /** 音频的数据源（[2.2.3](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 开始支持云文件ID）。默认为空字符串，**当设置了新的 src 时，会自动开始播放**，目前支持的格式有 m4a, aac, mp3, wav。 */
+    src: string
+    /** 音频开始播放的位置（单位：s）。 */
+    startTime: number
+    /** 音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。 */
+    title: string
+    /** 专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    epname: string
+    /** 歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    singer: string
     /** 封面图 URL，用于做原生音频播放器背景图。原生音频播放器中的分享功能，分享出去的卡片配图及背景也将使用该图。 */
     coverImgUrl: string
-    /** 当前音频的播放位置（单位：s），只有在有合法 src 时返回。
-     * @readonly
+    /** 页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    webUrl: string
+    /** 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。 */
+    protocol: string
+    /** 播放速度。范围 0.5-2.0。
+     * @default 1
      */
-    currentTime: number
+    playbackRate?: number
     /** 当前音频的长度（单位：s），只有在有合法 src 时返回。
      * @readonly
      */
     duration: number
-    /** 专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    epname: string
+    /** 当前音频的播放位置（单位：s），只有在有合法 src 时返回。
+     * @readonly
+     */
+    currentTime: number
     /** 当前是否暂停或停止。
      * @readonly
      */
     paused: boolean
-    /** 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。 */
-    protocol: string
-    /** 歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    singer: string
-    /** 音频的数据源（[2.2.3](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 开始支持云文件ID）。默认为空字符串，**当设置了新的 src 时，会自动开始播放**，目前支持的格式有 m4a, aac, mp3, wav。 */
-    src: string
-    /** 音频开始播放的位置（单位：s）。 */
-    startTime: number
-    /** 音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。 */
-    title: string
-    /** 页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    webUrl: string
+    /** 音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
+     * @readonly
+     */
+    buffered: number
+    /** origin: 发送完整的 referrer; no-referrer: 不发送 */
+    referrerPolicy?: 'origin' | 'no-referrer' | string
     /** 播放 */
     play(): void
     /** 暂停 */
     pause(): void
-    /** 停止 */
-    stop(): void
     /** 跳转到指定位置，单位 s */
     seek(position: any): void
+    /** 停止 */
+    stop(): void
     /** 背景音频进入可以播放状态，但不保证后面可以流畅播放 */
     onCanplay(callback?: () => void): void
+    /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发 */
+    onWaiting(callback?: () => void): void
+    /** 背景音频播放错误事件 */
+    onError(callback?: () => void): void
     /** 背景音频播放事件 */
     onPlay(callback?: () => void): void
     /** 背景音频暂停事件 */
     onPause(callback?: () => void): void
-    /** 背景音频停止事件 */
-    onStop(callback?: () => void): void
+    /** 背景音频开始跳转操作事件 */
+    onSeeking(callback?: () => void): void
+    /** 背景音频完成跳转操作事件 */
+    onSeeked(callback?: () => void): void
     /** 背景音频自然播放结束事件 */
     onEnded(callback?: () => void): void
+    /** 背景音频停止事件 */
+    onStop(callback?: () => void): void
     /** 背景音频播放进度更新事件 */
     onTimeUpdate(callback?: () => void): void
     /** 用户在系统音乐播放面板点击上一曲事件（iOS only） */
     onPrev(callback?: () => void): void
     /** 用户在系统音乐播放面板点击下一曲事件（iOS only） */
     onNext(callback?: () => void): void
-    /** 背景音频播放错误事件 */
-    onError(callback?: () => void): void
-    /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发 */
-    onWaiting(callback?: () => void): void
-    /** 背景音频开始跳转操作事件 */
-    onSeeking(callback?: () => void): void
-    /** 背景音频完成跳转操作事件 */
-    onSeeked(callback?: () => void): void
   }
 
   interface TaroStatic {
@@ -246,7 +252,7 @@ declare module '../../index' {
     ): void
 
     /** 获取后台音乐播放状态。
-     * **注意：1.2.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.getBackgroundAudioManager](https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/wx.getBackgroundAudioManager.html) 接口**
+     * **注意：1.2.0 版本开始，本接口不再维护。建议使用能力更强的 [Taro.getBackgroundAudioManager](/docs/apis/media/background-audio/getBackgroundAudioManager) 接口**
      * @supported weapp
      * @example
      * ```tsx
@@ -275,8 +281,8 @@ declare module '../../index' {
      * 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 之后会自动播放
+     * backgroundAudioManager.coverImgUrl = 'https://y.gtimg.cn/music/photo_new/T002R300x300M000003rsKF44GyaSk.jpg?max_age=2592000'
+     * backgroundAudioManager.src = 'https://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
      */

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

@@ -5,26 +5,11 @@ declare module '../../index' {
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.html
    */
   interface CameraContext {
-    /** 开始录像
-     * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.startRecord.html
-     */
-    startRecord(option: CameraContext.StartRecordOption): void
-    /** 结束录像
-     * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.stopRecord.html
-     */
-    stopRecord(option?: CameraContext.StopRecordOption): void
-    /** 拍摄照片
-     * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.takePhoto.html
-     */
-    takePhoto(option: CameraContext.TakePhotoOption): void
     /** 获取 Camera 实时帧数据
      *
      * ****
      *
-     * 注： 使用该接口需同时在 [camera](https://developers.weixin.qq.com/miniprogram/dev/component/camera.html) 组件属性中指定 frame-size。
+     * 注： 使用该接口需同时在 [camera](/docs/components/media/camera) 组件属性中指定 frame-size。
      * @supported weapp
      * @example
      * ```tsx
@@ -40,9 +25,43 @@ declare module '../../index' {
       /** 回调函数 */
       callback: CameraContext.OnCameraFrameCallback,
     ): CameraFrameListener
+    /** 设置缩放级别
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.setZoom.html
+     */
+    setZoom(option: CameraContext.SetZoomOption): void
+    /** 开始录像
+     * @supported weapp, rn
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.startRecord.html
+     */
+    startRecord(option: CameraContext.StartRecordOption): void
+    /** 结束录像
+     * @supported weapp, rn
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.stopRecord.html
+     */
+    stopRecord(option?: CameraContext.StopRecordOption): void
+    /** 拍摄照片
+     * @supported weapp, rn
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/camera/CameraContext.takePhoto.html
+     */
+    takePhoto(option: CameraContext.TakePhotoOption): void
   }
 
   namespace CameraContext {
+    interface SetZoomOption {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: StartRecordSuccessCallbackResult) => void
+      /** 缩放级别，范围[1, maxZoom]。zoom 可取小数，精确到小数后一位。maxZoom 可在 bindinitdone 返回值中获取。 */
+      zoom: number
+    }
+    interface StartRecordSuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 实际设置的缩放级别。由于系统限制，某些机型可能无法设置成指定值，会改用最接近的可设值。 */
+      zoom: number
+    }
     interface StartRecordOption {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
@@ -85,7 +104,7 @@ declare module '../../index' {
       /** 接口调用失败的回调函数 */
       fail?: (res: TaroGeneral.CallbackResult) => void
       /** 成像质量 */
-      quality?: keyof quality
+      quality?: keyof Quality
       /** 接口调用成功的回调函数 */
       success?: (result: TakePhotoSuccessCallbackResult) => void
     }
@@ -105,7 +124,7 @@ declare module '../../index' {
       /** 图像数据矩形的宽度 */
       width: number
     }
-    interface quality {
+    interface Quality {
       /** 高质量 */
       high
       /** 普通质量 */
@@ -152,7 +171,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 创建 camera 上下文 CameraContext 对象。
-     * @supported weapp
+     * @supported weapp, rn
      * @example
      * ```tsx
      * const cameraContext = Taro.createCameraContext()

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

@@ -3,6 +3,7 @@ import Taro from '../../index'
 declare module '../../index' {
   /** `EditorContext` 实例，可通过 `Taro.createSelectorQuery` 获取。
    * `EditorContext` 通过 `id` 跟一个 `editor` 组件绑定，操作对应的 `editor` 组件。
+   * @supported weapp
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/editor/EditorContext.html
    */
   interface EditorContext {
@@ -59,6 +60,11 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/editor/EditorContext.getContents.html
      */
     getContents(option?: EditorContext.GetContentsOption): void
+    /** 获取编辑器已选区域内的纯文本内容。当编辑器失焦或未选中一段区间时，返回内容为空。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/editor/EditorContext.getSelectionText.html
+     */
+    getSelectionText(option?: EditorContext.getSelectionText.Option): void
     /** 插入分割线
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/editor/EditorContext.insertDivider.html
@@ -66,9 +72,9 @@ declare module '../../index' {
     insertDivider(option?: EditorContext.InsertDividerOption): void
     /** 插入图片。
      *
-     * 地址为临时文件时，获取的编辑器html格式内容中 <img> 标签增加属性 data-local，delta 格式内容中图片 attributes 属性增加 data-local 字段，该值为传入的临时文件地址。
+     * 地址为临时文件时，获取的编辑器html格式内容中 `<img>` 标签增加属性 data-local，delta 格式内容中图片 attributes 属性增加 data-local 字段，该值为传入的临时文件地址。
      *
-     * 开发者可选择在提交阶段上传图片到服务器，获取到网络地址后进行替换。替换时对于html内容应替换掉 <img> 的 src 值，对于 delta 内容应替换掉 `insert { image: abc }` 值。
+     * 开发者可选择在提交阶段上传图片到服务器，获取到网络地址后进行替换。替换时对于html内容应替换掉 `<img>` 的 src 值，对于 delta 内容应替换掉 `insert { image: abc }` 值。
      * @supported weapp
      * @example
      * ```tsx
@@ -139,6 +145,20 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.CallbackResult) => void
     }
+    namespace getSelectionText {
+      interface Option {
+        /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+        complete?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用失败的回调函数 */
+        fail?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用成功的回调函数 */
+        success?: (res: SuccessCallbackResult) => void
+      }
+      interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+        /** 纯文本内容 */
+        text: string
+      }
+    }
     interface InsertDividerOption {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void

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

@@ -77,7 +77,7 @@ declare module '../../index' {
       /** [拍照时设备方向](http://sylvana.net/jpegcrop/exif_orientation.html)
        * @default "up"
        */
-      orientation: keyof orientation
+      orientation: keyof Orientation
       /** 图片的本地路径 */
       path: string
       /** 图片格式 */
@@ -88,7 +88,7 @@ declare module '../../index' {
       errMsg: string
     }
 
-    interface orientation {
+    interface Orientation {
       /** 默认方向（手机横持拍照），对应 Exif 中的 1。或无 orientation 信息。 */
       'up'
       /** 同 up，但镜像翻转，对应 Exif 中的 2 */
@@ -108,6 +108,23 @@ declare module '../../index' {
     }
   }
 
+  namespace editImage {
+    interface Option {
+      /** 图片路径，图片的路径，支持本地路径、代码包路径 */
+      src: string
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (result: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 编辑后图片的临时文件路径 (本地路径) */
+      tempFilePath: string
+    }
+  }
+
   namespace chooseImage {
     interface Option {
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
@@ -202,7 +219,7 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
       /** 所选的文件的类型  */
-      type?: keyof selectType
+      type?: keyof SelectType
     }
     interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
       /** 返回选择的文件的本地临时文件对象数组 */
@@ -221,9 +238,9 @@ declare module '../../index' {
       /** 选择的文件的会话发送时间，Unix时间戳，工具暂不支持此属性 */
       time: number
       /** 选择的文件类型  */
-      type: keyof selectedType
+      type: keyof SelectedType
     }
-    interface selectType {
+    interface SelectType {
       /** 从所有文件选择 */
       all
       /** 只能选择视频文件 */
@@ -233,7 +250,7 @@ declare module '../../index' {
       /** 可以选择除了图片和视频之外的其它的文件 */
       file
     }
-    interface selectedType {
+    interface SelectedType {
       /** 选择了视频文件 */
       video
       /** 选择了图片文件 */
@@ -243,66 +260,6 @@ declare module '../../index' {
     }
   }
 
-  namespace chooseMedia {
-    interface Option {
-      /** 最多可以选择的文件个数 */
-      count?: number
-      /** 文件类型 */
-      mediaType?: Array<keyof mediaType>
-      /** 图片和视频选择的来源 */
-      sourceType?: Array<keyof sourceType>
-      /** 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 30s 之间 */
-      maxDuration?: number
-      /** 仅对 mediaType 为 image 时有效，是否压缩所选文件 */
-      sizeType?: Array<'original' | 'compressed'>
-      /** 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头 */
-      camera?: string
-      /** 接口调用失败的回调函数 */
-      fail?: (res: TaroGeneral.CallbackResult) => void
-      /** 接口调用成功的回调函数 */
-      success?: (result: SuccessCallbackResult) => void
-    }
-    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
-      /** 本地临时文件列表 */
-      tempFiles: ChooseMedia[]
-      /** 文件类型，有效值有 image 、video */
-      type: string
-    }
-    /** 本地临时文件列表 */
-    interface ChooseMedia {
-      /** 本地临时文件路径 (本地路径) */
-      tempFilePath: string
-      /** 本地临时文件大小，单位 B */
-      size: number
-      /** 视频的时间长度 */
-      duration: number
-      /** 视频的高度 */
-      height: number
-      /** 视频的宽度 */
-      width: number
-      /** 视频缩略图临时文件路径 */
-      thumbTempFilePath: string
-    }
-    interface mediaType {
-      /** 只能拍摄视频或从相册选择视频 */
-      video
-      /** 只能拍摄图片或从相册选择图片 */
-      image
-    }
-    interface sourceType {
-      /** 从相册选择 */
-      album
-      /** 使用相机拍摄 */
-      camera
-    }
-    interface camera {
-      /** 使用后置摄像头 */
-      back
-      /** 使用前置摄像头 */
-      front
-    }
-  }
-
   interface TaroStatic {
     /** 保存图片到系统相册。需要[用户授权](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html) scope.writePhotosAlbum
      * @supported weapp, rn, alipay, swan
@@ -316,6 +273,18 @@ declare module '../../index' {
      */
     saveImageToPhotosAlbum(option: saveImageToPhotosAlbum.Option): Promise<TaroGeneral.CallbackResult>
 
+    /** 预览图片和视频。
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.previewMedia({
+     *   sources: []
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.previewMedia.html
+     */
+    previewMedia(option: previewMedia.Option): Promise<TaroGeneral.CallbackResult>
+
     /** 在新页面中全屏预览图片。预览的过程中用户可以进行保存图片、发送给朋友等操作。
      * @supported weapp, h5, rn, alipay, swan
      * @example
@@ -329,18 +298,6 @@ declare module '../../index' {
      */
     previewImage(option: previewImage.Option): Promise<TaroGeneral.CallbackResult>
 
-    /** 预览图片和视频。
-     * @supported weapp 基础库 2.12.0 开始支持，低版本需做兼容处理。
-     * @example
-     * ```tsx
-     * Taro.previewMedia({
-     *   sources: []
-     * })
-     * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.previewMedia.html
-     */
-    previewMedia(option: previewMedia.Option): Promise<TaroGeneral.CallbackResult>
-
     /** 获取图片信息。网络图片需先配置download域名才能生效。
      * @supported weapp, h5, rn, alipay, swan
      * @example
@@ -368,27 +325,20 @@ declare module '../../index' {
      */
     getImageInfo(option: getImageInfo.Option): Promise<getImageInfo.SuccessCallbackResult>
 
-    /**
-     * 从本地相册选择图片或使用相机拍照。
-     * @supported weapp, h5, rn, alipay, swan
+    /** 编辑图片接口
+     * @supported weapp
      * @example
      * ```tsx
-     * Taro.chooseImage({
-     *   count: 1, // 默认9
-     *   sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
-     *   sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有，在H5浏览器端支持使用 `user` 和 `environment`分别指定为前后摄像头
-     *   success: function (res) {
-     *     // 返回选定照片的本地文件路径列表，tempFilePath可以作为img标签的src属性显示图片
-     *     var tempFilePaths = res.tempFilePaths
-     *   }
+     * Taro.editImage({
+     *   src: '', // 图片路径
      * })
      * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.editImage.html
      */
-    chooseImage(option: chooseImage.Option): Promise<chooseImage.SuccessCallbackResult>
+    editImage(option: editImage.Option): Promise<editImage.SuccessCallbackResult>
 
     /** 压缩图片接口，可选压缩质量
-     * @supported weapp
+     * @supported weapp, rn
      * @example
      * ```tsx
      * Taro.compressImage({
@@ -417,24 +367,23 @@ declare module '../../index' {
      */
     chooseMessageFile(option: chooseMessageFile.Option): Promise<chooseMessageFile.SuccessCallbackResult>
 
-    /** 拍摄或从手机相册中选择图片或视频。
-     * @supported weapp, rn
+    /**
+     * 从本地相册选择图片或使用相机拍照。
+     * @supported weapp, h5, rn, alipay, swan
      * @example
      * ```tsx
-     * Taro.chooseMedia({
-     *   count: 9,
-     *   mediaType: ['image','video'],
-     *   sourceType: ['album', 'camera'],
-     *   maxDuration: 30,
-     *   camera: 'back',
-     *   success: (res) => {
-     *     console.log(res.tempFiles)
-     *     console.log(res.type)
+     * Taro.chooseImage({
+     *   count: 1, // 默认9
+     *   sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
+     *   sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有，在H5浏览器端支持使用 `user` 和 `environment`分别指定为前后摄像头
+     *   success: function (res) {
+     *     // 返回选定照片的本地文件路径列表，tempFilePath可以作为img标签的src属性显示图片
+     *     var tempFilePaths = res.tempFilePaths
      *   }
      * })
      * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseImage.html
      */
-    chooseMedia(option: chooseMedia.Option): Promise<chooseMedia.SuccessCallbackResult>
+    chooseImage(option: chooseImage.Option): Promise<chooseImage.SuccessCallbackResult>
   }
 }