更新记录

1.0.1（2025-11-13）

修改文件内容

1.0.0（2025-11-13）

初始化

平台兼容性

uni-app(4.84)

uni-app x(4.84)

其他

hsoft-VSshot

一个用于 uni-app 和 uni-app x 的屏幕截图插件，支持 Android 和 HarmonyOS 平台的应用内截图功能。

📋 功能特性

• ✅ 支持 Android 和 HarmonyOS 平台
• ✅ 应用内截图（截图当前应用界面）
• ✅ 权限申请管理
• ✅ 支持 uni-app 和 uni-app x 两种开发模式
• ✅ 简单易用的 API 接口

📦 安装

方式一：从插件市场安装

1. 在 uni-app 插件市场选择试用
2. 绑定要试用的项目 appid
3. 下载插件到本地项目

方式二：手动安装

将插件目录复制到项目的 uni_modules 目录下。

🚀 快速开始

1. 引入插件

在需要使用截图的页面或组件中引入插件：

import { 
  screenShot,
  ScreenData, 
  reuqestScreen,
  stopscreenShotSystem,
  capScreenShotSystem 
} from '@/uni_modules/hsoft-VSshot';

2. 请求截图权限

在使用截图功能前，需要先申请截图权限：

reuqestScreen({
  callback: function(b) {
    // 权限申请结果回调
    console.log('权限申请结果:', b);
  },
  perCallback: function(b) {
    // 权限状态回调
    console.log('权限状态:', b);
  }
});

3. 开始截图

// 开始截图（5秒后执行）
setTimeout(function() {
  capScreenShotSystem();
}, 5000);

4. 停止截图

stopscreenShotSystem();

5. 获取截图结果

screenShot(function(b) {
  // b 为截图的 base64 字符串或图片路径
  console.log('截图结果:', b);
  // 可以将 b 赋值给 image 组件的 src 属性显示
});

📖 API 文档

screenShot(callback)

获取截图结果。

参数：

• callback: Function - 回调函数，参数为截图结果（base64 字符串或图片路径）

示例：

screenShot(function(b) {
  console.log(b);
});

reuqestScreen(options)

请求应用截图权限。

参数：

• options: Object - 配置对象
  • callback: Function - 权限申请结果回调，参数为结果字符串
  • perCallback: Function - 权限状态回调，参数为布尔值

示例：

reuqestScreen({
  callback: function(b) {
    console.log('权限申请结果:', b);
  },
  perCallback: function(b) {
    console.log('权限状态:', b);
  }
});

capScreenShotSystem()

开始系统截图。

说明： 调用此方法后，系统会在后台开始截图。

示例：

capScreenShotSystem();

stopscreenShotSystem()

停止系统截图。

示例：

stopscreenShotSystem();

💻 使用示例

uni-app x 版本

import { 
  screenShot, 
  reuqestScreen, 
  stopscreenShotSystem, 
  capScreenShotSystem 
} from '@/uni_modules/hsoft-VSshot';

// 请求权限
reuqestScreen({
  callback: function(b: string) {
    console.log('权限结果:', b);
  },
  perCallback: function(b: boolean) {
    console.log('权限状态:', b);
  }
});

// 获取截图
screenShot(function(b: string) {
  console.log('截图结果:', b);
});

// 开始截图
capScreenShotSystem();

// 停止截图
stopscreenShotSystem();

uni-app 版本

import { 
  screenShot, 
  reuqestScreen, 
  stopscreenShotSystem, 
  capScreenShotSystem 
} from '@/uni_modules/hsoft-VSshot';

// 请求权限
reuqestScreen({
  callback: function(b) {
    console.log('权限结果:', b);
  },
  perCallback: function(b) {
    console.log('权限状态:', b);
  }
});

// 获取截图
screenShot(function(b) {
  console.log('截图结果:', b);
});

// 开始截图
capScreenShotSystem();

// 停止截图
stopscreenShotSystem();

🧪 测试方法

1. 安装插件

按照上述安装步骤将插件引入项目。

2. 制作自定义基座

1. 在 HBuilderX 中选择 发布 → 原生 App-云打包
2. 选择 制作基座
3. 等待基座制作完成

3. 运行到设备

1. 选择 运行 → 运行到手机或模拟器 → 运行到 Android App 基座
2. 选择 使用自定义基座运行
3. 选择目标设备
4. 点击运行

⚠️ 注意事项

• 如果设备上之前安装过基座，需要先卸载旧基座再安装新基座
• 截图功能仅在 Android 和 HarmonyOS 平台可用
• 使用前需要先申请截图权限
• 建议在真机上测试，模拟器可能不支持所有功能

📚 相关文档

• UTS 语法文档
• UTS API 插件开发
• UTS uni-app 兼容模式组件
• UTS 标准模式组件
• Hello UTS 示例项目

📄 许可证

请查看插件市场相关说明。

🤝 支持

如有问题或建议，请在插件市场提交反馈。