截屏监听插件迁移到 ext api模式

.hbuilderx/launch.json

+{ // launch.json 配置了启动调试时相关设置，configurations下节点名称可为 app-plus/h5/mp-weixin/mp-baidu/mp-alipay/mp-qq/mp-toutiao/mp-360/
+  // launchtype项可配置值为local或remote, local代表前端连本地云函数，remote代表前端连云端云函数
+    "version": "0.0",
+    "configurations": [{
+     	"app-plus" : 
+     	{
+     		"launchtype" : "local"
+     	},
+     	"default" : 
+     	{
+     		"launchtype" : "local"
+     	},
+     	"type" : "uniCloud"
+     }
+    ]
+}

manifest.json

@@ -68,5 +68,5 @@
     "uniStatistics" : {
         "enable" : false
     },
-    "vueVersion" : "2"
+    "vueVersion" : "3"
 }

pages/index/index.vue

@@ -4,10 +4,17 @@
 		<view class="text-area">
 			<text class="title">{{title}}</text>
 		</view>
+		<button @tap="testScreenShotListen">开启截屏监听</button>
+		<button  @tap="testScreenShotOff">关闭截屏监听</button>
+		<button  @tap="testGetBatteryInfo">获取电池电量</button>
+
 	</view>
 </template>
 
 <script>
