@ray-js/api 0.5.10 → 0.5.11

package/@types/BaseKit.d.ts

@@ -1,7 +1,7 @@
 /**
  * BaseKit
  *
- * @version 2.3.11
+ * @version 3.0.0
  */
 declare namespace ty {
   /**
@@ -38,6 +38,27 @@ declare namespace ty {
     }) => void
   }): void
 
+  /**
+   * 获取音频文件时长信息
+   */
+  export function getAudioFileDuration(params: {
+    /** 音频文件路径 */
+    path: string
+    complete?: () => void
+    success?: (params: {
+      /** 音频时长 */
+      duration: number
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 权限请求方法
    */
@@ -102,6 +123,8 @@ declare namespace ty {
     appId?: string
     /** 打开的页面路径,如果为空则打开首页,path 中 ? 后面的部分会成为 query，在小程序的 `App.onLaunch`、`App.onShow` 和 `Page.onLoad` 的回调函数 */
     path?: string
+    /** 打开小程序的转场方式,分为right|bottom,指代水平和竖直方向 */
+    position?: string
     /** 传递给目标小程序的数据,目标小程序可在 `App.onLaunch`，`App.onShow` 中获取到这份数据 */
     extraData?: Record<string, any>
     /** 要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版，则打开的小程序必定是正式版 */
@@ -186,52 +209,6 @@ declare namespace ty {
     }) => void
   }): void
 
-  /**
-   * 读取本地文件内容
-   */
-  export function readFile(params: {
-    /** 要写入的文件路径 (本地路径) */
-    filePath: string
-    /** 指定读取文件的字符编码，如果不传 encoding，则以 ArrayBuffer 格式读取文件的二进制内容 */
-    encoding: string
-    /** 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
-    position: number
-    /** 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
-    length: number
-    complete?: () => void
-    success?: (params: {
-      /** 文件内容 */
-      data: string
-    }) => void
-    fail?: (params: {
-      errorMsg: string
-      errorCode: string | number
-      innerError: {
-        errorCode: string | number
-        errorMsg: string
-      }
-    }) => void
-  }): void
-
-  /**
-   * 获取通用缓存路径
-   */
-  export function getTempDirectory(params?: {
-    complete?: () => void
-    success?: (params: {
-      /** 【待废弃， 不建议使用】临时文件夹路径 */
-      tempDirectory: string
-    }) => void
-    fail?: (params: {
-      errorMsg: string
-      errorCode: string | number
-      innerError: {
-        errorCode: string | number
-        errorMsg: string
-      }
-    }) => void
-  }): void
-
   /**
    * 开始监听陀螺仪数据。
    */
@@ -267,7 +244,10 @@ declare namespace ty {
   }): void
 
   /**
-   * 从本地相册选择图片或使用相机拍照。
+   * 从本地相册选择图片或使用相机拍照, 可用chooseMedia替代此方法
+   *
+   *权限：[scope.camera, scope.writePhotosAlbum]
+   *关联API：[chooseMedia]
    */
   export function chooseImage(params?: {
     /** 最多可以选择的图片张数 */
@@ -293,6 +273,52 @@ declare namespace ty {
     }) => void
   }): void
 
