@tarojs/taro 3.7.0-alpha.19 → 3.7.0-alpha.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.7.0-alpha.19",
+  "version": "3.7.0-alpha.20",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -21,12 +21,12 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.7.0-alpha.19",
-    "@tarojs/runtime": "3.7.0-alpha.19"
+    "@tarojs/api": "3.7.0-alpha.20",
+    "@tarojs/runtime": "3.7.0-alpha.20"
   },
   "devDependencies": {
-    "@tarojs/helper": "3.7.0-alpha.19",
-    "@tarojs/shared": "3.7.0-alpha.19"
+    "@tarojs/helper": "3.7.0-alpha.20",
+    "@tarojs/shared": "3.7.0-alpha.20"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/types/api/ai/visionkit.d.ts

@@ -3,7 +3,7 @@ import Taro from '../../index'
 declare module '../../index' {
   namespace isVKSupport {
     /** vision kit 版本 */
-    interface Version {
+    interface IVersion {
       /** 旧版本 */
       v1
       /** v2 版本，目前只有 iOS 基础库 2.22.0 以上支持 */
@@ -12,24 +12,24 @@ declare module '../../index' {
   }
   namespace createVKSession {
     /** vision kit 版本 */
-    interface Version {
+    interface IVersion {
       /** 旧版本 */
       v1
       /** v2 版本，目前只有 iOS 基础库 2.22.0 以上支持 */
       v2
     }
     /** 跟踪配置 */
-    interface Track {
+    interface ITrack {
       /** 平面跟踪配置 */
-      plane: Plane
+      plane: IPlane
     }
     /** 平面跟踪配置 */
-    interface Plane {
+    interface IPlane {
       /** 平面跟踪配置模式 */
-      mode: keyof PlaneMode
+      mode: keyof IPlaneMode
     }
     /** 平面跟踪配置模式合法值 */
-    interface PlaneMode {
+    interface IPlaneMode {
       /** 检测横向平面 */
       1
       /** 检测纵向平面，只有 v2 版本支持 */
@@ -41,33 +41,59 @@ declare module '../../index' {
 
   /** anchor 对象，只有 v2 版本支持
    * @supported weapp
-   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKAnchor.html
+   * @ignore
    */
-  interface VKAnchor {
+  type VKAnchor = VKBodyAnchor | VKDepthAnchor | VKFaceAnchor | VKHandAnchor | VKMarkerAnchor | VKOCRAnchor | VKPlaneAnchor
+
+  /** 人体 anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKBodyAnchor.html
+   */
+  interface VKBodyAnchor {
     /** 唯一标识 */
     id: number
     /** 类型 */
-    type: keyof VKAnchor.Type
-    /** 包含位置、旋转、放缩信息的矩阵，以列为主序 */
-    transform: Float32Array
-    /** 尺寸，只有平面 anchor 支持 */
-    size: VKAnchor.Size
-    /** 方向，只有平面 anchor 支持 */
-    alignment: number
+    type: keyof VKBodyAnchor.IType
+    /** 识别序号 */
+    detectId: number
+    /** 相对视窗的尺寸，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    size: VKBodyAnchor.ISize
+    /** 相对视窗的位置信息，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    origin: VKBodyAnchor.IOrigin
+    /** 关键点的置信度 */
+    confidence: number[]
+    /** 关键点 */
+    points: VKBodyAnchor.IPoint[]
+    /** 总体置信值 */
+    score: number
   }
-  namespace VKAnchor {
-    /** anchor 对象类型合法值 */
-    interface Type {
-      /** 平面 */
-      0
+  namespace VKBodyAnchor {
+    /** 类型 */
+    interface IType {
+      /** 人体 */
+      5
     }
-    /** anchor 对象类型合法值 */
-    interface Size {
+    /** 相对视窗的尺寸*/
+    interface ISize {
       /** 宽度 */
       width: number
       /** 高度 */
       height: number
     }
+    /** 相对视窗的位置信息 */
+    interface IOrigin {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
+    /** 关键点 */
+    interface IPoint {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
   }
 
   /** 相机对象
@@ -91,6 +117,296 @@ declare module '../../index' {
     ): Float32Array
   }
 
+  /** depth anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKDepthAnchor.html
+   */
+  interface VKDepthAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKDepthAnchor.IType
+    /** 相对视窗的尺寸，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    size: VKDepthAnchor.ISize
+    /** 包含深度信息的数组 */
+    depthArray: number[]
+  }
+  namespace VKDepthAnchor {
+    /** 类型 */
+    interface IType {
+      /** DEPTH */
+      8
+    }
+    /** 相对视窗的尺寸 */
+    interface ISize {
+      /** 宽度 */
+      width: number
+      /** 高度 */
+      height: number
+    }
+  }
+
+  /** 人脸 anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKFaceAnchor.html
+   */
+  interface VKFaceAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKFaceAnchor.IType
+    /** 识别序号 */
+    detectId: number
+    /** 相对视窗的位置信息，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    origin: VKFaceAnchor.IOrigin
+    /** 相对视窗的尺寸，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    size: VKFaceAnchor.ISize
+    /** 人脸 106 个关键点的坐标 */
+    points: VKFaceAnchor.IPoint[]
+    /** 人脸角度信息 */
+    angle: number[]
+    /** 关键点的置信度 */
+    confidence: number
+  }
+  namespace VKFaceAnchor {
+    /** 类型 */
+    interface IType {
+      /** 人脸 */
+      3
+    }
+    /** 相对视窗的尺寸*/
+    interface ISize {
+      /** 宽度 */
+      width: number
+      /** 高度 */
+      height: number
+    }
+    /** 相对视窗的位置信息 */
+    interface IOrigin {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
+    /** 关键点 */
+    interface IPoint {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
+  }
+
+  /** 手势 anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKHandAnchor.html
+   */
+  interface VKHandAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKHandAnchor.IType
+    /** 识别序号 */
+    detectId: number
+    /** 相对视窗的尺寸，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    size: VKHandAnchor.ISize
+    /** 相对视窗的位置信息，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    origin: VKHandAnchor.IOrigin
+    /** 关键点的置信度 */
+    confidence: number[]
+    /** 关键点 */
+    points: VKHandAnchor.IPoint[]
+    /** 总体置信值 */
+    score: number
+    /** 手势分类, 返回整数 -1 到 18, -1 表示无效手势 */
+    gesture: keyof VKHandAnchor.IGesture | -1
+  }
+  namespace VKHandAnchor {
+    /** 类型 */
+    interface IType {
+      /** 手势 */
+      7
+    }
+    /** 相对视窗的尺寸*/
+    interface ISize {
+      /** 宽度 */
+      width: number
+      /** 高度 */
+      height: number
+    }
+    /** 相对视窗的位置信息 */
+    interface IOrigin {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
+    /** 关键点 */
+    interface IPoint {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
+    /** 手势分类 */
+    interface IGesture {
+      /**单手比心 */
+      0
+      /** 布（数字5）*/
+      1
+      /** 剪刀（数字2） */
+      2
+      /** 握拳 */
+      3
+      /** 数字1 */
+      4
+      /** 热爱 */
+      5
+      /** 点赞 */
+      6
+      /** 数字3 */
+      7
+      /** 摇滚 */
+      8
+      /** 数字6 */
+      9
+      /** 数字8 */
+      10
+      /** 双手抱拳（恭喜发财） */
+      11
+      /** 数字4 */
+      12
+      /** 比ok */
+      13
+      /** 不喜欢（踩） */
+      14
+      /** 双手比心 */
+      15
+      /** 祈祷（双手合十） */
+      16
+      /** 双手抱拳 */
+      17
+      /** 无手势动作 */
+      18
+    }
+  }
+
+  /** marker anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKMarkerAnchor.html
+   */
+  interface VKMarkerAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKMarkerAnchor.IType
+    /** 包含位置、旋转、放缩信息的矩阵，以列为主序 */
+    transform: Float32Array
+    /** marker id */
+    markerId: number
+    /** 图片路径 */
+    path: string
+  }
+  namespace VKMarkerAnchor {
+    /** 类型 */
+    interface IType {
+      /** marker */
+      1
+    }
+  }
+
+  /** OCR anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKOCRAnchor.html
+   */
+  interface VKOCRAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKOCRAnchor.IType
+    /** 识别的文字结果 */
+    text: string
+  }
+  namespace VKOCRAnchor {
+    /** 类型 */
+    interface IType {
+      /** OCR */
+      6
+    }
+  }
+
+  /** OSD anchor
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKOSDAnchor.html
+   */
+  interface VKOSDAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKOSDAnchor.IType
+    /** marker id */
+    markerId: number
+    /** 相对视窗的尺寸，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘*/
+    size: VKOSDAnchor.ISize
+    /** 图片路径 */
+    path: string
+    /** 相对视窗的位置信息，取值范围为 [0, 1]，0 为左/上边缘，1 为右/下边缘 */
+    origin: VKOSDAnchor.IOrigin
+  }
+  namespace VKOSDAnchor {
+    /** 类型 */
+    interface IType {
+      /** OSD */
+      2
+    }
+    /** 相对视窗的尺寸*/
+    interface ISize {
+      /** 宽度 */
+      width: number
+      /** 高度 */
+      height: number
+    }
+    /** 相对视窗的位置信息 */
+    interface IOrigin {
+      /** 横坐标 */
+      x: number
+      /** 纵坐标 */
+      y: number
+    }
+  }
+
+  /** 平面 anchor，只有 v2 版本支持
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKPlaneAnchor.html
+   */
+  interface VKPlaneAnchor {
+    /** 唯一标识 */
+    id: number
+    /** 类型 */
+    type: keyof VKPlaneAnchor.IType
+    /** 包含位置、旋转、放缩信息的矩阵，以列为主序 */
+    transform: Float32Array
+    /** 尺寸 */
+    size: VKPlaneAnchor.ISize
+    /** 方向 */
+    alignment: number
+  }
+
+  namespace VKPlaneAnchor {
+    /** 类型 */
+    interface IType {
+      /** 平面 */
+      0
+    }
+    /** 相对视窗的尺寸*/
+    interface ISize {
+      /** 宽度 */
+      width: number
+      /** 高度 */
+      height: number
+    }
+  }
+
   /** vision kit 会话对象
    * @supported weapp
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKFrame.html
@@ -104,7 +420,14 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKFrame.getCameraTexture.html
      */
-    getCameraTexture(ctx: WebGLRenderingContext): VKFrame.getCameraTextureResult
+    getCameraTexture(ctx: WebGLRenderingContext): VKFrame.IGetCameraTextureResult
+    /** 获取当前帧 rgba buffer。iOS 端微信在 v8.0.20 开始支持，安卓端微信在 v8.0.30 开始支持。
+     *  按 aspect-fill 规则裁剪，此接口要求在创建 VKSession 对象时必须传入 gl 参数。
+     *  此接口仅建议拿来做帧分析使用，上屏请使用 getCameraTexture 来代替。
+     *  @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKFrame.getCameraBuffer.html
+     */
+    getCameraBuffer(widht: number, height: number): ArrayBuffer
     /** 获取纹理调整矩阵。默认获取到的纹理是未经裁剪调整的纹理，此矩阵可用于在着色器中根据帧对象尺寸对纹理进行裁剪
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKFrame.getDisplayTransform.html
@@ -114,7 +437,7 @@ declare module '../../index' {
 
   namespace VKFrame {
     /** 帧纹理对象 */
-    interface getCameraTextureResult {
+    interface IGetCameraTextureResult {
       /** Y 分量纹理 */
       yTexture: WebGLTexture
       /** UV 分量纹理 */
@@ -128,11 +451,27 @@ declare module '../../index' {
    */
   interface VKSession {
     /** 会话状态 */
-    state: keyof VKSession.State
+    state: keyof VKSession.IState
     /** 会话配置 */
-    config: VKSession.Config
+    config: VKSession.IConfig
     /** 相机尺寸 */
-    cameraSize: VKSession.Size
+    cameraSize: VKSession.ISize
+    /** 添加一个 marker，要求调 Taro.createVKSession 时传入的 track.marker 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.addMarker.html
+     */
+    addMarker(
+      /** 图片路径，目前只支持本地用户图片 */
+      path: string
+    ): number
+    /** 添加一个 OSD marker（one-shot detection marker），要求调 Taro.createVKSession 时传入的 track.OSD 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.addOSDMarker.html
+     */
+    addOSDMarker(
+      /** 图片路径，目前只支持本地用户图片 */
+      path: string
+    ): number
     /** 取消由 requestAnimationFrame 添加到计划中的动画帧请求
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.cancelAnimationFrame.html
@@ -143,6 +482,36 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.destroy.html
      */
     destroy(): void
+    /** 静态图像人体关键点检测。当 Taro.createVKSession 参数传入 {track: {body: {mode: 2} } } 时可用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.detectBody.html
+     */
+    detectBody(option: VKSession.IDetectBodyOption): void
+    /** 深度识别。当 Taro.createVKSession 参数传入 {track: {depth: {mode: 2} } } 时可用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.detectDepth.html
+     */
+    detectDepth(option: VKSession.IDetectDepthOption): void
+    /** 静态图像人脸关键点检测。当 Taro.createVKSession 参数传入 {track: {face: {mode: 2} } } 时可用。安卓微信8.0.25开始支持，iOS微信8.0.24开始支持。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.detectFace.html
+     */
+    detectFace(option: VKSession.IDetectFaceOption): void
+    /** 静态图像手势关键点检测。当 Taro.createVKSession 参数传入 {track: {hand: {mode: 2} } } 时可用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.detectHand.html
+     */
+    detectHand(option: VKSession.IDetectHandOption): void
+    /** 获取所有 marker，要求调 Taro.createVKSession 时传入的 track.marker 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.getAllMarker.html
+     */
+    getAllMarker(): VKSession.IMarker[]
+    /** 获取所有 OSD marker，要求调 Taro.createVKSession 时传入的 track.OSD 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.getAllOSDMarker.html
+     */
+    getAllOSDMarker(): VKSession.IOSDMarker[]
     /** 获取帧对象，每调用一次都会触发一次帧分析过程
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.getVKFrame.html
@@ -166,7 +535,7 @@ declare module '../../index' {
      y: number,
      /** 是否需要重新识别其他平面，v2 版本不再需要此参数 */
      reset?: boolean
-    ): VKSession.hitTestResult[]
+    ): VKSession.IHitTestResult[]
     /** 取消监听会话事件。
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.off.html
@@ -175,7 +544,7 @@ declare module '../../index' {
      /** 事件名称 */
      eventName: string,
      /** 事件监听函数 */
-     fn: Function
+     fn: TaroGeneral.EventCallback
     ): void
     /** 监听会话事件。
      * @supported weapp
@@ -183,68 +552,125 @@ declare module '../../index' {
      */
     on(
      /** 事件名称 */
-     eventName: string,
+     eventName: 'resize' | 'addAnchors' | 'updateAnchors' | 'removeAnchors' | string,
      /** 事件监听函数 */
-     fn: Function
+     fn: TaroGeneral.EventCallback
     ): void
+    /** 删除一个 marker，要求调 Taro.createVKSession 时传入的 track.marker 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.removeMarker.html
+     */
+    removeMarker(
+      /** marker id */
+      markerId: number
+    ): number
+    /** 删除一个 OSD marker，要求调 Taro.createVKSession 时传入的 track.OSD 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.removeOSDMarker.html
+     */
+    removeOSDMarker(
+      /** marker id */
+      markerId: number
+    ): number
     /** 在下次进行重绘时执行。
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.requestAnimationFrame.html
      */
     requestAnimationFrame(
-     /** 执行函数 */
-     callback: Function
+      /** 执行函数 */
+      callback: TaroGeneral.TFunc
     ): number
+    /** 静态图像 OCR 检测。当 Taro.createVKSession 参数传入 {track: {OCR: {mode: 2} } } 时可用。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.runOCR.html
+     */
+    runOCR(option: VKSession.IRunOCROption): void
     /** 开启会话。
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.start.html
      */
     start(
-     /** 开启会话回调 */
-     callback: (status: keyof VKSession.StartStatus) => void
+      /** 开启会话回调 */
+      callback: (status: keyof VKSession.IStartStatus) => void
     ): void
     /** 停止会话。
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.stop.html
      */
-     stop(): void
+    stop(): void
+    /** 开启 3D 模式
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.update3DMode.html
+     */
+    update3DMode(
+      /** 是否开启 */
+      open3d: boolean
+    ): void
+    /** 更新 OSD 识别精确度，要求调 Taro.createVKSession 时传入的 track.OSD 为 true
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/VKSession.updateOSDThreshold.html
+     */
+    updateOSDThreshold(
+      /** 阈值 */
+      threshold: number
+    ): void
   }
   namespace VKSession {
     /** state 的合法值 */
-    interface State {
+    interface IState {
       /** 不可用 */
       0
       /** 运行中 */
       1
       /** 暂停中 */
       2
+      /** 初始化中 */
+      3
     }
     /** 会话配置 */
-    interface Config {
+    interface IConfig {
       /** 不可用 */
-      version: keyof version
+      version: keyof IVersion
       /** 运行中 */
-      track: track
+      track: ITrack
+      /** marker 跟踪配置，基础库(3.0.0)开始允许同时支持v2的水平面检测能力 */
+      marker: boolean
+      /** OSD 跟踪配置 */
+      OSD: boolean
+      /** 深度识别配置 */
+      depth: IDepth
+      /** 人脸检测配置。安卓微信8.0.25开始支持，iOS微信8.0.24开始支持。 */
+      face: IFace
+      /** OCR 检测配置。 */
+      OCR: IOCR
+      /** 人体检测配置。 */
+      body: IBody
+      /** 手势检测配置。 */
+      hand: IHand
+      /** 提供基础AR功能，输出相机旋转的3个自由度的位姿，利用手机陀螺仪传感器，实现快速稳定的AR定位能力，适用于简单AR场景。 */
+      threeDof: boolean
+      /** 绑定的 WebGLRenderingContext 对象 */
+      gl: WebGLRenderingContext
     }
     /** vision kit 版本 */
-    interface version {
+    interface IVersion {
       /** 旧版本 */
       v1
       /** v2 版本，目前只有 iOS 基础库 2.22.0 以上支持 */
       v2
     }
     /** 跟踪配置 */
-    interface track {
+    interface ITrack {
       /** 平面跟踪配置 */
-      plane: plane
+      plane: IPlane
     }
     /** 平面跟踪配置 */
-    interface plane {
+    interface IPlane {
       /** 平面跟踪配置模式 */
-      mode: keyof PlaneMode
+      mode: keyof IPlaneMode
     }
     /** 平面跟踪配置模式合法值 */
-    interface PlaneMode {
+    interface IPlaneMode {
       /** 检测横向平面 */
       1
       /** 检测纵向平面，只有 v2 版本支持 */
@@ -252,22 +678,167 @@ declare module '../../index' {
       /** 检测横向和纵向平面，只有 v2 版本支持 */
       3
     }
+    /** 深度识别配置 */
+    interface IDepth {
+      mode: keyof IDepthMode
+    }
+    /** 深度识别模式 */
+    interface IDepthMode {
+      /** 通过摄像头实时检测 */
+      1
+      /** 静态图片检测 */
+      2
+    }
+    /** 人脸检测模式 */
+    interface IFace {
+      mode: keyof IFaceMode
+    }
+    /** 人脸检测模式 */
+    interface IFaceMode {
+      /** 通过摄像头实时检测 */
+      1
+      /** 静态图片检测 */
+      2
+    }
+    /** OCR 检测配置 */
+    interface IOCR {
+      mode: keyof IOCRMode
+    }
+    /** OCR 检测模式 */
+    interface IOCRMode {
+      /** 通过摄像头实时检测 */
+      1
+      /** 静态图片检测 */
+      2
+    }
+    /** 人体检测模式 */
+    interface IBody {
+      mode: keyof IBodyMode
+    }
+    /** 人体检测模式 */
+    interface IBodyMode {
+      /** 通过摄像头实时检测 */
+      1
+      /** 静态图片检测 */
+      2
+    }
+    /** 手势检测配置 */
+    interface IHand {
+      mode: keyof IHandMode
+    }
+    /** 手势检测模式 */
+    interface IHandMode {
+      /** 通过摄像头实时检测 */
+      1
+      /** 静态图片检测 */
+      2
+    }
     /** 相机尺寸 */
-    interface Size {
+    interface ISize {
       /** 宽度 */
       width: number
       /** 高度 */
       height: number
     }
-
+    interface IDetectBodyOption {
+      /** 人脸图像像素点数据，每四项表示一个像素点的 RGBA */
+      frameBuffer: ArrayBuffer
+      /** 图像宽度 */
+      width: number
+      /** 图像高度 */
+      height: number
+      /** 评分阈值。正常情况传入 0.8 即可。默认值 0.8 */
+      scoreThreshold?: number
+      /** 图像源类型。正常情况传入 1 即可。当输入的图片是来自一个连续视频的每一帧图像时，sourceType 传入 0 会得到更优的效果。默认值1 */
+      sourceType?: keyof ISourceType
+    }
+    /** 图像源类型。 */
+    interface ISourceType {
+      /** 表示输入的图片是随机的图片 */
+      1
+      /** 表示输入的图片是来自一个连续视频的每一帧图像 */
+      0
+    }
+    interface IDetectDepthOption {
+      /** 人需要识别深度的图像像素点数据，每四项表示一个像素点的 RGBA */
+      frameBuffer: ArrayBuffer
+      /** 图像宽度 */
+      width: number
+      /** 图像高度 */
+      height: number
+    }
+    interface IDetectFaceOption {
+      /** 人脸图像像素点数据，每四项表示一个像素点的 RGBA */
+      frameBuffer: ArrayBuffer
+      /** 图像宽度 */
+      width: number
+      /** 图像高度 */
+      height: number
+      /** 评分阈值。正常情况传入 0.8 即可。默认值 0.8 */
+      scoreThreshold?: number
+      /** 图像源类型。正常情况传入 1 即可。当输入的图片是来自一个连续视频的每一帧图像时，sourceType 传入 0 会得到更优的效果。默认值1 */
+      sourceType?: keyof ISourceType
+      /** 算法模型类型。正常情况传入 1 即可。0、1、2 分别表示小、中、大模型，模型越大识别准确率越高，但资源占用也越高。建议根据用户设备性能进行选择。 */
+      modelModel?: keyof IModelModel
+    }
+    /** 算法模型类型 */
+    interface IModelModel {
+      /** 小模型 */
+      0
+      /** 中模型 */
+      1
+      /** 大模型 */
+      2
+    }
+    interface IDetectHandOption {
+      /** 人脸图像像素点数据，每四项表示一个像素点的 RGBA */
+      frameBuffer: ArrayBuffer
+      /** 图像宽度 */
+      width: number
+      /** 图像高度 */
+      height: number
+      /** 评分阈值。正常情况传入 0.8 即可。默认值0.8 */
+      scoreThreshold?: number
+      /** 算法检测模式 */
+      algoMode?: keyof IAlgoMode
+    }
+    /** 算法检测模式 */
+    interface IAlgoMode {
+      /** 检测模式，输出框和点 */
+      0
+      /** 手势模式，输出框和手势分类 */
+      1
+      /** 结合0和1模式，输出框、点、手势分类 */
+      2
+    }
+    interface IMarker {
+      /** marker id */
+      markerId: number
+      /** 图片路径 */
+      path: string
+    }
+    /** OSD marker */
+    interface IOSDMarker {
+      /** marker id */
+      markerId: number
+      /** 图片路径 */
+      path: string
+    }
+    interface IRunOCROption {
+      /** 待识别图像的像素点数据，每四项表示一个像素点的 RGBA */
+      frameBuffer: ArrayBuffer
+      /** 图像宽度 */
+      width: number
+      /** 图像高度 */
+      height: number
+    }
     /** hitTest 检测结果 */
-    interface hitTestResult {
+    interface IHitTestResult {
       /** 包含位置、旋转、放缩信息的矩阵，以列为主序 */
       transform: Float32Array
     }
-
     /** start status 的合法值 */
-    interface StartStatus {
+    interface IStartStatus {
       /** 成功 */
       0
       /** 系统错误 */
@@ -292,12 +863,12 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/wx.isVKSupport.html
      */
-     isVKSupport (version: keyof isVKSupport.Version): boolean /** 是否支持对应版本的 vision kit */
+     isVKSupport (version: keyof isVKSupport.IVersion): boolean /** 是否支持对应版本的 vision kit */
 
     /** 创建 vision kit 会话对象
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/visionkit/wx.createVKSession.html
      */
-    createVKSession (version: keyof createVKSession.Version): VKSession /** vision kit 会话对象 */
+    createVKSession (version: keyof createVKSession.IVersion): VKSession /** vision kit 会话对象 */
   }
 }

package/types/api/base/performance.d.ts

@@ -32,7 +32,7 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/Performance.createObserver.html
      */
-    createObserver(callback: Function): PerformanceObserver
+    createObserver(callback: TaroGeneral.TFunc): PerformanceObserver
     /** 该方法返回当前缓冲区中的所有性能数据
      * @supported weapp, tt
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/Performance.getEntries.html
@@ -222,23 +222,23 @@ declare module '../../index' {
 
     /** 预加载下个页面的 WebView
      * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadWebview.html 
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadWebview.html
      */
     preloadWebview(option: preloadWebview.Option): Promise<TaroGeneral.CallbackResult>
 
     /**预加载下个页面所需要的 Skyline 运行环境
      * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadSkylineView.html 
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadSkylineView.html
      */
     preloadSkylineView(option: preloadSkylineView.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 为视图层预加载媒体资源文件, 目前支持：font，image
      * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadAssets.html 
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadAssets.html
      */
     preloadAssets(option: preloadAssets.Option): Promise<TaroGeneral.CallbackResult>
     /** 小程序测速上报。使用前，需要在小程序管理后台配置。 详情参见[小程序测速](https://developers.weixin.qq.com/miniprogram/dev/framework/performanceReport/index.html)指南。
-     * 
+     *
      * **注意**
      *  - 目前，当开启代码 [按需注入](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/lazyload.html) `时，evaluateScript` 将仅包含公有部分代码，页面和组件的代码注入的时间会包含在 `firstRender` 中（因为页面和组件的代码注入过程成为了首次渲染过程的一部分）。因此开启按需注入后，脚本耗时降低，渲染时间提高属于正常现象，优化效果可以关注整体启动耗时（`appLaunch`）来评估。
      *  - `firstPaint` 和 `firstContentfulPaint` 指标在开启 `vconsole` 的情况下，由于绘制 `vconsoel` 的面板，会导致数据提前。

package/types/api/canvas/index.d.ts

@@ -882,6 +882,11 @@ declare module '../../index' {
       /** 矩形路径的高度 */
       height: number,
     ): void
+    /** 重置绘图上下文状态
+     * @supported h5
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/reset
+     */
+    reset(): void
     /** 恢复之前保存的绘图上下文
      * @supported weapp, h5
      * @example
@@ -1230,11 +1235,13 @@ declare module '../../index' {
      * ctx.setFontSize(15)
      * ctx.setTextAlign('left')
      * ctx.fillText('textAlign=left', 150, 60)
+     * await ctx.draw(true)
      * ctx.setTextAlign('center')
      * ctx.fillText('textAlign=center', 150, 80)
+     * await ctx.draw(true)
      * ctx.setTextAlign('right')
      * ctx.fillText('textAlign=right', 150, 100)
-     * ctx.draw()
+     * await ctx.draw(true)
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/CanvasContext.setTextAlign.html
      */
@@ -1254,13 +1261,16 @@ declare module '../../index' {
      * ctx.setFontSize(20)
      * ctx.setTextBaseline('top')
      * ctx.fillText('top', 5, 75)
+     * await ctx.draw(true)
      * ctx.setTextBaseline('middle')
      * ctx.fillText('middle', 50, 75)
+     * await ctx.draw(true)
      * ctx.setTextBaseline('bottom')
      * ctx.fillText('bottom', 120, 75)
+     * await ctx.draw(true)
      * ctx.setTextBaseline('normal')
      * ctx.fillText('normal', 200, 75)
-     * ctx.draw()
+     * await ctx.draw(true)
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/CanvasContext.setTextBaseline.html
      */

package/types/api/open-api/login.d.ts

@@ -81,7 +81,7 @@ declare module '../../index' {
      *
      * 通过 Taro.login 接口获得的用户登录态拥有一定的时效性。用户越久未使用小程序，用户登录态越有可能失效。反之如果用户一直在使用小程序，则用户登录态一直保持有效。具体时效逻辑由微信维护，对开发者透明。开发者只需要调用 Taro.checkSession 接口检测当前用户登录态是否有效。
      *
-     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
+     * 登录态过期后开发者可以再调用 Taro.login 获取新的用户登录态。调用 Taro.checkSession 成功说明当前 session_key 未过期，调用失败说明 session_key 已过期。更多使用方法详见 [小程序登录](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html)。
      * @supported weapp
      * @example
      * ```tsx

package/types/api/skyline/index.d.ts

@@ -0,0 +1,59 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  /**
+   * Snapshot 实例，可通过 SelectorQuery 获取。
+   *
+   * Snapshot 通过 id 跟一个 snapshot 组件绑定，操作对应的 snapshot 组件。
+   * @supported weapp
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/Snapshot.html
+   */
+  interface Snapshot {
+    /**
+     * 画布宽度
+     */
+    width: number
+    /**
+     * 画布高度
+     */
+    height: number
+    /**
+     * 对 snapshot 组件子树进行截图
+     * @param option
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/skyline/Snapshot.takeSnapshot.html
+     */
+    takeSnapshot(option: Snapshot.TakeSnapshot.Option): Promise<TaroGeneral.CallbackResult>
+  }
+
+  namespace Snapshot {
+    namespace TakeSnapshot {
+      interface Option {
+        /**
+         * 截图导出类型，'file' 保存到临时文件目录或 'arraybuffer' 返回图片二进制数据，默认值为 'file'
+         */
+        type: string
+        /**
+         * 截图文件格式，'rgba' 或 'png'，默认值为 'png'
+         */
+        format: string
+        /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+        complete?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用失败的回调函数 */
+        fail?: (res: TaroGeneral.CallbackResult) => void
+        /** 接口调用成功的回调函数 */
+        success?: (res: SuccessCallbackResult) => void
+      }
+
+      interface SuccessCallbackResult {
+        /**
+         * 截图保存的临时文件路径，当 type 为 file 该字段生效
+         */
+        tempFilePath: string
+        /**
+         * 截图对应的二进制数据，当 type 为 arraybuffer 该字段生效
+         */
+        data: string
+      }
+    }
+  }
+}

package/types/api/storage/cache-manager.d.ts

@@ -26,7 +26,7 @@ declare module '../../index' {
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteCache.html
      */
-    deleteCache( 
+    deleteCache(
       /** 缓存 id */
       id: string
     ): void
@@ -40,7 +40,7 @@ declare module '../../index' {
     ): void
     /** 删除规则，同时会删除对应规则下所有缓存
      * @supported weapp
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteRule.html 
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.deleteRule.html
      */
     deleteRule(
       /** 规则 id */
@@ -67,17 +67,17 @@ declare module '../../index' {
       /** 事件名称 */
       eventName: string,
       /** 事件监听函数 */
-      handler: Function
+      handler: TaroGeneral.EventCallback
     ): void
     /** 监听事件
      * @supported weapp
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/CacheManager.on.html
      */
-    on( 
+    on(
       /** 事件名称 */
       eventName: keyof CacheManager.OnEventName,
       /** 事件监听函数 */
-      handler: Function
+      handler: TaroGeneral.EventCallback
     ): void
     /** 开启缓存，仅在 mode 为 none 时生效，调用后缓存管理器的 state 会置为 1
      * @supported weapp
@@ -117,7 +117,7 @@ declare module '../../index' {
       method: string
       /** uri 匹配规则，可参考规则字符串写法和正则写法 */
       url: any
-      /** 
+      /**
        * 缓存有效时间，单位为 ms，不填则默认取缓存管理器全局的缓存有效时间
        * @default 7 * 24 * 60 * 60 * 1000
        */
@@ -189,10 +189,10 @@ declare module '../../index' {
   }
 
   interface TaroStatic {
-    /** 拉起手机发送短信界面
-     * @supported weap
-     * @see declare module '../../index' 
+    /** 创建缓存管理器
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/storage/cachemanager/wx.createCacheManager.html
      */
     createCacheManager(option: createCacheManager.Option): CacheManager
   }
-}
+}

package/types/compile/config/h5.d.ts

@@ -38,10 +38,10 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   webpackChain?: (chain: Chain, webpack: typeof Webpack) => void
 
   /** webpack 编译模式下，可用于修改、拓展 Webpack 的 output 选项，配置项参考[官方文档](https://webpack.js.org/configuration/output/)
-  * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/) 
+  * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
   */
   output?: T extends 'vite' ? Pick<RollupOutputOptions, 'chunkFileNames' | 'assetFileNames' > : Webpack.Configuration['output']
-  
+
   /** 路由相关的配置 */
   router?: IH5RouterConfig
 
@@ -114,4 +114,6 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
     exclude?: any[]
     include?: any[]
   }
+  /** 是否把代码转化为 es5，只在 vite 编译模式下有效 */
+  es5?: T extends 'vite' ? boolean : undefined
 }

package/types/compile/config/mini.d.ts

@@ -55,9 +55,9 @@ export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes>
   webpackChain?: (chain: Chain, webpack: typeof Webpack, PARSE_AST_TYPE: any) => void
 
   /** webpack 编译模式下，可用于修改、拓展 Webpack 的 output 选项，配置项参考[官方文档](https://webpack.js.org/configuration/output/)
-  * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/) 
+  * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
   */
-  output?: T extends 'vite' 
+  output?: T extends 'vite'
     ? Pick<RollupOutputOptions, 'chunkFileNames'>  & OutputExt
     : Webpack.Configuration['output'] & OutputExt
 

package/types/compile/config/project.d.ts

@@ -1,7 +1,7 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
 import { type Input } from 'postcss'
-import type { Compiler, IPrebundle, CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
 import type { IModifyChainData } from '../hooks'
 import type { ICopyOptions, IOption, ISassOptions, TogglableOptions } from './util'
 import type { IH5Config } from './h5'
@@ -314,4 +314,4 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
   rn?: IRNConfig
 
   [key: string]: any
-}
+}

package/types/compile/config/util.d.ts

@@ -103,7 +103,7 @@ export interface ICopyOptions {
     from: string
     to: string
     ignore?: string[]
-    transform?: Function
+    transform?: Func
     watch?: boolean
   }[]
   options: {

package/types/global.d.ts

@@ -2,6 +2,7 @@ declare namespace TaroGeneral {
   type IAnyObject = Record<string, any>
   type Optional<F> = F extends (arg: infer P) => infer R ? (arg?: P) => R : F
   type OptionalInterface<T> = { [K in keyof T]: Optional<T[K]> }
+  type TFunc = (...args: any[]) => any
   /** 事件监听函数 */
   type EventCallback = (
     /** 触发事件参数 */

package/types/index.d.ts

@@ -87,6 +87,8 @@
  * │   │   └── index.d.ts                   路由 API
  * │   ├── share
  * │   │   └── index.d.ts                   转发 API
+ * │   ├── skyline
+ * │   │   └── index.d.ts                   微信 Skyline API
  * │   ├── storage
  * │   │   ├── background-fetch.d.ts        数据缓存 -> 后台获取 API
  * │   │   └── index.d.ts                   数据缓存 API

package/types/taro.api.d.ts

@@ -109,6 +109,7 @@
 /// <reference path="api/wxml/index.d.ts" />
 /// <reference path="api/ext/index.d.ts" />
 /// <reference path="api/ad/index.d.ts" />
+/// <reference path="api/skyline/index.d.ts" />
 
 /// <reference path="api/cloud/index.d.ts" />
 /// <reference path="api/open-api/facial.d.ts" />

package/types/taro.config.d.ts

@@ -363,16 +363,41 @@ declare module './index' {
 
   interface RenderOptions {
     skyline: {
-      /**
-       * 开启默认Block布局
+      /** 开启默认Block布局
        * @see https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/wxss.html#%E5%BC%80%E5%90%AF%E9%BB%98%E8%AE%A4Block%E5%B8%83%E5%B1%80
+       * @supported weapp
        */
       defaultDisplayBlock?: boolean
-      /**
-       * 关闭 Skyline AB 实验
+      /** 关闭 Skyline AB 实验
        * @see https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/migration/release.html#%E5%8F%91%E5%B8%83%E4%B8%8A%E7%BA%BF
+       * @supported weapp
        */
       disableABTest?: boolean
+      /** 基础库最低版本
+       * @supported weapp
+       */
+      sdkVersionBegin?: string
+      /** 基础库最高版本
+       * @supported weapp
+       */
+      sdkVersionEnd?: string
+      /** iOS 微信最低版本
+       * @supported weapp
+       */
+      iosVersionBegin?: string
+      /** iOS 微信最高版本
+       * @supported weapp
+       */
+      iosVersionEnd?: string
+      /** 安卓微信最低版本
+       * @supported weapp
+       */
+      androidVersionBegin?: string
+      /** 安卓微信最高版本
+       * @supported weapp
+       */
+      androidVersionEnd?: string
+      [key: string]: unknown
     }
   }