@ray-js/api 1.7.80 → 1.7.82

package/@types/OutdoorKit.d.ts

@@ -1,13 +1,1127 @@
 /**
  * OutdoorKit
  *
- * @version 6.4.2
+ * @version 7.8.5
  */
 declare namespace ty.outdoor {
+  /**
+   * 一键连接设备（WiFi 热点连接 + SDK 初始化 + 心跳保活）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.connectDevice({
+   *   ssid: "xx",
+   *   password: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function connectDevice(params: {
+    /**
+     * 设备热点 SSID
+     * @since OutdoorKit 7.8.0
+     */
+    ssid: string
+    /**
+     * 设备热点密码
+     * @since OutdoorKit 7.8.0
+     */
+    password: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 初始化 RideSafe SDK
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.initSDK({
+   *   keyPath: "xx",
+   *   loggerDir: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function initSDK(params: {
+    /**
+     * 密钥文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    keyPath: string
+    /**
+     * 日志输出目录
+     * @since OutdoorKit 7.8.0
+     */
+    loggerDir: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 销毁 RideSafe SDK
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.destroySDK({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function destroySDK(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取摄像头信息
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getCameraInfo({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getCameraInfo(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 设备序列号
+       * @since OutdoorKit 7.8.0
+       */
+      sn: string
+      /**
+       * 产品编号
+       * @since OutdoorKit 7.8.0
+       */
+      pn: string
+      /**
+       * SKU 编码
+       * @since OutdoorKit 7.8.0
+       */
+      sku: string
+      /**
+       * 当前固件版本
+       * @since OutdoorKit 7.8.0
+       */
+      firmwareVersion: string
+      /**
+       * 绑定状态：0=未绑定, 1=已绑定
+       * @since OutdoorKit 7.8.0
+       */
+      isBind: number
+      /**
+       * 剩余存储空间（字节）
+       * @since OutdoorKit 7.8.0
+       */
+      freeSpace: number
+      /**
+       * 总存储空间（字节）
+       * @since OutdoorKit 7.8.0
+       */
+      totalSpace: number
+      /**
+       * 已用存储空间（字节）
+       * @since OutdoorKit 7.8.0
+       */
+      usedSpace: number
+      /**
+       * RTSP 服务状态：0=关闭, 1=开启
+       * @since OutdoorKit 7.8.0
+       */
+      rtspStatus: number
+      /**
+       * 当前帧率（单位 fps）
+       * @since OutdoorKit 7.8.0
+       */
+      fps: number
+      /**
+       * 当前码率（单位 kbps）
+       * @since OutdoorKit 7.8.0
+       */
+      bitRate: number
+      /**
+       * 当前录制分段间隔（单位：秒）
+       * @since OutdoorKit 7.8.0
+       */
+      recordInterval: number
+      /**
+       * AI 功能状态：0=关闭, 1=开启
+       * @since OutdoorKit 7.8.0
+       */
+      aiEnabled: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 配置相机 WiFi
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setWifi({
+   *   ssid: "xx",
+   *   password: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function setWifi(params: {
+    /**
+     * WiFi 名称
+     * @since OutdoorKit 7.8.0
+     */
+    ssid: string
+    /**
+     * WiFi 密码
+     * @since OutdoorKit 7.8.0
+     */
+    password: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 设置帧率（25 或 30）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setFPS({
+   *   fps: 30,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function setFPS(params: {
+    /**
+     * 帧率值，支持 25 或 30
+     * @since OutdoorKit 7.8.0
+     */
+    fps: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取帧率
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getFPS({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getFPS(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 当前帧率（单位 fps，通常为 25 或 30）
+       * @since OutdoorKit 7.8.0
+       */
+      fps: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 设置码率
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setBitRate({
+   *   bitRate: 1,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function setBitRate(params: {
+    /**
+     * 码率值（单位 kbps）
+     * @since OutdoorKit 7.8.0
+     */
+    bitRate: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取码率
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getBitRate({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getBitRate(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 当前码率（单位 kbps）
+       * @since OutdoorKit 7.8.0
+       */
+      bitRate: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 设置录制间隔（60/120/180/300 秒）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setRecordInterval({
+   *   interval: 60,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function setRecordInterval(params: {
+    /**
+     * 录制间隔，支持 60/120/180/300（秒）
+     * @since OutdoorKit 7.8.0
+     */
+    interval: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取录制间隔
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getRecordInterval({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getRecordInterval(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 当前录制间隔（秒）
+       * @since OutdoorKit 7.8.0
+       */
+      interval: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 设置 AI 功能开关（0=关, 1=开）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setAIEnabled({
+   *   enabled: 1,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function setAIEnabled(params: {
+    /**
+     * AI 功能开关：0=关闭, 1=开启
+     * @since OutdoorKit 7.8.0
+     */
+    enabled: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取 AI 功能状态
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getAIStatus({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getAIStatus(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * AI 功能状态：0=关闭, 1=开启
+       * @since OutdoorKit 7.8.0
+       */
+      enabled: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 检查固件版本
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.checkFirmwareVersion({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function checkFirmwareVersion(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 当前固件版本号
+       * @since OutdoorKit 7.8.0
+       */
+      currentVersion: string
+      /**
+       * 是否有可用更新：0=无, 1=有
+       * @since OutdoorKit 7.8.0
+       */
+      hasUpdate: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 升级固件（设备会重启）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.upgradeFirmware({
+   *   firmwarePath: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function upgradeFirmware(params: {
+    /**
+     * 固件文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    firmwarePath: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取文件列表
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getFileList({
+   *   path: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getFileList(params: {
+    /**
+     * 目标路径
+     * @since OutdoorKit 7.8.0
+     */
+    path: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 文件列表
+       * @since OutdoorKit 7.8.0
+       */
+      files: FileItem[]
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取指定远端文件路径的下载/在线播放鉴权 HTTP Header（对应 RideSafe GetDownloadAuthHeader）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getDownloadAuthHeader({
+   *   path: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getDownloadAuthHeader(params: {
+    /**
+     * 目标路径
+     * @since OutdoorKit 7.8.0
+     */
+    path: string
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 鉴权头原始字符串（多行 key: value，与肇观 Demo getHeader 一致）
+       * @since OutdoorKit 7.8.0
+       */
+      header: string
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 下载文件（异步，进度通过 downloadProgress Event 推送）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.downloadFile({
+   *   remotePath: "xx",
+   *   localPath: "xx",
+   *   fileSizeBytes: 1,
+   *   exportToPublicDownloads: false,
+   *   deleteLocalAfterExport: false,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function downloadFile(params: {
+    /**
+     * 远端文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    remotePath: string
+    /**
+     * 本地存储路径
+     * @since OutdoorKit 7.8.0
+     */
+    localPath: string
+    /**
+     * 可选：文件大小（字节），与 getFileList 中 FileItem.size 一致时可传，用于下载后校验与 post_verify 阶段进度。
+     * @since OutdoorKit 7.8.0
+     */
+    fileSizeBytes?: number
+    /**
+     * Android-only: 下载完成后是否将文件额外导出到系统公共 Downloads 目录（Download/nvpdownload/<name>）。
+     * 默认 true，Android 上会把文件同时写入用户可见的 Downloads 目录（与 Sample 的列表下载一致）；传 false 则仅保留到 localPath（应用私有缓存）。
+     * iOS / HarmonyOS 当前不实现该行为，字段仅为多端对齐预留。
+     * @since OutdoorKit 7.8.0
+     */
+    exportToPublicDownloads?: boolean
+    /**
+     * Android-only: 成功导出到公共 Downloads 后，是否删除 localPath 指向的原始副本。
+     * 不传（默认）时使用智能策略：未传 localPath（由 lib 自动生成 cache 路径）→ 删除；传了 localPath → 保留。
+     * 显式传 true/false 会覆盖默认策略。export 失败或关闭时永不删除。
+     * @since OutdoorKit 7.8.0
+     */
+    deleteLocalAfterExport?: boolean
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 批量删除文件
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.deleteFiles({
+   *   paths: [],
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function deleteFiles(params: {
+    /**
+     * 待删除文件路径列表
+     * @since OutdoorKit 7.8.0
+     */
+    paths: string[]
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 成功删除的文件数量
+       * @since OutdoorKit 7.8.0
+       */
+      deletedCount: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 获取存储空间信息
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getFreeSpace({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function getFreeSpace(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: (params: {
+      /**
+       * 可用空间（字节）
+       * @since OutdoorKit 7.8.0
+       */
+      free: number
+      /**
+       * 已用空间（字节）
+       * @since OutdoorKit 7.8.0
+       */
+      used: number
+      /**
+       * 总空间（字节）
+       * @since OutdoorKit 7.8.0
+       */
+      total: number
+    }) => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 打开原生视频播放器播放指定视频（支持远端流播放和本地文件播放）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.playVideo({
+   *   url: "xx",
+   *   fileSizeBytes: 1,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function playVideo(params: {
+    /**
+     * 视频播放地址（远端 HTTP 流地址或本地文件路径，鉴权头由原生内部自动获取）
+     * @since OutdoorKit 7.8.0
+     */
+    url: string
+    /**
+     * 可选：文件大小（字节），与 getFileList 中 FileItem.size 一致时可传。
+     * 当 ExoPlayer 无法从容器头取到 duration（NVP 设备 TS 流常见）时，用字节数 + 估算码率推导合理的总时长与进度条范围；
+     * 不传则播放总时长可能显示异常、进度条无法拖动（与 Sample 列表播放保持一致即不会出现该问题）。
+     * @since OutdoorKit 7.8.0
+     */
+    fileSizeBytes?: number
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
+  /**
+   * 格式化磁盘（不可逆，设备会重启）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.formatDisk({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function formatDisk(params?: {
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: () => void
+    /** 接口调用成功的回调函数 */
+    success?: () => void
+    /** 接口调用失败的回调函数 */
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /** 错误码 */
+      errorCode: string | number
+      /** 错误扩展 */
+      innerError: {
+        /** 错误扩展码 */
+        errorCode: string | number
+        /** 错误扩展信息 */
+        errorMsg: string
+      }
+    }) => void
+  }): void
+
   /**
    * 出行获取当前首页展示的设备ID
    * @public
    * @since OutdoorKit 1.0.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.currentDevice({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function currentDevice(params?: {
@@ -41,6 +1155,17 @@ declare namespace ty.outdoor {
    * 切换设备，会弹出Native切换选择器
    * @public
    * @since OutdoorKit 1.0.4
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.switchDevice({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function switchDevice(params?: {
@@ -68,6 +1193,17 @@ declare namespace ty.outdoor {
    * 获取出行设备列表(不含分享的设备)
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getDeviceList({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getDeviceList(params?: {
@@ -101,6 +1237,17 @@ declare namespace ty.outdoor {
    * 获取分享的设备列表
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getSharedDeviceList({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getSharedDeviceList(params?: {
@@ -131,9 +1278,21 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 指定设备ID
+   * 指定当前设备，传入需要切换为当前展示的设备信息
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.specifyDevice({
+   *   deviceID: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function specifyDevice(params: {
@@ -166,6 +1325,17 @@ declare namespace ty.outdoor {
    * 获取已绑定设备ID集合
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getBoundDeviceIdList({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getBoundDeviceIdList(params?: {
@@ -199,6 +1369,17 @@ declare namespace ty.outdoor {
    * 获取可绑定设备ID集合
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getUnbindDeviceIdList({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getUnbindDeviceIdList(params?: {
@@ -229,9 +1410,22 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 从设备绑定
+   * 绑定从设备到指定主设备
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.bindSlaveDevice({
+   *   slaveDevId: "xx",
+   *   masterDevId: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function bindSlaveDevice(params: {
@@ -269,6 +1463,18 @@ declare namespace ty.outdoor {
    * 从设备移除
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.unbindDevice({
+   *   devId: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function unbindDevice(params: {
@@ -298,9 +1504,23 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 小程序表盘设置
+   * 小程序表盘设置，配置表盘左/中/右三个区域展示的数据 tag
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.saveDialViewTag({
+   *   leftViewTag: "xx",
+   *   centerViewTag: "xx",
+   *   rightViewTag: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function saveDialViewTag(params: {
@@ -343,6 +1563,24 @@ declare namespace ty.outdoor {
    * 保存骑行语音播报数据
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.saveTTSData({
+   *   ttsMainSwitch: false,
+   *   weather: false,
+   *   abnormalWear: false,
+   *   cyclingMileage: false,
+   *   lowBattery: false,
+   *   electricThreshold: 1,
+   *   callReminder: false,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function saveTTSData(params: {
@@ -357,12 +1595,12 @@ declare namespace ty.outdoor {
      */
     weather: boolean
     /**
-     * 骑行数据播报总开关
+     * 异常佩戴播报开关
      * @since OutdoorKit 1.0.1
      */
     abnormalWear: boolean
     /**
-     * 骑行里程
+     * 骑行里程播报开关
      * @since OutdoorKit 1.0.1
      */
     cyclingMileage: boolean
@@ -372,12 +1610,12 @@ declare namespace ty.outdoor {
      */
     lowBattery: boolean
     /**
-     * 具体电量数值
+     * 低电量播报阈值，电量低于该百分比时触发播报
      * @since OutdoorKit 1.0.1
      */
     electricThreshold: number
     /**
-     * 骑行里程
+     * 来电提醒播报开关
      * @since OutdoorKit 1.0.1
      */
     callReminder: boolean
@@ -405,6 +1643,17 @@ declare namespace ty.outdoor {
    * 获取骑行播报数据
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getTTSData({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getTTSData(params?: {
@@ -423,12 +1672,12 @@ declare namespace ty.outdoor {
        */
       weather: boolean
       /**
-       * 骑行数据播报总开关
+       * 异常佩戴播报开关
        * @since OutdoorKit 1.0.1
        */
       abnormalWear: boolean
       /**
-       * 骑行里程
+       * 骑行里程播报开关
        * @since OutdoorKit 1.0.1
        */
       cyclingMileage: boolean
@@ -438,12 +1687,12 @@ declare namespace ty.outdoor {
        */
       lowBattery: boolean
       /**
-       * 具体电量数值
+       * 低电量播报阈值，电量低于该百分比时触发播报
        * @since OutdoorKit 1.0.1
        */
       electricThreshold: number
       /**
-       * 骑行里程
+       * 来电提醒播报开关
        * @since OutdoorKit 1.0.1
        */
       callReminder: boolean
@@ -468,6 +1717,17 @@ declare namespace ty.outdoor {
    * 是否有通话权限
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.isCallPhoneGranted({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function isCallPhoneGranted(params?: {
@@ -495,6 +1755,17 @@ declare namespace ty.outdoor {
    * 申请通话权限
    * @public
    * @since OutdoorKit 1.0.1
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.requestCallPhonePermission({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function requestCallPhonePermission(params?: {
@@ -519,9 +1790,21 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 是否为BLE+X设备
+   * 判断是否为 BLE+X 设备
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.isBLEXDevice({
+   *   deviceID: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function isBLEXDevice(params: {
@@ -551,9 +1834,21 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * BLE+X是否已激活 前置条件:是BLE+X设备
+   * 判断 BLE+X 设备是否已激活，前置条件：该设备为 BLE+X 设备
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.isBLEXDeviceActived({
+   *   deviceID: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function isBLEXDeviceActived(params: {
@@ -583,9 +1878,21 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 获取 扩展模组关联事件配置
+   * 获取扩展模组关联事件配置
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getExtendedModuleExtConfig({
+   *   deviceID: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getExtendedModuleExtConfig(params: {
@@ -599,17 +1906,17 @@ declare namespace ty.outdoor {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * auto_active / manual_active
+       * 激活方式，取值：auto_active（自动激活）/ manual_active（手动激活）
        * @since OutdoorKit 1.1.0
        */
       activeType: string
       /**
-       * disabled / hide
+       * 未激活时的交互方式，取值：disabled（置灰禁用）/ hide（隐藏）
        * @since OutdoorKit 1.1.0
        */
       interactionType: string
       /**
-       * [dpID]
+       * 关联的 dpID 列表
        * @since OutdoorKit 1.1.0
        */
       assocaitedDps: number[]
@@ -631,9 +1938,21 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 获取设备增值服务能力
+   * 获取设备增值服务能力，返回以字典形式透传的能力数据
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getValueAddedServicesAbility({
+   *   deviceID: "xx",
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function getValueAddedServicesAbility(params: {
@@ -647,7 +1966,7 @@ declare namespace ty.outdoor {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 结果
+       * 透传结果字典，键值对内容由业务侧定义
        * @since OutdoorKit 1.1.0
        */
       result: Record<any, any>
@@ -669,9 +1988,22 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 设置弹窗状态
+   * 设置增值服务弹窗状态，记录指定设备是否已弹窗过
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setValueAddedServicesPop({
+   *   deviceID: "xx",
+   *   hadPopup: false,
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function setValueAddedServicesPop(params: {
@@ -709,11 +2041,15 @@ declare namespace ty.outdoor {
    * 获取感应解锁类型
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getInductiveUnlockType({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function getInductiveUnlockType(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -722,7 +2058,7 @@ declare namespace ty.outdoor {
     /** 接口调用成功的回调函数 */
     success?: (params: {
       /**
-       * 感应解锁类型 位移枚举转换 InductiveUnlockTypeBLEHID = 1 << 0, InductiveUnlockTypeBT = 1 << 1
+       * 感应解锁类型，按位枚举：InductiveUnlockTypeBLEHID = 1 << 0，InductiveUnlockTypeBT = 1 << 1
        * @since OutdoorKit 1.1.0
        */
       inductiveUnlockType: number
@@ -744,14 +2080,18 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 获取 HID 感应解锁 状态 true:开启 false:关闭
+   * 获取 HID 感应解锁开关状态
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getHIDInductiveUnlockStatus({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function getHIDInductiveUnlockStatus(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -776,14 +2116,18 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 获取 HID 感应解锁绑定状态 true:已绑定 false:未绑定
+   * 获取 HID 感应解锁绑定状态
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getHIDInductiveUnlockBindStatus({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function getHIDInductiveUnlockBindStatus(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -811,11 +2155,15 @@ declare namespace ty.outdoor {
    * 开启 HID 感应解锁
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.turnOnHIDInductiveUnlock({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function turnOnHIDInductiveUnlock(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -843,11 +2191,15 @@ declare namespace ty.outdoor {
    * 关闭 HID 感应解锁
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.turnOffHIDInductiveUnlock({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function turnOffHIDInductiveUnlock(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -872,14 +2224,18 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * HID 感应解锁 添加设防距离
+   * 记录 HID 感应解锁的设防距离（在当前位置标定设防距离）
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.recordHIDInductiveUnlockFortifyDistance({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function recordHIDInductiveUnlockFortifyDistance(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -904,14 +2260,18 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * HID 感应解锁 添加解防距离
+   * 记录 HID 感应解锁的解防距离（在当前位置标定解防距离）
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.recordHIDInductiveUnlockDisarmDistance({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function recordHIDInductiveUnlockDisarmDistance(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -936,14 +2296,18 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 获取 BT 感应解锁 配对状态
+   * 获取 BT 感应解锁配对状态
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getBTInductiveUnlockPairedStatus({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function getBTInductiveUnlockPairedStatus(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -971,11 +2335,15 @@ declare namespace ty.outdoor {
    * 开启 BT 感应解锁
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.turnOnBTInductiveUnlock({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function turnOnBTInductiveUnlock(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -1003,11 +2371,15 @@ declare namespace ty.outdoor {
    * 关闭 BT 感应解锁
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.turnOffBTInductiveUnlock({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function turnOffBTInductiveUnlock(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -1032,9 +2404,13 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 设置 BT 感应解锁距离 1、2、3
+   * 设置 BT 感应解锁距离档位（可选值 1、2、3）
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.setBTInductiveUnlockDistance({ deviceID: "xx", distance: 1, success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function setBTInductiveUnlockDistance(params: {
@@ -1044,7 +2420,7 @@ declare namespace ty.outdoor {
      */
     deviceID: string
     /**
-     * 距离 1、2、3
+     * 距离档位（可选值 1、2、3）
      * @since OutdoorKit 1.1.0
      */
     distance: number
@@ -1069,14 +2445,18 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 获取 BT 感应解锁距离
+   * 获取 BT 感应解锁距离档位
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.getBTInductiveUnlockDistance({ deviceID: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function getBTInductiveUnlockDistance(params: {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -1090,7 +2470,7 @@ declare namespace ty.outdoor {
        */
       deviceID: string
       /**
-       * 距离 1、2、3
+       * 距离档位（可选值 1、2、3）
        * @since OutdoorKit 1.1.0
        */
       distance: number
@@ -1115,11 +2495,15 @@ declare namespace ty.outdoor {
    * 设备绑定
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.createBond({ deviceMac: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function createBond(params: {
     /**
-     * 设备Mac地址
+     * 设备 MAC 地址（需大写）
      * @since OutdoorKit 1.1.0
      */
     deviceMac: string
@@ -1147,11 +2531,15 @@ declare namespace ty.outdoor {
    * 移除绑定
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.removeBond({ deviceMac: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function removeBond(params: {
     /**
-     * 设备Mac地址
+     * 设备 MAC 地址（需大写）
      * @since OutdoorKit 1.1.0
      */
     deviceMac: string
@@ -1179,11 +2567,15 @@ declare namespace ty.outdoor {
    * 是否已绑定
    * @public
    * @since OutdoorKit 1.1.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.isBond({ deviceMac: "xx", success: data => { console.log(data); }, fail: error => { console.error(error); } });
+   * ```
    * @platform iOS Android
    */
   export function isBond(params: {
     /**
-     * 设备Mac地址
+     * 设备 MAC 地址（需大写）
      * @since OutdoorKit 1.1.0
      */
     deviceMac: string
@@ -1208,9 +2600,47 @@ declare namespace ty.outdoor {
   }): void
 
   /**
-   * 注册当前设备监听
+   * 注册文件下载进度监听（事件体 DownloadProgressEvent，通过 downloadProgress 事件推送）
+   * @public
+   * @since OutdoorKit 7.8.0
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.downloadProgress(e => {
+   *   console.log(e);
+   * });
+   * ```
+   * @platform iOS Android
+   */
+  export function onRegisterDownloadProgress(
+    listener: (params: {
+      /**
+       * 远端文件路径
+       * @since OutdoorKit 7.8.0
+       */
+      remotePath: string
+      /**
+       * 下载进度 0~100
+       * @since OutdoorKit 7.8.0
+       */
+      progress: number
+      /**
+       * 下载状态：downloading/completed/failed
+       * @since OutdoorKit 7.8.0
+       */
+      status: string
+    }) => void
+  ): void
+
+  /**
+   * 注册当前首页展示设备变化监听，设备切换时回调最新设备信息
    * @public
    * @since OutdoorKit 1.1.8
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.currentDeviceChange(e => {
+   *   console.log(e);
+   * });
+   * ```
    * @platform iOS Android
    */
   export function onRegisterCurrentDeviceChange(
@@ -1224,9 +2654,20 @@ declare namespace ty.outdoor {
   ): void
 
   /**
-   * 取消当前设备监听
+   * 取消当前首页展示设备变化监听
    * @public
    * @since OutdoorKit 1.1.8
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.offRegisterCurrentDeviceChange({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function offRegisterCurrentDeviceChange(
@@ -1240,9 +2681,15 @@ declare namespace ty.outdoor {
   ): void
 
   /**
-   * 注册扩展模块插拔状态监听
+   * 注册扩展模组插拔状态监听，模组插入或拔出时回调
    * @public
    * @since OutdoorKit 1.1.6
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.extModuleStatusChange(e => {
+   *   console.log(e);
+   * });
+   * ```
    * @platform iOS Android
    */
   export function onRegisterExtModuleStatus(
@@ -1253,7 +2700,7 @@ declare namespace ty.outdoor {
        */
       devID: string
       /**
-       * 状态 1:插入模组
+       * 扩展模组状态 1:插入模组 0:拔出模组
        * @since OutdoorKit 1.1.1
        */
       status: number
@@ -1261,9 +2708,20 @@ declare namespace ty.outdoor {
   ): void
 
   /**
-   * 取消扩展模块插拔状态监听
+   * 取消扩展模组插拔状态监听
    * @public
    * @since OutdoorKit 1.1.6
+   * @example Demo
+   * ```tsx
+   * ty.outdoor.offRegisterExtModuleStatus({
+   *   success: data => {
+   *     console.log(data);
+   *   },
+   *   fail: error => {
+   *     console.error(error);
+   *   },
+   * });
+   * ```
    * @platform iOS Android
    */
   export function offRegisterExtModuleStatus(
@@ -1274,13 +2732,457 @@ declare namespace ty.outdoor {
        */
       devID: string
       /**
-       * 状态 1:插入模组
+       * 扩展模组状态 1:插入模组 0:拔出模组
        * @since OutdoorKit 1.1.1
        */
       status: number
     }) => void
   ): void
 
+  /**
+   * SDK 初始化参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface InitSDKParams {
+    /**
+     * 密钥文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    keyPath: string
+    /**
+     * 日志输出目录
+     * @since OutdoorKit 7.8.0
+     */
+    loggerDir: string
+  }
+
+  /**
+   * 摄像头信息返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface CameraInfoResponse {
+    /**
+     * 设备序列号
+     * @since OutdoorKit 7.8.0
+     */
+    sn: string
+    /**
+     * 产品编号
+     * @since OutdoorKit 7.8.0
+     */
+    pn: string
+    /**
+     * SKU 编码
+     * @since OutdoorKit 7.8.0
+     */
+    sku: string
+    /**
+     * 当前固件版本
+     * @since OutdoorKit 7.8.0
+     */
+    firmwareVersion: string
+    /**
+     * 绑定状态：0=未绑定, 1=已绑定
+     * @since OutdoorKit 7.8.0
+     */
+    isBind: number
+    /**
+     * 剩余存储空间（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    freeSpace: number
+    /**
+     * 总存储空间（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    totalSpace: number
+    /**
+     * 已用存储空间（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    usedSpace: number
+    /**
+     * RTSP 服务状态：0=关闭, 1=开启
+     * @since OutdoorKit 7.8.0
+     */
+    rtspStatus: number
+    /**
+     * 当前帧率（单位 fps）
+     * @since OutdoorKit 7.8.0
+     */
+    fps: number
+    /**
+     * 当前码率（单位 kbps）
+     * @since OutdoorKit 7.8.0
+     */
+    bitRate: number
+    /**
+     * 当前录制分段间隔（单位：秒）
+     * @since OutdoorKit 7.8.0
+     */
+    recordInterval: number
+    /**
+     * AI 功能状态：0=关闭, 1=开启
+     * @since OutdoorKit 7.8.0
+     */
+    aiEnabled: number
+  }
+
+  /**
+   * WiFi 配置参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface SetWifiParams {
+    /**
+     * WiFi 名称
+     * @since OutdoorKit 7.8.0
+     */
+    ssid: string
+    /**
+     * WiFi 密码
+     * @since OutdoorKit 7.8.0
+     */
+    password: string
+  }
+
+  /**
+   * 设置帧率参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface SetFPSParams {
+    /**
+     * 帧率值，支持 25 或 30
+     * @since OutdoorKit 7.8.0
+     */
+    fps: number
+  }
+
+  /**
+   * 帧率返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface FPSResponse {
+    /**
+     * 当前帧率（单位 fps，通常为 25 或 30）
+     * @since OutdoorKit 7.8.0
+     */
+    fps: number
+  }
+
+  /**
+   * 设置码率参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface SetBitRateParams {
+    /**
+     * 码率值（单位 kbps）
+     * @since OutdoorKit 7.8.0
+     */
+    bitRate: number
+  }
+
+  /**
+   * 码率返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface BitRateResponse {
+    /**
+     * 当前码率（单位 kbps）
+     * @since OutdoorKit 7.8.0
+     */
+    bitRate: number
+  }
+
+  /**
+   * 设置录制间隔参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface SetRecordIntervalParams {
+    /**
+     * 录制间隔，支持 60/120/180/300（秒）
+     * @since OutdoorKit 7.8.0
+     */
+    interval: number
+  }
+
+  /**
+   * 录制间隔返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface RecordIntervalResponse {
+    /**
+     * 当前录制间隔（秒）
+     * @since OutdoorKit 7.8.0
+     */
+    interval: number
+  }
+
+  /**
+   * 设置 AI 功能参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface SetAIEnabledParams {
+    /**
+     * AI 功能开关：0=关闭, 1=开启
+     * @since OutdoorKit 7.8.0
+     */
+    enabled: number
+  }
+
+  /**
+   * AI 功能状态返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface AIStatusResponse {
+    /**
+     * AI 功能状态：0=关闭, 1=开启
+     * @since OutdoorKit 7.8.0
+     */
+    enabled: number
+  }
+
+  /**
+   * 固件版本信息返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface FirmwareInfoResponse {
+    /**
+     * 当前固件版本号
+     * @since OutdoorKit 7.8.0
+     */
+    currentVersion: string
+    /**
+     * 是否有可用更新：0=无, 1=有
+     * @since OutdoorKit 7.8.0
+     */
+    hasUpdate: number
+  }
+
+  /**
+   * 固件升级参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface UpgradeFirmwareParams {
+    /**
+     * 固件文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    firmwarePath: string
+  }
+
+  /**
+   * 通用路径参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface PathParam {
+    /**
+     * 目标路径
+     * @since OutdoorKit 7.8.0
+     */
+    path: string
+  }
+
+  /**
+   * 文件项
+   * @since OutdoorKit 7.8.0
+   */
+  export interface FileItem {
+    /**
+     * 文件名称
+     * @since OutdoorKit 7.8.0
+     */
+    name: string
+    /**
+     * 文件完整路径
+     * @since OutdoorKit 7.8.0
+     */
+    path: string
+    /**
+     * 文件大小（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    size: number
+    /**
+     * 最后修改时间（ISO 时间字符串）
+     * @since OutdoorKit 7.8.0
+     */
+    lastChanged: string
+    /**
+     * 文件类型：0=普通文件, 1=目录
+     * @since OutdoorKit 7.8.0
+     */
+    isDir: number
+    /**
+     * 设备侧 HTTP 播放地址（与 RideSafe 列表 JSON 中 remote_url 对应；可能为空字符串）
+     * @since OutdoorKit 7.8.0
+     */
+    remoteUrl: string
+  }
+
+  /**
+   * 获取下载/在线播放鉴权头返回模型（info.header，供播放器 HTTP Header 使用）
+   * @since OutdoorKit 7.8.0
+   */
+  export interface DownloadAuthHeaderResponse {
+    /**
+     * 鉴权头原始字符串（多行 key: value，与肇观 Demo getHeader 一致）
+     * @since OutdoorKit 7.8.0
+     */
+    header: string
+  }
+
+  /**
+   * 文件列表返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface FileListResponse {
+    /**
+     * 文件列表
+     * @since OutdoorKit 7.8.0
+     */
+    files: FileItem[]
+  }
+
+  /**
+   * 文件下载参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface DownloadFileParams {
+    /**
+     * 远端文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    remotePath: string
+    /**
+     * 本地存储路径
+     * @since OutdoorKit 7.8.0
+     */
+    localPath: string
+    /**
+     * 可选：文件大小（字节），与 getFileList 中 FileItem.size 一致时可传，用于下载后校验与 post_verify 阶段进度。
+     * @since OutdoorKit 7.8.0
+     */
+    fileSizeBytes?: number
+    /**
+     * Android-only: 下载完成后是否将文件额外导出到系统公共 Downloads 目录（Download/nvpdownload/<name>）。
+     * 默认 true，Android 上会把文件同时写入用户可见的 Downloads 目录（与 Sample 的列表下载一致）；传 false 则仅保留到 localPath（应用私有缓存）。
+     * iOS / HarmonyOS 当前不实现该行为，字段仅为多端对齐预留。
+     * @since OutdoorKit 7.8.0
+     */
+    exportToPublicDownloads?: boolean
+    /**
+     * Android-only: 成功导出到公共 Downloads 后，是否删除 localPath 指向的原始副本。
+     * 不传（默认）时使用智能策略：未传 localPath（由 lib 自动生成 cache 路径）→ 删除；传了 localPath → 保留。
+     * 显式传 true/false 会覆盖默认策略。export 失败或关闭时永不删除。
+     * @since OutdoorKit 7.8.0
+     */
+    deleteLocalAfterExport?: boolean
+  }
+
+  /**
+   * 批量删除文件参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface DeleteFilesParams {
+    /**
+     * 待删除文件路径列表
+     * @since OutdoorKit 7.8.0
+     */
+    paths: string[]
+  }
+
+  /**
+   * 批量删除文件返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface DeleteFilesResponse {
+    /**
+     * 成功删除的文件数量
+     * @since OutdoorKit 7.8.0
+     */
+    deletedCount: number
+  }
+
+  /**
+   * 存储空间信息返回模型
+   * @since OutdoorKit 7.8.0
+   */
+  export interface FreeSpaceResponse {
+    /**
+     * 可用空间（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    free: number
+    /**
+     * 已用空间（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    used: number
+    /**
+     * 总空间（字节）
+     * @since OutdoorKit 7.8.0
+     */
+    total: number
+  }
+
+  /**
+   * 文件下载进度事件数据
+   * @since OutdoorKit 7.8.0
+   */
+  export interface DownloadProgressEvent {
+    /**
+     * 远端文件路径
+     * @since OutdoorKit 7.8.0
+     */
+    remotePath: string
+    /**
+     * 下载进度 0~100
+     * @since OutdoorKit 7.8.0
+     */
+    progress: number
+    /**
+     * 下载状态：downloading/completed/failed
+     * @since OutdoorKit 7.8.0
+     */
+    status: string
+  }
+
+  /**
+   * 视频播放参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface PlayVideoParams {
+    /**
+     * 视频播放地址（远端 HTTP 流地址或本地文件路径，鉴权头由原生内部自动获取）
+     * @since OutdoorKit 7.8.0
+     */
+    url: string
+    /**
+     * 可选：文件大小（字节），与 getFileList 中 FileItem.size 一致时可传。
+     * 当 ExoPlayer 无法从容器头取到 duration（NVP 设备 TS 流常见）时，用字节数 + 估算码率推导合理的总时长与进度条范围；
+     * 不传则播放总时长可能显示异常、进度条无法拖动（与 Sample 列表播放保持一致即不会出现该问题）。
+     * @since OutdoorKit 7.8.0
+     */
+    fileSizeBytes?: number
+  }
+
+  /**
+   * 一键连接设备参数
+   * @since OutdoorKit 7.8.0
+   */
+  export interface ConnectDeviceParams {
+    /**
+     * 设备热点 SSID
+     * @since OutdoorKit 7.8.0
+     */
+    ssid: string
+    /**
+     * 设备热点密码
+     * @since OutdoorKit 7.8.0
+     */
+    password: string
+  }
+
   /**
    * 设备
    * @since OutdoorKit 1.0.0
@@ -1396,12 +3298,12 @@ declare namespace ty.outdoor {
      */
     weather: boolean
     /**
-     * 骑行数据播报总开关
+     * 异常佩戴播报开关
      * @since OutdoorKit 1.0.1
      */
     abnormalWear: boolean
     /**
-     * 骑行里程
+     * 骑行里程播报开关
      * @since OutdoorKit 1.0.1
      */
     cyclingMileage: boolean
@@ -1411,12 +3313,12 @@ declare namespace ty.outdoor {
      */
     lowBattery: boolean
     /**
-     * 具体电量数值
+     * 低电量播报阈值，电量低于该百分比时触发播报
      * @since OutdoorKit 1.0.1
      */
     electricThreshold: number
     /**
-     * 骑行里程
+     * 来电提醒播报开关
      * @since OutdoorKit 1.0.1
      */
     callReminder: boolean
@@ -1428,17 +3330,17 @@ declare namespace ty.outdoor {
    */
   export interface ExtendedModuleExtConfig {
     /**
-     * auto_active / manual_active
+     * 激活方式，取值：auto_active（自动激活）/ manual_active（手动激活）
      * @since OutdoorKit 1.1.0
      */
     activeType: string
     /**
-     * disabled / hide
+     * 未激活时的交互方式，取值：disabled（置灰禁用）/ hide（隐藏）
      * @since OutdoorKit 1.1.0
      */
     interactionType: string
     /**
-     * [dpID]
+     * 关联的 dpID 列表
      * @since OutdoorKit 1.1.0
      */
     assocaitedDps: number[]
@@ -1450,7 +3352,7 @@ declare namespace ty.outdoor {
    */
   export interface MapResponse {
     /**
-     * 结果
+     * 透传结果字典，键值对内容由业务侧定义
      * @since OutdoorKit 1.1.0
      */
     result: Record<any, any>
@@ -1484,7 +3386,7 @@ declare namespace ty.outdoor {
      */
     devID: string
     /**
-     * 状态 1:插入模组
+     * 扩展模组状态 1:插入模组 0:拔出模组
      * @since OutdoorKit 1.1.1
      */
     status: number
@@ -1496,7 +3398,7 @@ declare namespace ty.outdoor {
    */
   export interface DeviceBean {
     /**
-     * 设备Mac地址
+     * 设备 ID
      * @since OutdoorKit 1.1.0
      */
     deviceID: string
@@ -1508,7 +3410,7 @@ declare namespace ty.outdoor {
    */
   export interface InductiveUnlockBean {
     /**
-     * 感应解锁类型 位移枚举转换 InductiveUnlockTypeBLEHID = 1 << 0, InductiveUnlockTypeBT = 1 << 1
+     * 感应解锁类型，按位枚举：InductiveUnlockTypeBLEHID = 1 << 0，InductiveUnlockTypeBT = 1 << 1
      * @since OutdoorKit 1.1.0
      */
     inductiveUnlockType: number
@@ -1525,7 +3427,7 @@ declare namespace ty.outdoor {
      */
     deviceID: string
     /**
-     * 距离 1、2、3
+     * 距离档位（可选值 1、2、3）
      * @since OutdoorKit 1.1.0
      */
     distance: number
@@ -1537,7 +3439,7 @@ declare namespace ty.outdoor {
    */
   export interface DeviceInfo {
     /**
-     * 设备Mac地址
+     * 设备 MAC 地址（需大写）
      * @since OutdoorKit 1.1.0
      */
     deviceMac: string