+  /**
+   * 拍摄或从手机相册中选择图片或视频
+   *
+   *权限：[scope.camera, scope.writePhotosAlbum]
+   */
+  export function chooseMedia(params?: {
+    /** 最多可以选择的文件数 */
+    count?: number
+    /**
+     * 选择类型, 默认图片
+     * 'image' 只能拍摄图片或从相册选择图片
+     * 'video' 只能拍摄视频或从相册选择视频
+     */
+    mediaType?: string
+    /**
+     * 图片和视频选择的来源, 默认['album', 'camera']
+     * 'album' 从相册选择
+     * 'camera' 	使用相机拍摄
+     */
+    sourceType?: string[]
+    /**
+     * 拍摄视频最长拍摄时间，单位秒。默认10s
+     * 时间范围为 3s 至 60s 之间。不限制相册。
+     */
+    maxDuration?: number
+    complete?: () => void
+    success?: (params: {
+      /**
+       * 文件类型
+       * 'image' 图片
+       * 'video' 视频
+       */
+      type: string
+      /** 本地临时文件列表 */
+      tempFiles?: TempMediaFileCB[]
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 从本地相册选择图片或使用相机拍照（可裁剪）
    */
@@ -334,6 +360,116 @@ declare namespace ty {
     }) => void
   }): void
 
+  /**
+   * 获取图片信息
+   */
+  export function getImageInfo(params: {
+    /** 图片的路径，支持网络路径、本地路径 */
+    src: string
+    complete?: () => void
+    success?: (params: {
+      /** 图片原始宽度，单位px。不考虑旋转。 */
+      width: number
+      /** 图片原始高度，单位px。不考虑旋转。 */
+      height: number
+      /**
+       * 拍照时设备方向
+       * 合法值	说明
+       * up	默认方向（手机横持拍照），对应 Exif 中的 1。或无 orientation 信息。
+       * up-mirrored	同 up，但镜像翻转，对应 Exif 中的 2
+       * down	旋转180度，对应 Exif 中的 3
+       * down-mirrored	同 down，但镜像翻转，对应 Exif 中的 4
+       * left-mirrored	同 left，但镜像翻转，对应 Exif 中的 5
+       * right	顺时针旋转90度，对应 Exif 中的 6
+       * right-mirrored	同 right，但镜像翻转，对应 Exif 中的 7
+       * left	逆时针旋转90度，对应 Exif 中的 8
+       */
+      orientation: string
+      /**
+       * 图片格式。
+       * 合法值	说明
+       * unknown	未知格式
+       * jpeg	jpeg压缩格式
+       * png	png压缩格式
+       * gif	gif压缩格式
+       * tiff	tiff压缩格式
+       */
+      type: string
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取视频信息
+   */
+  export function getVideoInfo(params: {
+    /** 视频文件路径，可以是临时文件路径也可以是永久文件路径 */
+    src: string
+    complete?: () => void
+    success?: (params: {
+      /** 图片原始宽度，单位px。不考虑旋转。 */
+      width: number
+      /** 图片原始高度，单位px。不考虑旋转。 */
+      height: number
+      /**
+       * 画面方向
+       * 合法值	说明
+       * up	默认方向（手机横持拍照），对应 Exif 中的 1。或无 orientation 信息。
+       * up-mirrored	同 up，但镜像翻转，对应 Exif 中的 2
+       * down	旋转180度，对应 Exif 中的 3
+       * down-mirrored	同 down，但镜像翻转，对应 Exif 中的 4
+       * left-mirrored	同 left，但镜像翻转，对应 Exif 中的 5
+       * right	顺时针旋转90度，对应 Exif 中的 6
+       * right-mirrored	同 right，但镜像翻转，对应 Exif 中的 7
+       * left	逆时针旋转90度，对应 Exif 中的 8
+       */
+      orientation: string
+      /** 视频格式 */
+      type: string
+      /** 视频时长 */
+      duration: number
+      /** 视频大小，单位 kB */
+      size: number
+      /** 视频帧率 */
+      fps: number
+      /** 视频码率，单位 kbps */
+      bitrate: number
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 保存视频到系统相册，支持mp4视频格式
+   */
+  export function saveVideoToPhotosAlbum(params: {
+    /** 视频文件路径，可以是临时文件路径也可以是永久文件路径 (本地路径) */
+    filePath: string
+    complete?: () => void
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 显示消息提示框
    */
@@ -380,8 +516,6 @@ declare namespace ty {
     confirmColor?: string
     complete?: () => void
     success?: (params: {
-      /** editable 为 true 时，用户输入的文本 */
-      content?: string
       /** 为 true 时，表示用户点击了确定按钮 */
       confirm: boolean
       /** 为 true 时，表示用户点击了取消（用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭） */
@@ -398,7 +532,7 @@ declare namespace ty {
   }): void
 
   /**
-   * 显示 loading 提示框。需主动调用 ty.hideLoading 才能关闭提示框
+   * 显示 loading 提示框。需主动调用 thing.hideLoading 才能关闭提示框
    */
   export function showLoading(params: {
     /** 提示的内容 */
@@ -482,7 +616,14 @@ declare namespace ty {
     phoneNumber: string
     complete?: () => void
     success?: (params: null) => void
-    fail?: (params: {}) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
   }): void
 
   /**
@@ -493,7 +634,14 @@ declare namespace ty {
     data: string
     complete?: () => void
     success?: (params: null) => void
-    fail?: (params: {}) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
   }): void
 
   /**
@@ -505,7 +653,145 @@ declare namespace ty {
       /** 剪贴板的内容 */
       data: string
     }) => void
-    fail?: (params: {}) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 设置系统音量
+   *
+   *错误码标注
+   *入参值范围超出 errorCode = 6， The volume value is invalid, it should be [0 - 1]
+   */
+  export function updateVolume(params: {
+    /** 音量，阈值【0 - 1】 */
+    value: number
+    complete?: () => void
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取当前系统音量
+   */
+  export function getCurrentVolume(params?: {
+    complete?: () => void
+    success?: (params: {
+      /** 音量，阈值【0 - 1】 */
+      value: number
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 注册系统音量监听
+   *
+   *关联API：[onSystemVolumeChangeEvent, unRegisterSystemVolumeChange]
+   */
+  export function registerSystemVolumeChange(params?: {
+    complete?: () => void
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 取消注册系统音量监听
+   *
+   *关联API：[onSystemVolumeChangeEvent, registerSystemVolumeChange]
+   */
+  export function unRegisterSystemVolumeChange(params?: {
+    complete?: () => void
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取设备设置
+   */
+  export function getSystemSetting(params?: {
+    complete?: () => void
+    success?: (params: {
+      /** 蓝牙的系统开关，默认false */
+      bluetoothEnabled?: boolean
+      /** 地理位置的系统开关，默认false */
+      locationEnabled?: boolean
+      /** Wi-Fi 的系统开关，默认false */
+      wifiEnabled?: boolean
+      /**
+       * 设备方向, 默认竖屏
+       * 竖屏 = "portrait"， 横屏 = "landscape"
+       */
+      deviceOrientation?: string
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取设备基础信息
+   */
+  export function getDeviceInfo(params?: {
+    complete?: () => void
+    success?: (params: {
+      /** 应用二进制接口类型（仅 Android 支持） */
+      abi: string
+      /** 设备品牌 */
+      brand: string
+      /** 设备型号。新机型刚推出一段时间会显示unknown。 */
+      model: string
+      /** 操作系统及版本 */
+      system: string
+      /** 客户端平台 */
+      platform: string
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
   }): void
 
   /**
@@ -585,6 +871,76 @@ declare namespace ty {
     deviceOrientation?: Orientation
   }
 
+  /**
+   * 获取手机附近的Wi-Fi列表；列表数据通过onGetWifiList事件发送
+   */
+  export function getWifiList(params?: {
+    complete?: () => void
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取当前连接的wifi信息
+   *iOS: 返回SSID和BSSID
+   */
+  export function getConnectedWifi(params?: {
+    /**
+     * 是否需要返回部分 Wi-Fi 信息
+     * 安卓 thing.getConnectedWifi 若设置了 partialInfo:true ，将会返回只包含 SSID 属性的 WifiInfo 对象。
+     * iOS thing.getConnectedWifi 若设置了 partialInfo:true ，将会返回只包含 SSID、BSSID 属性的 WifiInfo 对象，且需要用户开启微信定位权限才能正确返回结果。
+     * 默认值：false
+     */
+    partialInfo?: boolean
+    complete?: () => void
+    success?: (params: {
+      /** wifi的SSID */
+      SSID: string
+      /** wifi的BSSID */
+      BSSID: string
+      /** Wi-Fi 信号强度, 安卓取值 0 ～ 100 ，iOS 取值 0 ～ 1 ，值越大强度越大 */
+      signalStrength: number
+      /**
+       * Wi-Fi是否安全
+       * Android：Android系统12开始支持。
+       */
+      secure: boolean
+      /** Wi-Fi 频段单位 MHz */
+      frequency: number
+    }) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 跳转系统蓝牙设置页 (仅Android)
+   */
+  export function openSystemBluetoothSetting(params?: {
+    complete?: () => void
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 获取网络类型
    */
@@ -596,7 +952,14 @@ declare namespace ty {
       /** 信号强弱，单位 dbm */
       signalStrength: number
     }) => void
-    fail?: (params: {}) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+      innerError: {
+        errorCode: string | number
+        errorMsg: string
+      }
+    }) => void
   }): void
 
   /**
@@ -817,13 +1180,39 @@ declare namespace ty {
    */
   export function clearStorageSync(): null
 
+  /**
+   * 系统音量监听通知事件
+   *
+   *关联API：[registerSystemVolumeChange, unRegisterSystemVolumeChange]
+   */
+  export function onSystemVolumeChangeEvent(listener: (params: CurrentVolumeResponse) => void): void
+
+  /**
+   * 取消监听：系统音量监听通知事件
+   *
+   *关联API：[registerSystemVolumeChange, unRegisterSystemVolumeChange]
+   */
+  export function offSystemVolumeChangeEvent(
+    listener: (params: CurrentVolumeResponse) => void
+  ): void
+
+  /**
+   * 监听获取到 Wi-Fi 列表数据事件
+   */
+  export function onGetWifiList(listener: (params: WifiListResponse) => void): void
+
+  /**
+   * 取消监听：监听获取到 Wi-Fi 列表数据事件
+   */
+  export function offGetWifiList(listener: (params: WifiListResponse) => void): void
+
   /**
    * 持续录音事件
    */
   export function onRecordingEvent(listener: (params: AudioRecordBufferBean) => void): void
 
   /**
-   * 持续录音事件
+   * 取消监听：持续录音事件
    */
   export function offRecordingEvent(listener: (params: AudioRecordBufferBean) => void): void
 
@@ -1067,6 +1456,93 @@ declare namespace ty {
     receivedBytedCount: number
   }
 
+  export type FileReadFileReqBean = {
+    /** 要写入的文件路径 (本地路径) */
+    filePath: string
+    /**
+     * 指定读取文件的字符编码。
+     * 支持 utf8/ascii/base64。如果不传 encoding，默认utf8
+     */
+    encoding?: string
+    /** 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
+    position?: number
+    /** 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
+    length?: number
+  }
+
+  export type SaveFileSyncParams = {
+    /** taskId */
+    fileId: string
+    /** 临时存储文件路径 */
+    tempFilePath: string
+    /** 要存储的文件路径 */
+    filePath: string
+  }
+
+  export type FileStats = {
+    /** 文件的类型和存取的权限 */
+    mode: string
+    /** 文件大小，单位：B */
+    size: number
+    /** 文件最近一次被存取或被执行的时间，UNIX 时间戳 */
+    lastAccessedTime: number
+    /** 文件最后一次被修改的时间，UNIX 时间戳 */
+    lastModifiedTime: number
+    /** 当前文件是否一个目录 */
+    isDirectory: boolean
+    /** 当前文件是否一个普通文件 */
+    isFile: boolean
+  }
+
+  export type FileStatsParams = {
+    /** taskId */
+    fileId: string
+    /** 文件/目录路径 (本地路径) */
+    path: string
+    /**
+     * 是否递归获取目录下的每个文件的 Stats 信息
+     * 默认值：false
+     */
+    recursive?: boolean
+  }
+
+  export type MakeDirParams = {
+    /** taskId */
+    fileId: string
+    /** 创建的目录路径 (本地路径) */
+    dirPath: string
+    /**
+     * 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。
+     * 如 dirPath 为 a/b/c/d 且 recursive 为 true，将创建 a 目录，再在 a 目录下创建 b 目录，
+     * 以此类推直至创建 a/b/c 目录下的 d 目录。
+     * 默认值：false
+     */
+    recursive?: boolean
+  }
+
+  export type RemoveDirParams = {
+    /** taskId */
+    fileId: string
+    /** 要删除的目录路径 (本地路径) */
+    dirPath: string
+    /**
+     * 是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。
+     * 默认值：false
+     */
+    recursive?: boolean
+  }
+
+  export type WriteFileParams = {
+    /** taskId */
+    fileId: string
+    /** 要写入的文件路径 (本地路径) */
+    filePath: string
+    /** 要写入的文本数据, 根据encoding编码 */
+    data: string
+    /** 指定写入文件的字符编码,目前支持【utf8、ascii、base64】, 默认utf8 */
+    encoding?: string
+  }
+
   export enum HTTPMethod {
     /** HTTP 请求 OPTIONS */
     OPTIONS = 'OPTIONS',
@@ -1133,6 +1609,27 @@ declare namespace ty {
     size?: number
   }
 
+  export type TempMediaFileCB = {
+    /** 本地临时文件路径 (本地路径) */
+    tempFilePath: string
+    /** 本地临时文件大小，单位 B */
+    size: number
+    /** 视频的时间长度 */
+    duration: number
+    /** 视频的高度 */
+    height: number
+    /** 视频的宽度 */
+    width: number
+    /** 视频缩略图临时文件路径 */
+    thumbTempFilePath: string
+    /**
+     * 文件类型
+     * 'image' 	图片
+     * 'video' 	视频
+     */
+    fileType: string
+  }
+
   export type SafeArea = {
     left: number
     right: number
@@ -1166,11 +1663,36 @@ declare namespace ty {
     key: string
   }
 
+  export type CurrentVolumeResponse = {
+    /** 音量，阈值【0 - 1】 */
+    value: number
+  }
+
+  export type WifiListResponse = {
+    /** Wi-Fi列表 */
+    wifiList: WifiInfo[]
+  }
+
   export type AudioRecordBufferBean = {
     /** 数据流 */
     buffer: number[]
   }
 
+  export type InnerAudioContext = {
+    /** InnerAudioContext 对象 ContextId */
+    contextId: string
+  }
+
+  export type AudioFileParams = {
+    /** 音频文件路径 */
+    path: string
+  }
+
+  export type AudioFileResponse = {
+    /** 音频时长 */
+    duration: number
+  }
+
   export type InnerAudioBean = {
     /**
      * InnerAudioContext 对象 contextId
@@ -1191,16 +1713,11 @@ declare namespace ty {
     playbackRate?: number
   }
 
-  export type InnerAudioSeekBean = {
-    /** InnerAudioContext 对象 ContextId */
-    contextId: string
-    /** 跳转的时间，单位 s。精确到小数点后 3 位，即支持 ms 级别精确度 */
-    position?: number
-  }
-
-  export type InnerAudioContext = {
+  export type InnerAudioSeekBean = {
     /** InnerAudioContext 对象 ContextId */
     contextId: string
+    /** 跳转的时间，单位 s。精确到小数点后 3 位，即支持 ms 级别精确度 */
+    position?: number
   }
 
   export type AuthorizeBean = {
@@ -1223,6 +1740,8 @@ declare namespace ty {
     appId?: string
     /** 打开的页面路径,如果为空则打开首页,path 中 ? 后面的部分会成为 query，在小程序的 `App.onLaunch`、`App.onShow` 和 `Page.onLoad` 的回调函数 */
     path?: string
+    /** 打开小程序的转场方式,分为right|bottom,指代水平和竖直方向 */
+    position?: string
     /** 传递给目标小程序的数据,目标小程序可在 `App.onLaunch`，`App.onShow` 中获取到这份数据 */
     extraData?: Record<string, any>
     /** 要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版，则打开的小程序必定是正式版 */
@@ -1265,15 +1784,9 @@ declare namespace ty {
     requestId: string
   }
 
-  export type FileReadFileReqBean = {
-    /** 要写入的文件路径 (本地路径) */
-    filePath: string
-    /** 指定读取文件的字符编码，如果不传 encoding，则以 ArrayBuffer 格式读取文件的二进制内容 */
-    encoding: string
-    /** 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
-    position: number
-    /** 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
-    length: number
+  export type AccessFileParams = {
+    /** 要判断是否存在的文件/目录路径 (本地路径) */
+    path: string
   }
 
   export type ReadFileBean = {
@@ -1281,23 +1794,21 @@ declare namespace ty {
     data: string
   }
 
-  export type SaveFileSyncParams = {
-    /** taskId */
-    fileId: string
-    /** 临时存储文件路径 */
-    tempFilePath: string
-    /** 要存储的文件路径 */
-    filePath: string
-  }
-
   export type SaveFileSyncCallback = {
     /** 【待废弃， 不建议使用】存储后的文件路径 */
     savedFilePath: string
   }
 
-  export type GetTempDirectoryCallback = {
-    /** 【待废弃， 不建议使用】临时文件夹路径 */
-    tempDirectory: string
+  export type FileStatsResponse = {
+    /** 文件列表 */
+    fileStatsList: FileStats[]
+  }
+
+  export type RemoveFileParams = {
+    /** taskId */
+    fileId: string
+    /** 需要删除的文件路径 (本地路径) */
+    filePath: string
   }
 
   export type GyroscopeBean = {
@@ -1321,6 +1832,39 @@ declare namespace ty {
     tempFiles?: TempFileCB[]
   }
 
+  export type ChooseMediaBean = {
+    /** 最多可以选择的文件数 */
+    count?: number
+    /**
+     * 选择类型, 默认图片
+     * 'image' 只能拍摄图片或从相册选择图片
+     * 'video' 只能拍摄视频或从相册选择视频
+     */
+    mediaType?: string
+    /**
+     * 图片和视频选择的来源, 默认['album', 'camera']
+     * 'album' 从相册选择
+     * 'camera' 	使用相机拍摄
+     */
+    sourceType?: string[]
+    /**
+     * 拍摄视频最长拍摄时间，单位秒。默认10s
+     * 时间范围为 3s 至 60s 之间。不限制相册。
+     */
+    maxDuration?: number
+  }
+
+  export type ChooseMediaCB = {
+    /**
+     * 文件类型
+     * 'image' 图片
+     * 'video' 视频
+     */
+    type: string
+    /** 本地临时文件列表 */
+    tempFiles?: TempMediaFileCB[]
+  }
+
   export type ChooseCropImageBean = {
     /** 选择图片的来源 ['album', 'camera']，默认都支持 */
     sourceType?: string[]
@@ -1338,6 +1882,81 @@ declare namespace ty {
     current: number
   }
 
+  export type GetImageInfoParams = {
+    /** 图片的路径，支持网络路径、本地路径 */
+    src: string
+  }
+
+  export type ImageInfoCB = {
+    /** 图片原始宽度，单位px。不考虑旋转。 */
+    width: number
+    /** 图片原始高度，单位px。不考虑旋转。 */
+    height: number
+    /**
+     * 拍照时设备方向
+     * 合法值	说明
+     * up	默认方向（手机横持拍照），对应 Exif 中的 1。或无 orientation 信息。
+     * up-mirrored	同 up，但镜像翻转，对应 Exif 中的 2
+     * down	旋转180度，对应 Exif 中的 3
+     * down-mirrored	同 down，但镜像翻转，对应 Exif 中的 4
+     * left-mirrored	同 left，但镜像翻转，对应 Exif 中的 5
+     * right	顺时针旋转90度，对应 Exif 中的 6
+     * right-mirrored	同 right，但镜像翻转，对应 Exif 中的 7
+     * left	逆时针旋转90度，对应 Exif 中的 8
+     */
+    orientation: string
+    /**
+     * 图片格式。
+     * 合法值	说明
+     * unknown	未知格式
+     * jpeg	jpeg压缩格式
+     * png	png压缩格式
+     * gif	gif压缩格式
+     * tiff	tiff压缩格式
+     */
+    type: string
+  }
+
+  export type GetVideoInfoParams = {
+    /** 视频文件路径，可以是临时文件路径也可以是永久文件路径 */
+    src: string
+  }
+
+  export type VideoInfoCB = {
+    /** 图片原始宽度，单位px。不考虑旋转。 */
+    width: number
+    /** 图片原始高度，单位px。不考虑旋转。 */
+    height: number
+    /**
+     * 画面方向
+     * 合法值	说明
+     * up	默认方向（手机横持拍照），对应 Exif 中的 1。或无 orientation 信息。
+     * up-mirrored	同 up，但镜像翻转，对应 Exif 中的 2
+     * down	旋转180度，对应 Exif 中的 3
+     * down-mirrored	同 down，但镜像翻转，对应 Exif 中的 4
+     * left-mirrored	同 left，但镜像翻转，对应 Exif 中的 5
+     * right	顺时针旋转90度，对应 Exif 中的 6
+     * right-mirrored	同 right，但镜像翻转，对应 Exif 中的 7
+     * left	逆时针旋转90度，对应 Exif 中的 8
+     */
+    orientation: string
+    /** 视频格式 */
+    type: string
+    /** 视频时长 */
+    duration: number
+    /** 视频大小，单位 kB */
+    size: number
+    /** 视频帧率 */
+    fps: number
+    /** 视频码率，单位 kbps */
+    bitrate: number
+  }
+
+  export type SaveVideoParams = {
+    /** 视频文件路径，可以是临时文件路径也可以是永久文件路径 (本地路径) */
+    filePath: string
+  }
+
   export type ToastBean = {
     /** 提示的内容 */
     title: string
@@ -1369,8 +1988,6 @@ declare namespace ty {
   }
 
   export type ModalCallback = {
-    /** editable 为 true 时，用户输入的文本 */
-    content?: string
     /** 为 true 时，表示用户点击了确定按钮 */
     confirm: boolean
     /** 为 true 时，表示用户点击了取消（用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭） */
@@ -1453,6 +2070,54 @@ declare namespace ty {
     data: string
   }
 
+  export type WifiInfo = {
+    /** wifi的SSID */
+    SSID: string
+    /** wifi的BSSID */
+    BSSID: string
+    /** Wi-Fi 信号强度, 安卓取值 0 ～ 100 ，iOS 取值 0 ～ 1 ，值越大强度越大 */
+    signalStrength: number
+    /**
+     * Wi-Fi是否安全
+     * Android：Android系统12开始支持。
+     */
+    secure: boolean
+    /** Wi-Fi 频段单位 MHz */
+    frequency: number
+  }
+
+  export type UpdateVolumeParams = {
+    /** 音量，阈值【0 - 1】 */
+    value: number
+  }
+
+  export type SystemSetting = {
+    /** 蓝牙的系统开关，默认false */
+    bluetoothEnabled?: boolean
+    /** 地理位置的系统开关，默认false */
+    locationEnabled?: boolean
+    /** Wi-Fi 的系统开关，默认false */
+    wifiEnabled?: boolean
+    /**
+     * 设备方向, 默认竖屏
+     * 竖屏 = "portrait"， 横屏 = "landscape"
+     */
+    deviceOrientation?: string
+  }
+
+  export type DeviceInfoResponse = {
+    /** 应用二进制接口类型（仅 Android 支持） */
+    abi: string
+    /** 设备品牌 */
+    brand: string
+    /** 设备型号。新机型刚推出一段时间会显示unknown。 */
+    model: string
+    /** 操作系统及版本 */
+    system: string
+    /** 客户端平台 */
+    platform: string
+  }
+
   export type SystemInfo = {
     is24Hour: boolean
     system: string
@@ -1483,6 +2148,16 @@ declare namespace ty {
     deviceOrientation?: Orientation
   }
 
+  export type GetConnectedWifiParams = {
+    /**
+     * 是否需要返回部分 Wi-Fi 信息
+     * 安卓 thing.getConnectedWifi 若设置了 partialInfo:true ，将会返回只包含 SSID 属性的 WifiInfo 对象。
+     * iOS thing.getConnectedWifi 若设置了 partialInfo:true ，将会返回只包含 SSID、BSSID 属性的 WifiInfo 对象，且需要用户开启微信定位权限才能正确返回结果。
+     * 默认值：false
+     */
+    partialInfo?: boolean
+  }
+
   export type NetworkTypeCB = {
     /** 网络类型 */
     networkType: string
@@ -1500,7 +2175,7 @@ declare namespace ty {
     keepScreenOn: boolean
   }
 
-  export type TYUniVibrateBean = {
+  export type TUNIVibrateBean = {
     /** 震动强度类型，有效值为：heavy、medium、light */
     type: string
   }
@@ -1594,6 +2269,38 @@ declare namespace ty {
    * 创建内部audio上下文InnerAudioContext对象
    */
   interface CreateInnerAudioContextTask {
+    /**
+     * 暂停
+     */
+    pause(params: {
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 恢复
+     */
+    resume(params: {
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
     /**
      * 播放
      */
@@ -1671,6 +2378,18 @@ declare namespace ty {
         }
       }) => void
     }): void
+
+    /**
+     * 监听音频播放进度更新事件
+     */
+    onTimeUpdate(
+      listener: (params: {
+        /** InnerAudioContext 对象 ContextId */
+        contextId: string
+        /** 播放进度 【0 - 1】 */
+        time: number
+      }) => void
+    ): void
   }
   export function createInnerAudioContext(params?: {
     complete?: () => void
@@ -1795,10 +2514,66 @@ declare namespace ty {
    * 文件管理器
    */
   interface GetFileSystemManagerTask {
+    /**
+     * 判断文件/目录是否存在
+     */
+    access(params: {
+      /** 要判断是否存在的文件/目录路径 (本地路径) */
+      path: string
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 读取本地文件内容
+     */
+    readFile(params: {
+      /** 要写入的文件路径 (本地路径) */
+      filePath: string
+      /**
+       * 指定读取文件的字符编码。
+       * 支持 utf8/ascii/base64。如果不传 encoding，默认utf8
+       */
+      encoding?: string
+      /** 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
+      position?: number
+      /** 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
+      length?: number
+      complete?: () => void
+      success?: (params: {
+        /** 文件内容 */
+        data: string
+      }) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 读取本地文件内容
+     */
+    readFileSync(req?: FileReadFileReqBean): {
+      /** 文件内容 */
+      data: string
+    }
+
     /**
      * 文件保存的同步方法， 在完成文件保存后调用回调， 需要与getTempDirectory配合使用， 目标路径会校验是否包含getTempDirectory前缀
      */
-    saveFileSync(params: {
+    saveFile(params: {
       /** 临时存储文件路径 */
       tempFilePath: string
       /** 要存储的文件路径 */
@@ -1817,6 +2592,151 @@ declare namespace ty {
         }
       }) => void
     }): void
+
+    /**
+     * 文件保存的同步方法， 在完成文件保存后调用回调， 需要与getTempDirectory配合使用， 目标路径会校验是否包含getTempDirectory前缀
+     */
+    saveFileSync(params?: SaveFileSyncParams): {
+      /** 【待废弃， 不建议使用】存储后的文件路径 */
+      savedFilePath: string
+    }
+
+    /**
+     * 获取文件Stats对象，需要文件读写权限
+     */
+    stat(params: {
+      /** 文件/目录路径 (本地路径) */
+      path: string
+      /**
+       * 是否递归获取目录下的每个文件的 Stats 信息
+       * 默认值：false
+       */
+      recursive?: boolean
+      complete?: () => void
+      success?: (params: {
+        /** 文件列表 */
+        fileStatsList: FileStats[]
+      }) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 获取文件Stats对象，需要文件读写权限
+     */
+    statSync(params?: FileStatsParams): {
+      /** 文件列表 */
+      fileStatsList: FileStats[]
+    }
+
+    /**
+     * 创建目录，需要文件读写权限
+     */
+    mkdir(params: {
+      /** 创建的目录路径 (本地路径) */
+      dirPath: string
+      /**
+       * 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。
+       * 如 dirPath 为 a/b/c/d 且 recursive 为 true，将创建 a 目录，再在 a 目录下创建 b 目录，
+       * 以此类推直至创建 a/b/c 目录下的 d 目录。
+       * 默认值：false
+       */
+      recursive?: boolean
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 创建目录，需要文件读写权限
+     */
+    mkdirSync(params?: MakeDirParams): null
+
+    /**
+     * 删除目录，需要文件读写权限
+     */
+    rmdir(params: {
+      /** 要删除的目录路径 (本地路径) */
+      dirPath: string
+      /**
+       * 是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。
+       * 默认值：false
+       */
+      recursive?: boolean
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 删除目录，需要文件读写权限
+     */
+    rmdirSync(params?: RemoveDirParams): null
+
+    /**
+     * 写文件，需要文件读写权限
+     */
+    writeFile(params: {
+      /** 要写入的文件路径 (本地路径) */
+      filePath: string
+      /** 要写入的文本数据, 根据encoding编码 */
+      data: string
+      /** 指定写入文件的字符编码,目前支持【utf8、ascii、base64】, 默认utf8 */
+      encoding?: string
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
+
+    /**
+     * 写文件，需要文件读写权限
+     */
+    writeFileSync(params?: WriteFileParams): null
+
+    /**
+     * 删除已保存的本地缓存文件，需要文件读写权限
+     */
+    removeSavedFile(params: {
+      /** 需要删除的文件路径 (本地路径) */
+      filePath: string
+      complete?: () => void
+      success?: (params: null) => void
+      fail?: (params: {
+        errorMsg: string
+        errorCode: string | number
+        innerError: {
+          errorCode: string | number
+          errorMsg: string
+        }
+      }) => void
+    }): void
   }
   export function getFileSystemManager(params?: {
     complete?: () => void