harmony-utils之DeviceUtil,设备相关工具类

简介: DeviceUtil 是 HarmonyOS 工具库 harmony-utils 中的设备相关工具类,提供设备信息获取与操作功能,如设备 ID、型号、系统版本、电池状态、振动控制等,助力开发者高效构建鸿蒙应用。

harmony-utils之DeviceUtil,设备相关工具类

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方法与使用


getDeviceId 获取设备ID(卸载APP后依旧不变,需要权限:ohos.permission.STORE_PERSISTENT_DATA)
  let id = DeviceUtil.getDeviceId();
  DialogHelper.showToast(`当前设备号为:${id}`);
deleteDeviceId 移除设备ID
  DeviceUtil.deleteDeviceId();
  ToastUtil.showToast("移除设备ID成功!")
getODID 获取开发者匿名设备标识符,ODID
 let ODID = DeviceUtil.getODID();
 DialogHelper.showToast(`开发者匿名设备标识符为:${ODID}`);
getOAID 获取开放匿名设备标识符,OAID
PermissionUtil.requestPermissionsEasy("ohos.permission.APP_TRACKING_CONSENT").then(async (grant) => {
  if (grant) {
    DeviceUtil.getOAID().then((id) => {
      ToastUtil.showToast("开放匿名设备标识符位:" + id);
    }).catch((err: BusinessError) => {
      ToastUtil.showToast(`开放匿名设备标识符获取失败,${err.message}!`);
    });
  } else {
    ToastUtil.showToast("您拒绝了权限!")
  }
});
getAAID 获取应用匿名标识符,AAID
  let AAID = await DeviceUtil.getAAID();
  DialogHelper.showToast(`AAID为:${AAID}`);
deleteAAID 删除应用匿名标识符,AAID
 DeviceUtil.deleteAAID();
getSerial 获取设备序列号。说明:可作为设备唯一识别码。示例:序列号随设备差异。需要权限:ohos.permission.sec.ACCESS_UDID (目前只限系统应用使用,不对三方应用开放)
 let str = DeviceUtil.getSerial();
getUdid 获取设备Udid。需要权限:ohos.permission.sec.ACCESS_UDID (目前只限系统应用使用,不对三方应用开放)
 let str = DeviceUtil.getUdid();
getBrand 获取设备品牌名称。示例:HUAWEI
 let str = DeviceUtil.getBrand();
getProductModel 获取认证型号。示例:ALN-AL00
 let str = DeviceUtil.getProductModel();
getBrandModel 获取设备品牌名称 认证型号。示例:HUAWEI ALN-AL00
 let str = DeviceUtil.getBrandModel();
getMarketName 获取外部产品系列名称。示例:HUAWEI Mate 60 Pro
 let str = DeviceUtil.getMarketName();
getHardwareModel 获取硬件版本号。示例:HL1CMSM
 let str = DeviceUtil.getHardwareModel();
getManufacture 获取设备厂家名称。示例:HUAWEI
 let str = DeviceUtil.getManufacture();
getOsFullName 获取系统版本
 let str = DeviceUtil.getOsFullName();
getDisplayVersion 获取产品版本。示例:ALN-AL00 5.0.0.1(XXX)
 let str = DeviceUtil.getDisplayVersion();
getBuildVersion 获取Build版本号,标识编译构建的版本号
 let str = DeviceUtil.getBuildVersion();
getSdkApiVersion 获取系统软件API版本。示例:12
 let str = DeviceUtil.getSdkApiVersion();
getOsVersion 获取OS版本号(Major版本号,示例:5;Senior版本号,示例:0;Feature版本号,示例:0)
 let str = DeviceUtil.getOsVersion();
getAbiList 应用二进制接口(Abi)。示例:arm64-v8a
 let str = DeviceUtil.getAbiList();
getOsReleaseType 获取系统的发布类型,取值为:Canary、Beta、Release
 let str = DeviceUtil.getOsReleaseType();
getDeviceType 获取当前设备类型
 let str = DeviceUtil.getDeviceType();
getDeviceTypeStr 获取当前设备类型,返回字符串
 let str = DeviceUtil.getDeviceTypeStr();
getConfiguration 获取设备的Configuration
  let configuration = DeviceUtil.getConfigurationSync();
  let jsonStr = JSON.stringify(configuration, null, 2);
getDirection 获取当前设备屏幕方向
  let direction = DeviceUtil.getDirection();
getDeviceCapability 获取设备的DeviceCapability
  let deviceCapability = DeviceUtil.getDeviceCapabilitySync();
  let jsonStr = JSON.stringify(deviceCapability, null, 2);
getScreenDensity 获取当前设备屏幕密度
  let density = DeviceUtil.getScreenDensity();
  ToastUtil.showToast(`前设备屏幕密度: ${density}`)
