harmony-utils之DisplayUtil,屏幕相关工具类

简介: DisplayUtil 是 harmony-utils 中的屏幕相关工具类,提供多种屏幕信息获取与监听功能。支持获取屏幕宽高、方向、状态、折叠信息及截屏投屏状态等,适用于鸿蒙应用开发,提升开发效率。

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对象。
 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三方库

目录
相关文章
HarmonyOS实战:Tab顶部滑动悬停功能实现
在鸿蒙开发中,实现Scroll嵌套List列表滑动时顶部悬停的效果是一个常见需求。本文详细介绍了如何通过布局和事件处理来实现这一功能。首先,使用Scroll嵌套List和Tab布局来构建基础页面。然后,通过设置nestedScroll属性为NestedScrollMode.PARENT_FIRST,确保外层Scroll优先滑动。接着,通过监听List和Scroll的滑动事件,处理滑动冲突,确保在特定条件下Scroll停止滑动,将滑动事件交给List处理。最终,实现了在上下滑动时优先让Scroll滑动的效果,并提供了扩展思路,如优先让List滑动等。
677 10
HarmonyOS实战:Tab顶部滑动悬停功能实现
|
IDE 开发工具 开发者
使用DevEcoStudio 开发、编译鸿蒙 NEXT_APP 以及使用中文插件
# 使用DevEcoStudio 开发、编译鸿蒙 NEXT_APP 以及使用中文插件 #鸿蒙开发工具 #DevEco Studio
1563 1
|
9月前
|
人工智能 安全 JavaScript
从OpenClaw到NullClaw,极致轻量Claw新成员来了
从OpenClaw到NullClaw,极致轻量Claw新成员来了 从OpenClaw到NullClaw,极致轻量Claw新成员来了 从OpenClaw到NullClaw,极致轻量Claw新成员来了
2655 5
|
开发工具 开发者
HarmonyOS NEXT实战:openCustomDialog自定义弹窗
本文介绍了在HarmonyOS SDK中使用UIContext获取PromptAction对象,通过openCustomDialog接口实现自定义弹出框的方法。重点讲解了ComponentContent方式创建弹窗,支持动态更新与灵活样式定制,并附实现步骤与完整示例代码。
635 0
|
人工智能 自然语言处理 语音技术
GPT-4o mini TTS:OpenAI 推出轻量级文本转语音模型!情感操控+白菜价冲击配音圈
GPT-4o mini TTS 是 OpenAI 推出的轻量级文本转语音模型,支持多语言、多情感控制,适用于智能客服、教育学习、智能助手等多种场景。
1395 2
GPT-4o mini TTS:OpenAI 推出轻量级文本转语音模型!情感操控+白菜价冲击配音圈
|
人工智能 Java 程序员
一文彻底拿下HarmonyOS中的@State和@Prop和@Link的区别和联系
本文介绍HarmonyOS中的装饰器、@State、@Prop和@Link。装饰器增强代码功能;@State管理组件状态,触发重新渲染;@Prop单向传递数据;@Link实现双向数据绑定。希望对你有帮助!
786 0
一文彻底拿下HarmonyOS中的@State和@Prop和@Link的区别和联系
|
数据处理
鸿蒙开发:ArkTs字符串string
字符串类型是开发中非常重要的一个数据类型,除了上述的方法概述之外,还有String对象,正则等其他的用处,我们放到以后得篇章中讲述。
1244 19
|
Dart 索引
鸿蒙应用开发从入门到入行 - 篇8:Tabs选项卡页签视图切换
在本篇文章里,您将掌握使用Tabs选项卡做栏目分类,这是未来应用开发中极为常用的组件
825 7
鸿蒙应用开发从入门到入行 - 篇8:Tabs选项卡页签视图切换
|
存储 数据安全/隐私保护 开发者
「Mac畅玩鸿蒙与硬件13」鸿蒙UI组件篇3 - TextInput组件获取用户输入
在鸿蒙应用开发中,TextInput 组件用于接收用户输入,适用于文本、密码等多种输入类型。本文详细介绍鸿蒙 TextInput 组件的使用方法,包括输入限制、样式设置、事件监听及搜索框应用,帮助你灵活处理鸿蒙应用中的用户输入。
1211 7
「Mac畅玩鸿蒙与硬件13」鸿蒙UI组件篇3 - TextInput组件获取用户输入
|
Android开发
Android 中选项菜单(Option menu)的用法
Android 中选项菜单(Option menu)的用法
650 0

热门文章

最新文章