ms-types 0.0.8 → 0.0.10

package/types/system.d.ts

@@ -0,0 +1,78 @@
+declare namespace system {
+  /**
+   * 启动应用
+   * @param bundleId 应用bundleId
+   * @param args 应用参数
+   * @param env 应用环境变量
+   * @returns 是否启动成功
+   */
+  function startApp(
+    bundleId: string,
+    args: string[],
+    env: Record<string, any>
+  ): boolean;
+  /**
+   * 关闭应用
+   * @param bundleId 应用bundleId
+   * @returns 是否关闭成功
+   */
+  function stopApp(bundleId: string): boolean;
+  /**
+   * 激活应用
+   * @param bundleId 应用bundleId
+   * @returns 是否激活成功
+   */
+  function activateApp(bundleId: string): boolean;
+  /**
+   * 获取激活应用信息
+   * @returns 激活应用信息
+   */
+  function activateAppInfo(): {
+    bundleId: string;
+    name: string;
+    pid: number;
+    processArguments: {
+      env: Record<string, any>;
+      args: string[];
+    };
+  } | null;
+  /**
+   * 获取系统是否锁屏
+   * @returns 是否锁屏
+   */
+  function isLocked(): boolean;
+  /**
+   * 锁屏
+   * @returns 是否锁屏成功
+   */
+  function lock(): boolean;
+  /**
+   * 解锁
+   * @returns 是否解锁成功
+   */
+  function unlock(): boolean;
+  /**
+   * 设置剪贴板 APP 在前台运行时才能设置
+   * @param text 剪贴板内容
+   * @returns 是否设置成功
+   */
+  function setClipboard(text: string): boolean;
+  /**
+   * 获取剪贴板
+   * @returns 剪贴板内容
+   */
+  function getClipboard(): string | null;
+  /**
+   * 打开URL
+   * @param url URL
+   * @returns 是否打开成功
+   */
+  function openURL(url: string): boolean;
+  /**
+   * 通知
+   * @param msg 通知内容
+   * @param title 通知标题
+   * @param id 通知id
+   */
+  function notify(msg: string, title: string, id: string): void;
+}

package/types/thread.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 当前线程名称
+ */
+declare let __threadName__: string;
+/**
+ * 线程相关函数
+ */
+declare namespace thread {
+  /**
+   * 异步执行线程代码
+   * @param threadJsFile 线程js文件路径
+   * @param callbackName 回调函数名称
+   * @param callbackFunc 回调函数
+   * @returns 线程id
+   */
+  function execCodeAsync(
+    threadJsFile: string,
+    callbackName: string,
+    callbackFunc: (data?: any) => void
+  ): String | null;
+  /**
+   * 调用线程回调函数
+   * @param name 线程名称
+   * @param data 回调数据
+   */
+  function invokeCallback(name: string, data?: any): void;
+  /**
+   * 创建新线程
+   * @param threadJsFile 线程js文件路径
+   * @returns 线程id
+   */
+  function newThread(threadJsFile: string): {
+    addCallback: (
+      callbackName: string,
+      callbackFunc: (data?: any) => void
+    ) => boolean;
+  } | null;
+  /**
+   * 取消线程
+   * @param name 线程名称
+   * @returns 是否取消成功
+   */
+  function cancelThread(name: string): boolean;
+  /**
+   * 检查线程是否已取消
+   * @param name 线程名称
+   * @returns 是否已取消
+   */
+  function isCancelled(name: string): boolean;
+  /**
+   * 停止所有线程
+   * @returns 是否停止成功
+   */
+  function stopAll(): boolean;
+}

package/types/ui.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 注册 UI 函数
+ * @param name 函数名称
+ * @param func 函数
+ */
+declare function registerUIFunc(name: string, func: (data: any) => void): void;
+
+/**
+ * 发送事件
+ * @param event 事件名称
+ * @param data 事件参数
+ */
+declare function emitEvent(event: string, data: any): void;
+
+declare namespace ui {
+  interface WebView {
+    /**
+     * 显示WebView
+     */
+    show(): void;
+    /**
+     * 关闭WebView
+     */
+    close(): void;
+    /**
+     * 调用WebView中的方法
+     * @param key 方法名
+     * @param data 方法参数
+     */
+    call(key: string, data: any): void;
+  }
+  /**
+   * 创建WebView
+   * @param file 文件名
+   * @param onEvent 事件回调
+   * @returns WebView实例
+   */
+  function newWebView(
+    file: string,
+    onEvent: (event: string, data: any) => void
+  ): WebView;
+}

package/types/utils.d.ts