getBatterySOC 获取当前设备剩余电池电量百分比
  let result = DeviceUtil.getBatterySOC();
getBatteryCapacityLevel 获取当前设备电池电量的等级
  let result = DeviceUtil.getBatteryCapacityLevel();
getHealthStatus 获取当前设备电池的健康状态
  let result = DeviceUtil.getHealthStatus();
getBatteryTemperature 获取当前设备电池的温度,单位0.1摄氏度
  let result = DeviceUtil.getBatteryTemperature();
getVoltage 获取当前设备电池的电压,单位微伏
  let result = DeviceUtil.getVoltage();
getNowCurrent 获取当前设备电池的电流,单位毫安
  let result = DeviceUtil.getNowCurrent();
isActive 检测当前设备是否处于活动状态。有屏的设备为亮屏状态,无屏的设备为非休眠状态
  let result = DeviceUtil.isActive();
isStandby 检测当前设备是否进入待机低功耗续航模式
  let result = DeviceUtil.isStandby();
getPowerMode 获取当前设备的电源模式
  let result = DeviceUtil.getPowerMode();
startVibration 开启设备振动
  DeviceUtil.getNowCurrent();
stopVibration 停止设备振动(按照VIBRATOR_STOP_MODE_TIME模式)
  DeviceUtil.stopVibration();

创作不易,请给童长老点赞👍


https://github.com/787107497/harmony-utils
https://gitee.com/tongyuyan/harmony-utils
OpenHarmony三方库

目录
相关文章
|
存储 算法 安全
harmony-utils之SHA,SHA工具类
harmony-utils 是一款功能丰富的 HarmonyOS 工具库,提供多种实用工具类,助力开发者快速构建鸿蒙应用。其中的 SHA 工具类支持 SHA-1、SHA-2、SHA-3 等算法,可用于数据摘要、完整性校验、数字签名和密码存储等场景。支持同步与异步操作,并提供分段处理及 HMAC 消息认证码计算功能,提升安全性和灵活性。
395 1
|
前端开发 UED
HarmonyOS应用一键置灰指南
一键置灰常用于重大悼念、特殊纪念日、模拟视觉效果及系统维护等场景,可通过组件属性、窗口设置或工具库实现界面整体或局部灰度效果,操作简便且提升用户体验与情感共鸣。
465 0
|
API Apache 开发者
最受欢迎的三方库之harmony-dialog
harmony-dialog 是一款简单易用的鸿蒙弹窗工具库,支持多种弹窗类型,如提示框、选择器、加载框、吐司等,满足多样化开发需求。一行代码即可调用,使用便捷,兼容 API12+。配合 harmony-utils 使用更佳,助力快速开发。
411 0
|
JSON 算法 安全
harmony-utils之RSA,RSA加解密
harmony-utils是一款专为HarmonyOS打造的高效工具库,提供丰富的实用功能,助力开发者快速构建鸿蒙应用。其RSA模块实现非对称加解密、签名验签等功能,支持密钥生成、数据加密解密及分段处理,适用于安全通信与身份验证等场景。
512 0
|
存储 算法 安全
harmony-utils之MD5,MD5工具类
harmony-utils 是一款功能丰富的 HarmonyOS 工具库,提供包括 MD5 加密在内的多种实用工具类,帮助开发者高效构建鸿蒙应用。
261 0
|
缓存 JSON 前端开发
最受欢迎的三方库之harmony-utils
harmony-utils 是一款功能丰富且易于使用的 HarmonyOS 工具库,涵盖 APP、设备、屏幕、授权、通知、文件操作、加解密等多种常用功能,帮助开发者高效构建鸿蒙应用。体积小巧(仅约 130KB),性能优越,适用于 OpenHarmony API 12 及以上版本。
528 0
|
JSON 算法 安全
harmony-utils之SM4,SM4加解密
harmony-utils是一款专为HarmonyOS开发的高效工具库,提供丰富的实用功能,如SM4加解密、设备操作、文件处理等,助力开发者快速构建鸿蒙应用。
561 0
|
JSON 编解码 API
harmony-utils之Base64Util,Base64工具类
`harmony-utils` 是一款功能丰富的 HarmonyOS 工具库,提供 Base64 编解码、字符串转换等实用功能,助力开发者高效构建鸿蒙应用。
353 0
|
存储 安全 算法
harmony-utils之AES,AES加解密
harmony-utils是一款专为HarmonyOS开发的高效工具库,提供包括AES加解密在内的多种实用功能,帮助开发者快速构建应用。
479 0
|
JSON 算法 安全
harmony-utils之SM3,SM3工具类
harmony-utils是一款HarmonyOS工具库,提供丰富的SM3加密工具类,支持摘要、分段处理及消息认证码计算,助力开发者高效构建安全应用。
578 0