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();

創作不易，請給童長老點贊

審核編輯 黃宇