@@ -0,0 +1,37 @@
+declare namespace utils {
+  /**
+   * 格式化时间
+   * @param format 格式化字符串
+   * @returns 格式化后的时间字符串
+   */
+  function timeFormat(format: string): string;
+  /**
+   * 读取资源文件
+   * @param fileName 文件名
+   * @returns 文件内容
+   */
+  function readResFile(fileName: string): string | null;
+  /**
+   * 读取资源图片
+   * @param fileName 文件名
+   * @returns 图片内容
+   */
+  function readResImage(fileName: string): string | null;
+  /**
+   * 获取资源文件路径
+   * @param fileName 文件名
+   * @returns 资源文件路径
+   */
+  function getResFilePath(fileName: string): string;
+  /**
+   * 生成随机数
+   * @param min 最小值
+   * @param max 最大值
+   * @returns 随机数
+   */
+  function random(min: number, max: number): number;
+  /**
+   * 将应用置入前台
+   */
+  function takeMeToFront(): void;
+}

package/types/workerThread.d.ts

@@ -0,0 +1,68 @@
+declare const __workerName__: string;
+
+declare namespace workerThread {
+  /**
+   * 创建新线程
+   * @param name 线程名称
+   * @returns 线程id
+   */
+  function newWorker(name: string): string;
+  /**
+   * 检查线程是否运行
+   * @param name 线程名称
+   * @returns 是否运行
+   */
+  function isRunning(name: string): boolean;
+  /**
+   * 检查线程是否有函数
+   * @param funcName 函数名称
+   * @returns 是否有函数
+   */
+  function hasWorkerFunction(funcName: string): boolean;
+  /**
+   * 添加线程函数
+   * @param funcName 函数名称
+   * @param func 函数
+   * @returns 是否添加成功
+   */
+  function addWorkerFunction(
+    funcName: string,
+    func: (data: any) => any
+  ): boolean;
+  /**
+   * 移除线程函数
+   * @param funcName 函数名称
+   * @returns 是否移除成功
+   */
+  function removeWorkerFunction(funcName: string): boolean;
+  /**
+   * 调用线程函数
+   * @param funcName 函数名称
+   * @param data 数据
+   * @returns 调用结果
+   */
+  function callWorkerFunction(funcName: string, data: any): any;
+  /**
+   * 移除线程
+   * @param name 线程名称
+   * @returns 是否移除成功
+   */
+  function removeWorker(name: string): boolean;
+  /**
+   * 检查线程是否取消
+   * @param name 线程名称
+   * @returns 是否取消
+   */
+  function isCancelled(name: string): boolean;
+  /**
+   * 取消线程
+   * @param name 线程名称
+   * @returns 是否取消成功
+   */
+  function cancelWorker(name: string): boolean;
+  /**
+   * 停止所有线程
+   * @returns 是否停止成功
+   */
+  function stopAll(): boolean;
+}

package/types/yolo.d.ts

@@ -0,0 +1,93 @@
+/**
+ * YOLO目标检测模块类型定义
+ */
+declare namespace yolo {
+  /**
+   * YOLO检测结果
+   */
+  type YoloResult = {
+    /**
+     * 检测框的左上角x坐标
+     */
+    x: number;
+    /**
+     * 检测框的左上角y坐标
+     */
+    y: number;
+    /**
+     * 检测框的右下角x坐标
+     */
+    ex: number;
+    /**
+     * 检测框的右下角y坐标
+     */
+    ey: number;
+    /**
+     * 检测框的中心点x坐标
+     */
+    centerX: number;
+    /**
+     * 检测框的中心点y坐标
+     */
+    centerY: number;
+    /**
+     * 检测框的宽度
+     */
+    width: number;
+    /**
+     * 检测框的高度
+     */
+    height: number;
+    /**
+     * 检测框的置信度
+     */
+    confidence: number;
+    /**
+     * 检测框的类别ID
+     */
+    classId: number;
+  };
+
+  /**
+   * 加载YOLOv11模型
+   * @param paramPath ncnn模型的param文件的绝对路径
+   * @param binPath ncnn模型的bin文件绝对路径
+   * @param nc 模型的标签数量,可在标签集data.yaml中看到
+   * @param useGpu 是否启动gpu，默认用cpu
+   * @returns 加载成功返回模型ID字符串，失败返回null
+   */
+  function loadV11(
+    paramPath: string,
+    binPath: string,
+    nc: number,
+    useGpu: boolean
+  ): string | null;
+
+  /**
+   * 目标检测
+   * @param modelId 模型ID
+   * @param img 图像ID，默认null用当前屏幕检测，可以填入图像ID或者http图片地址或文件地址
+   * @param targetSize 图像进入后缩放的检测大小，模型训练一般都用640，因此这里的640一般不要改
+   * @param threshold 置信度，默认0.4，小于这个值的会被过滤掉
+   * @param nmsThreshold 重叠阈值，一般是0.5不需要更改
+   * @returns 检测结果数组
+   */
+  function detect(
+    modelId: string,
+    img: string | null,
+    targetSize: number,
+    threshold: number,
+    nmsThreshold: number
+  ): YoloResult[];
+
+  /**
+   * 释放指定模型资源
+   * @param modelId 模型ID
+   */
+  function free(modelId: string): void;
+
+  /**
+   * 释放所有模型资源
+   */
+  function freeAll(): void;
+}