harmony-utils 之 DisplayUtil，屏幕相关工具类
harmony-utils 简介与说明
harmony-utils 一款功能丰富且极易上手的 HarmonyOS 工具库，借助众多实用工具类，致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了 APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志，异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON 等一系列的功能和操作，能够满足各种不同的开发需求。
picker_utils 是 harmony-utils 拆分出来的一个子库，包含 PickerUtil、PhotoHelper、ScanUtil。
下载安装
ohpm i @pura/harmony-utils
ohpm i @pura/picker_utils
//全局初始化方法，在UIAbility的onCreate方法中初始化 AppUtil.init() onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { AppUtil.init(this.context); }
复制代码
API 方法与使用
getDefaultDisplaySync 获取当前默认的 display 对象
let display = DisplayUtil.getDefaultDisplaySync(); let displayStr = JSON.stringify(display, null, 2);
复制代码
getPrimaryDisplaySync 获取主屏信息。除 2in1 之外的设备获取的是设备自带屏幕的 Display 对象；2in1 设备外接屏幕时获取的是当前主屏幕的 Display 对象；2in1 设备没有外接屏幕时获取的是自带屏幕的 Display 对象。<API14+>
let display = DisplayUtil.getPrimaryDisplaySync(); let displayStr = JSON.stringify(display, null, 2);
复制代码
getAllDisplays 获取当前所有的 display 对象，使用 Promise 异步回调
let allDisplay = await DisplayUtil.getAllDisplays(); let displayStr = JSON.stringify(allDisplay, null, 2);
复制代码
getWidth 获取设备的屏幕宽度，单位为 px
let width = DisplayUtil.getWidth(); ToastUtil.showToast(`当前屏幕宽度为：${width}px`);
复制代码
getHeight 获取设备的屏幕高度，单位为 px
let height = DisplayUtil.getHeight(); ToastUtil.showToast(`当前屏幕宽高度：${height}px`);
复制代码
getOrientation 获取设备当前显示的方向
let orientation = DisplayUtil.getOrientation(); ToastUtil.showToast(`设备当前显示的方向：${orientation}`);
复制代码
getDisplayState 获取设备的状态
let state = DisplayUtil.getDisplayState(); ToastUtil.showToast(`当前设备的状态：${state}`);
复制代码
getCutoutRect 获取取挖孔屏、刘海屏、瀑布屏等不可用屏幕区域信息。建议应用布局规避该区域
let rect = await DisplayUtil.getCutoutRect(); let cutoutInfoStr = JSON.stringify(rect, null, 2);
复制代码
getCutoutHeight 获取挖孔屏、刘海屏等不可用屏幕区域的高度，单位为 px
let h = await DisplayUtil.getCutoutHeight(); ToastUtil.showToast(`挖孔屏、刘海屏等不可用屏幕区域的高度：${h}`);
复制代码
isFoldable 检查设备是否可折叠
let bl = DisplayUtil.isFoldable(); ToastUtil.showToast(`设备是否可折叠：${bl}`);
复制代码
getFoldStatus 获取可折叠设备的当前折叠状态
let status = DisplayUtil.getFoldStatus(); ToastUtil.showToast(`折叠设备的当前折叠状态：${status}`);
复制代码
getFoldDisplayMode 获取可折叠设备的显示模式
let mode = DisplayUtil.getFoldDisplayMode(); ToastUtil.showToast(`可折叠设备的显示模式：${mode}`);
复制代码
onFoldStatusChange 开启折叠设备折叠状态变化的监听
ToastUtil.showToast("开启折叠设备折叠状态变化的监听");DisplayUtil.onFoldStatusChange((foldStatus: display.FoldStatus) => { let foldStatusStr = JSON.stringify(foldStatus, null, 2);});
复制代码
offFoldStatusChange 关闭折叠设备折叠状态变化的监听
ToastUtil.showToast("关闭折叠设备折叠状态变化的监听"); DisplayUtil.offFoldStatusChange();
复制代码
onFoldAngleChange 开启折叠设备折叠角度变化的监听。如果是双折轴设备，则有两个角度值；在充电口朝下的状态下，从右到左分别是折轴一和折轴二。
ToastUtil.showToast("开启折叠设备折叠角度变化的监听");DisplayUtil.onFoldAngleChange((angles: Array<number>) => { LogUtil.info(`折叠角度变化的监听：${angles}`); ToastUtil.showLong(`折叠角度变化的监听：${angles}`);});
复制代码
offFoldAngleChange 关闭折叠设备折叠角度变化的监听
ToastUtil.showToast("关闭折叠设备折叠角度变化的监听"); DisplayUtil.offFoldAngleChange();
复制代码
isCaptured 检查设备是否正在截屏、投屏、录屏
let isCaptured = DisplayUtil.isCaptured(); ToastUtil.showToast(`设备是否正在截屏、投屏、录屏：${isCaptured}`);
复制代码
onCaptureStatusChange 开启屏幕截屏、投屏、录屏状态变化的监听
ToastUtil.showToast("开启屏幕截屏、投屏、录屏状态变化的监听");DisplayUtil.onCaptureStatusChange((captureStatus: boolean) => { LogUtil.info(`屏幕截屏、投屏、录屏状态：${captureStatus}`); ToastUtil.showLong(`屏幕截屏、投屏、录屏状态：${captureStatus}`);});
复制代码
offCaptureStatusChange 关闭屏幕截屏、投屏、录屏状态变化的监听
ToastUtil.showToast("关闭屏幕截屏、投屏、录屏状态变化的监听"); DisplayUtil.offCaptureStatusChange();
复制代码
创作不易，请给童长老点赞👍
https://github.com/787107497/harmony-utils
https://gitee.com/tongyuyan/harmony-utils
OpenHarmony三方库
童长老CSDN博客
评论