提交 24e2afbb 编写于 作者: DCloud-yinjiacheng's avatar DCloud-yinjiacheng

Android uni-usercapturescreen 语法调整

上级 4aea89a3
...@@ -28,7 +28,8 @@ ...@@ -28,7 +28,8 @@
title: 'Hello', title: 'Hello',
memListener:null, memListener:null,
setUserCaptureScreenFlag: false, setUserCaptureScreenFlag: false,
setUserCaptureScreenText: '禁止截屏' setUserCaptureScreenText: '禁止截屏',
permissionGranted: false
} }
}, },
onLoad() { onLoad() {
...@@ -142,13 +143,9 @@ ...@@ -142,13 +143,9 @@
// 除android 之外的平台,不需要判断返回状态码 // 除android 之外的平台,不需要判断返回状态码
if(res.errCode == -1){ if(res.errCode == -1){
// 启动失败 // 启动失败
that.permissionGranted = true;
return ; return ;
}else if(res.errCode == 0){ }else if(res.errCode == 0){
uni.showToast({
icon:"none",
title:'截屏监听已开启'
})
}else {
uni.showToast({ uni.showToast({
icon:"none", icon:"none",
title:'捕获截屏事件' title:'捕获截屏事件'
...@@ -164,7 +161,7 @@ ...@@ -164,7 +161,7 @@
} }
}); });
if (uni.getSystemInfoSync().platform != "android") { if (uni.getSystemInfoSync().platform != "android" || that.permissionGranted) {
// 除android 之外的平台,直接提示监听已开启 // 除android 之外的平台,直接提示监听已开启
uni.showToast({ uni.showToast({
icon:"none", icon:"none",
...@@ -198,13 +195,13 @@ ...@@ -198,13 +195,13 @@
uni.setUserCaptureScreen({ uni.setUserCaptureScreen({
enable: flag, enable: flag,
success: (res) => { success: (res) => {
console.log("setUserCaptureScreen open: " + flag + " success: " + JSON.stringify(res)); console.log("setUserCaptureScreen enable: " + flag + " success: " + JSON.stringify(res));
}, },
fail: (res) => { fail: (res) => {
console.log("setUserCaptureScreen open: " + flag + " fail: " + JSON.stringify(res)); console.log("setUserCaptureScreen enable: " + flag + " fail: " + JSON.stringify(res));
}, },
complete: (res) => { complete: (res) => {
console.log("setUserCaptureScreen open: " + flag + " complete: " + JSON.stringify(res)); console.log("setUserCaptureScreen enable: " + flag + " complete: " + JSON.stringify(res));
} }
}); });
uni.showToast({ uni.showToast({
......
import { UTSAndroid } from "io.dcloud.uts";
import {
UTSAndroid
} from "io.dcloud.uts";
import ActivityCompat from "androidx.core.app.ActivityCompat"; import ActivityCompat from "androidx.core.app.ActivityCompat";
import Manifest from "android.Manifest"; import Manifest from "android.Manifest";
import PackageManager from "android.content.pm.PackageManager"; import PackageManager from "android.content.pm.PackageManager";
...@@ -14,149 +8,116 @@ import File from "java.io.File"; ...@@ -14,149 +8,116 @@ import File from "java.io.File";
import Environment from "android.os.Environment"; import Environment from "android.os.Environment";
import System from 'java.lang.System'; import System from 'java.lang.System';
import WindowManager from 'android.view.WindowManager'; import WindowManager from 'android.view.WindowManager';
import { SetUserCaptureScreenOption, UserCaptureScreenResult, OnUserCaptureScreen, OffUserCaptureScreen, SetUserCaptureScreen } from "../interface.uts"; import { UserCaptureScreenResult, OnUserCaptureScreenResult, SetUserCaptureScreenOptions, UserCaptureScreenCallback, OnUserCaptureScreen, OffUserCaptureScreen, SetUserCaptureScreen } from "../interface.uts";
/** /**
* 文件监听器 * 文件监听器
*/ */
let screenOB: ScreenFileObserver | null = null; let observer : ScreenFileObserver | null = null;
/** /**
* 记录文件监听器上次监听的时间戳,避免重复监听 * 记录文件监听器上次监听的时间戳,避免重复监听
*/ */
let lastFileObserverTime: number = 0; let lastObserverTime : number = 0;
/** /**
* 图片被捕获的实现 * 截屏回调
*/ */
let imageChange: UTSCallback | null = null; let listener : UserCaptureScreenCallback | null = null;
/** /**
* android 文件监听实现 * android 文件监听实现
*/ */
@Suppress("DEPRECATION")
class ScreenFileObserver extends FileObserver { class ScreenFileObserver extends FileObserver {
/** /**
* 所有截屏文件的存放目录 * 截屏文件目录
*/ */
allScreen: File; private screenFile : File;
constructor(screenFile: string) {
super(new File(screenFile))
this.allScreen = new File(screenFile);
constructor(screenFile : File) {
super(screenFile);
this.screenFile = screenFile;
} }
override onEvent(event : Int, path : string | null) : void {
override onEvent(event: Int, path?: string): void {
// 只监听文件新增事件 // 只监听文件新增事件
if (event == FileObserver.CREATE) { if (event == FileObserver.CREATE) {
if (path != null) {
let newPath: string = new File(this.allScreen, path!).getPath(); const currentTime = System.currentTimeMillis();
let currentTime = System.currentTimeMillis(); if ((currentTime - lastObserverTime) < 1000) {
// 本地截屏行为比上一次超过1000ms, 才认为是一个有效的时间
if ((currentTime - lastFileObserverTime) < 1000) {
// 本地截屏行为比上一次超过1000ms,才认为是一个有效的时间
return; return;
} }
lastObserverTime = currentTime;
lastFileObserverTime = System.currentTimeMillis()
let ret = { const screenShotPath = new File(this.screenFile, path).getPath();
errCode:1, const res : OnUserCaptureScreenResult = {
image:newPath errCode: 0,
errMsg: "onUserCaptureScreen:ok",
errSubject: "uni-onUserCaptureScreen",
path: screenShotPath
}
listener?.(res);
} }
imageChange!(ret);
} }
} }
} }
/** /**
* 开启截图监听 * 开启截图监听
*/ */
@Suppress("DEPRECATION") export const onUserCaptureScreen : OnUserCaptureScreen = function (callback : UserCaptureScreenCallback | null) {
export const onUserCaptureScreen : OnUserCaptureScreen = function (callback ?: UTSCallback) { // 检查相关权限是否已授予
if (ActivityCompat.checkSelfPermission(UTSAndroid.getAppContext()!, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
// 检查相关权限是否已经具备 // 无权限,申请权限,并且告知用户监听失败
if (ActivityCompat.checkSelfPermission(UTSAndroid.getUniActivity()!, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(UTSAndroid.getUniActivity()!, arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), 1001);
// 不具备权限,申请权限,并且告知用户监听失败
ActivityCompat.requestPermissions(UTSAndroid.getUniActivity()!, arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), 1001)
// 因权限缺失导致监听失败 // 因权限缺失导致监听失败
let ret = { const res : OnUserCaptureScreenResult = {
errCode:-1 errCode: -1,
errMsg: "onUserCaptureScreen:permission denied",
errSubject: "uni-onUserCaptureScreen"
} }
callback?.(ret); callback?.(res);
return ; return;
} }
imageChange = callback; // 更新监听
listener = 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);
let directory_screenshot : File;
if (Build.MANUFACTURER.toLowerCase() === "xiaomi") { if (Build.MANUFACTURER.toLowerCase() === "xiaomi") {
directory_screenshot = new File(directory_dcim, "Screenshots"); // @Suppress("DEPRECATION")
directory_screenshot = new File(new File(Environment.getExternalStorageDirectory(), Environment.DIRECTORY_DCIM), "Screenshots");
} else { } else {
directory_screenshot = new File(directory_pictures, "Screenshots"); // @Suppress("DEPRECATION")
directory_screenshot = new File(new File(Environment.getExternalStorageDirectory(), Environment.DIRECTORY_PICTURES), "Screenshots");
} }
// 先结束监听 再开启监听
if (screenOB != null) { observer?.stopWatching();
screenOB!.stopWatching() observer = new ScreenFileObserver(directory_screenshot);
} observer?.startWatching();
//开始监听
screenOB = new ScreenFileObserver(directory_screenshot.getPath())
screenOB!.startWatching()
// 监听成功
let ret = {
errCode:0
}
callback?.(ret);
} }
/** /**
* 关闭截屏监听 * 关闭截屏监听
*/ */
export const offUserCaptureScreen : OffUserCaptureScreen = function (callback ?: UTSCallback) { export const offUserCaptureScreen : OffUserCaptureScreen = function (_ : UserCaptureScreenCallback | null) {
// android10以上,关闭监听通过移除文件监听器实现
// android 10以上,关闭监听通过移除文件监听器实现 observer?.stopWatching();
if (screenOB != null) { observer = null;
screenOB!.stopWatching() lastObserverTime = 0;
screenOB = null
}
lastFileObserverTime = 0;
callback?.({});
} }
/** /**
* 设置是否禁止截屏 * 设置是否禁止截屏
*/ */
export const setUserCaptureScreen : SetUserCaptureScreen = function (option: SetUserCaptureScreenOption) { export const setUserCaptureScreen : SetUserCaptureScreen = function (option : SetUserCaptureScreenOptions) {
// 切换到UI线程 // 切换到UI线程
UTSAndroid.getUniActivity()?.runOnUiThread(new SetUserCaptureScreenRunnable(option.enable)); UTSAndroid.getUniActivity()?.runOnUiThread(new SetUserCaptureScreenRunnable(option.enable));
const res = new UserCaptureScreenResult(); const res : UserCaptureScreenResult = {
res.errCode = 0; errCode: 0,
res.errMsg = "setUserCaptureScreen:ok"; errMsg: "setUserCaptureScreen:ok",
res.errSubject = "uni-setUserCaptureScreen"; errSubject: "uni-setUserCaptureScreen"
}
option.success?.(res); option.success?.(res);
option.complete?.(res); option.complete?.(res);
} }
...@@ -167,14 +128,14 @@ class SetUserCaptureScreenRunnable extends Runnable { ...@@ -167,14 +128,14 @@ class SetUserCaptureScreenRunnable extends Runnable {
* ture: 允许用户截屏 * ture: 允许用户截屏
* false: 不允许用户截屏,防止用户截屏到应用页面内容 * false: 不允许用户截屏,防止用户截屏到应用页面内容
*/ */
private enable: boolean; private enable : boolean;
constructor(enable: boolean) { constructor(enable : boolean) {
super(); super();
this.enable = enable; this.enable = enable;
} }
override run(): void { override run() : void {
if (this.enable) { if (this.enable) {
UTSAndroid.getUniActivity()?.getWindow()?.clearFlags(WindowManager.LayoutParams.FLAG_SECURE); UTSAndroid.getUniActivity()?.getWindow()?.clearFlags(WindowManager.LayoutParams.FLAG_SECURE);
} else { } else {
...@@ -182,6 +143,3 @@ class SetUserCaptureScreenRunnable extends Runnable { ...@@ -182,6 +143,3 @@ class SetUserCaptureScreenRunnable extends Runnable {
} }
} }
} }
...@@ -16,7 +16,28 @@ export type UserCaptureScreenResult = { ...@@ -16,7 +16,28 @@ export type UserCaptureScreenResult = {
errMsg : string, errMsg : string,
} }
export type SetUserCaptureScreenOption = { export type OnUserCaptureScreenResult = {
/**
* 错误码
* 0:成功
* -1:permission denied(仅Android返回)
*/
errCode : number,
/**
* 调用API的名称
*/
errSubject : string,
/**
* 错误的详细信息
*/
errMsg : string,
/**
* 截屏文件路径(仅Android返回)
*/
path : string | null
}
export type SetUserCaptureScreenOptions = {
/** /**
* true: 允许用户截屏 false: 不允许用户截屏,防止用户截屏到应用页面内容 * true: 允许用户截屏 false: 不允许用户截屏,防止用户截屏到应用页面内容
*/ */
...@@ -35,25 +56,27 @@ export type SetUserCaptureScreenOption = { ...@@ -35,25 +56,27 @@ export type SetUserCaptureScreenOption = {
complete ?: (res : UserCaptureScreenResult) => void complete ?: (res : UserCaptureScreenResult) => void
} }
export type UserCaptureScreenCallback = (res : OnUserCaptureScreenResult) => void
/** /**
* 开启截屏监听 * 开启截屏监听
* *
* @param {UTSCallback} callback * @param {UserCaptureScreenCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/capture-screen.html#onusercapturescreen * @tutorial https://uniapp.dcloud.net.cn/api/system/capture-screen.html#onusercapturescreen
* @platforms APP-IOS = ^9.0,APP-ANDROID = ^22 * @platforms APP-IOS = ^9.0,APP-ANDROID = ^22
* @since 3.6.8 * @since 3.6.8
*/ */
export type OnUserCaptureScreen = (callback ?: UTSCallback) => void export type OnUserCaptureScreen = (callback : UserCaptureScreenCallback | null) => void
/** /**
* 关闭截屏监听 * 关闭截屏监听
* *
* @param {UTSCallback} callback * @param {UserCaptureScreenCallback} callback
* @tutorial https://uniapp.dcloud.net.cn/api/system/capture-screen.html#offusercapturescreen * @tutorial https://uniapp.dcloud.net.cn/api/system/capture-screen.html#offusercapturescreen
* @platforms APP-IOS = ^9.0,APP-ANDROID = ^22 * @platforms APP-IOS = ^9.0,APP-ANDROID = ^22
* @since 3.6.8 * @since 3.6.8
*/ */
export type OffUserCaptureScreen = (callback ?: UTSCallback) => void export type OffUserCaptureScreen = (callback : UserCaptureScreenCallback | null) => void
/** /**
* 设置防截屏 * 设置防截屏
...@@ -63,11 +86,10 @@ export type OffUserCaptureScreen = (callback ?: UTSCallback) => void ...@@ -63,11 +86,10 @@ export type OffUserCaptureScreen = (callback ?: UTSCallback) => void
* @platforms APP-IOS = ^9.0,APP-ANDROID = ^22 * @platforms APP-IOS = ^9.0,APP-ANDROID = ^22
* @since 3.7.3 * @since 3.7.3
*/ */
export type SetUserCaptureScreen = (options : SetUserCaptureScreenOption) => void export type SetUserCaptureScreen = (options : SetUserCaptureScreenOptions) => void
interface uni { interface uni {
onUserCaptureScreen : OnUserCaptureScreen, onUserCaptureScreen : OnUserCaptureScreen,
offUserCaptureScreen : OffUserCaptureScreen, offUserCaptureScreen : OffUserCaptureScreen,
setUserCaptureScreen : SetUserCaptureScreen setUserCaptureScreen : SetUserCaptureScreen
} }
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册