+
+	import getBatteryInfo from "@/uni_modules/uni-getbatteryinfo";
+	
 	export default {
 		data() {
 			return {
@@ -18,7 +25,69 @@
 
 		},
 		methods: {
-
+			
+			testScreenShotListen() {
+				var that = this;
+				uni.onUserCaptureScreen(function(res) {
+						console.log(res);
+						
+						if (uni.getSystemInfoSync().platform == "android") {
+							// 除android 之外的平台，不需要判断返回状态码
+							if(res.code == -1){
+								// 启动失败
+								return ;
+							}else if(res.code == 0){
+								uni.showToast({
+									icon:"none",
+									title:'截屏监听已开启'
+								})
+							}else {
+								uni.showToast({
+									icon:"none",
+									title:'捕获截屏事件'
+								})
+								that.screenImage = res.image
+							}
+						}else{
+							// 除android 之外的平台，不需要判断返回状态码
+							uni.showToast({
+								icon:"none",
+								title:'捕获截屏事件'
+							})
+						}
+						
+					});
+					
+					if (uni.getSystemInfoSync().platform != "android") {
+						// 除android 之外的平台，直接提示监听已开启
+						uni.showToast({
+							icon:"none",
+							title:'截屏监听已开启'
+						})
+					}
+			},
+			testScreenShotOff() {
+				var that = this;
+				uni.offUserCaptureScreen(function(res) {
+						console.log(res);
+				});
+				// 提示已经开始监听,注意观察
+				uni.showToast({
+					icon:"none",
+					title:'截屏监听已关闭'
+				})
+			},
+			testGetBatteryInfo() {
+				var that = this;
+				uni.getBatteryInfo({
+					success(res) {
+						uni.showToast({
+							title: "当前电量：" + res.level + '%',
+							icon: 'none'
+						});
+					}
+				})
+			},
 		}
 	}
 </script>

uni_modules/uni-screen/package.json

+{
+	"id": "uni-screen",
+	"displayName": "uni-screen",
+	"version": "1.0.0",
+	"description": "uni-screen",
+	"keywords": [
+		"屏幕"
+	],
+	"repository": "",
+	"engines": {
+		"HBuilderX": "^3.6.0"
+	},
+	"dcloudext": {
+		"type": "uts",
+		"sale": {
+			"regular": {
+				"price": "0.00"
+			},
+			"sourcecode": {
+				"price": "0.00"
+			}
+		},
+		"contact": {
+			"qq": ""
+		},
+		"declaration": {
+			"ads": "",
+			"data": "",
+			"permissions": ""
+		},
+		"npmurl": ""
+	},
+	"uni_modules": {
+		"uni-ext-api":{
+			"uni": {
+				"onUserCaptureScreen": "onUserCaptureScreen",
+				"offUserCaptureScreen": "offUserCaptureScreen"
+			}
+		},
+		"dependencies": [],
+		"encrypt": [],
+		"platforms": {
+			"cloud": {
+				"tcb": "u",
+				"aliyun": "u"
+			},
+			"client": {
+				"Vue": {
+					"vue2": "n",
+					"vue3": "y"
+				},
+				"App": {
+					"app-android": "u",
+					"app-ios": "u"
+				},
+				"H5-mobile": {
+					"Safari": "u",
+					"Android Browser": "u",
+					"微信浏览器(Android)": "u",
+					"QQ浏览器(Android)": "u"
+				},
+				"H5-pc": {
+					"Chrome": "u",
+					"IE": "u",
+					"Edge": "u",
+					"Firefox": "u",
+					"Safari": "u"
+				},
+				"小程序": {
+					"微信": "u",
+					"阿里": "u",
+					"百度": "u",
+					"字节跳动": "u",
+					"QQ": "u",
+					"钉钉": "u",
+					"快手": "u",
+					"飞书": "u",
+					"京东": "u"
+				},
+				"快应用": {
+					"华为": "u",
+					"联盟": "u"
+				}
+			}
+		}
+	}
+}

uni_modules/uni-screen/readme.md

+# uts-screenshot-listener
+### 开发文档
+[UTS 语法](https://uniapp.dcloud.net.cn/tutorial/syntax-uts.html)
+[UTS 原生插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)
+[Hello UTS](https://gitcode.net/dcloud/hello-uts/-/tree/dev)
\ No newline at end of file

uni_modules/uni-screen/utssdk/app-android/index.uts

+
+
+import {
+	getUniActivity
+} from "io.dcloud.uts.android";
+
+
+import ActivityCompat from "androidx.core.app.ActivityCompat";
+import Manifest from "android.Manifest";
+import PackageManager from "android.content.pm.PackageManager";
+import Build from "android.os.Build";
+import FileObserver from "android.os.FileObserver";
+import File from "java.io.File";
+import Environment from "android.os.Environment";
+import System from 'java.lang.System';
+
+
+
+/**
+ * 文件监听器
+ */
+let screenOB: ScreenFileObserver | null = null;
+/**
+ * 记录文件监听器上次监听的时间戳，避免重复监听
+ */
+let lastFileObserverTime: number = 0;
+/**
+ * 图片被捕获的实现
+ */
+let imageChange: UTSCallback | null = null;
+
+
+
+
+/**
+ * android 文件监听实现
+ */
+
+class ScreenFileObserver extends FileObserver {
+
+	/**
+	 * 所有截屏文件的存放目录
+	 */
+	allScreen: File;
+
+	
+	constructor(screenFile: string) {
+		super(screenFile)
+		this.allScreen = new File(screenFile);
+	}
+
+
+	override onEvent(event: Int, path?: string): void {
+		
+		// 只监听文件新增事件
+		if (event == FileObserver.CREATE) {
+			
+			let newPath: string = new File(this.allScreen, path!).getPath();
+			let currentTime = System.currentTimeMillis();
+
+			if ((currentTime - lastFileObserverTime) < 1000) {
+				// 本地截屏行为比上一次超过1000ms,才认为是一个有效的时间
+				return;
+			}
+			
+			lastFileObserverTime = System.currentTimeMillis()
+			let ret = {
+				code:1,
+				image:newPath
+			}
+			
+			imageChange!(ret);
+		}
+	}
+}
+
+
+
+
+
+
+
+
+/**
+ * 开启截图监听
+ */
+export function onUserCaptureScreen(callback: (res:UTSJSONObject) => void) {
+	
+	// 检查相关权限是否已经具备
+	if (ActivityCompat.checkSelfPermission(getUniActivity()!, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
+		// 不具备权限，申请权限，并且告知用户监听失败
+		ActivityCompat.requestPermissions(getUniActivity()!, arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), 1001)
+		
+		// 因权限缺失导致监听失败
+		let ret = {
+			code:-1
+		}
+		callback(ret);
+		return ;
+	}
+	
+	imageChange = callback;
+
+	let directory_screenshot: File;
+	// 找到设备存放截屏文件的目录
+	let directory_pictures = new File(Environment.getExternalStorageDirectory(), Environment.DIRECTORY_PICTURES);
+	let directory_dcim = new File(Environment.getExternalStorageDirectory(), Environment.DIRECTORY_DCIM);
+	
+	if (Build.MANUFACTURER.lowercase() === "xiaomi") {
+		directory_screenshot = new File(directory_dcim, "Screenshots");
+	} else {
+		directory_screenshot = new File(directory_pictures, "Screenshots");
+	}
+	
+	if (screenOB != null) {
+		screenOB!.stopWatching()
+	}
+	//开始监听
+	screenOB = new ScreenFileObserver(directory_screenshot.path)
+	screenOB!.startWatching()
+
+	// 监听成功
+	let ret = {
+		code:0
+	}
+	callback(ret);
+	
+}
+
+
+/**
+ * 关闭截屏监听
+ */
+export function offUserCaptureScreen(success: (res: any) => void) {
+
+	// android 10以上，关闭监听通过移除文件监听器实现
+	if (screenOB != null) {
+		screenOB!.stopWatching()
+		screenOB = null
+	}
+	lastFileObserverTime = 0;
+	
+	let ret = {
+		
+	}
+	success(ret);
+}
+
+
+

uni_modules/uni-screen/utssdk/app-ios/index.uts

+import { NotificationCenter} from 'Foundation';
+import { UIApplication } from "UIKit"
+
+/**
+ * 定义监听截屏事件工具类
+ */
+class CaptureScreenTool {
+	static listener?: UTSCallback;
+	
+	// 监听截屏
+	static listenCaptureScreen(callback?: UTSCallback) {
+		this.listener = callback
+		
+		// 注册监听截屏事件及回调方法
+		// target-action 回调方法需要通过 Selector("方法名") 构建
+		const method = Selector("userDidTakeScreenshot")
+		NotificationCenter.default.addObserver(this, selector = method, name = UIApplication.userDidTakeScreenshotNotification, object = null)
+	}
+	
+	// 捕获截屏回调的方法
+	// target-action 的方法前需要添加 @objc 前缀
+	@objc static userDidTakeScreenshot() {
+		const obj = new UTSJSONObject()
+		// 回调
+		this.listener?.(obj)
+	}
+	
+	// 移除监听事件
+	static removeListen(callback?: UTSCallback) {
+		this.listener = null
+		NotificationCenter.default.removeObserver(this)
+		const obj = new UTSJSONObject()
+		callback?.(obj)
+	}
+}
+
+/**
+ * 开启截图监听
+ */
+export function onUserCaptureScreen(callback?: UTSCallback) {
+	CaptureScreenTool.listenCaptureScreen(callback)
+}
+
+/**
+ * 关闭截屏监听
+ */
+export function offUserCaptureScreen(callback?: UTSCallback) {
+	CaptureScreenTool.removeListen(callback)
+}