@tarojs/taro 3.8.0-canary.0 → 4.0.0-beta.0

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 会话对象 */
   }
 }