鸿蒙NEXT开发设备相关工具类（ArkTs）

鸿蒙布道师2025-04-11 13:26
复制代码 
import { vibrator, VibratorStopMode } from '@kit.SensorServiceKit';
import { LogUtil } from './LogUtil';
import { resourceManager, DeviceType, Direction, ScreenDensity } from '@kit.LocalizationKit';
import { StrUtil } from './StrUtil';
import { AssetUtil } from './AssetUtil';
import { PreferencesUtil } from './PreferencesUtil';
import { RandomUtil } from './RandomUtil';
import deviceInfo from '@ohos.deviceInfo';
import { ResUtil } from './ResUtil';
import { identifier } from '@kit.AdsKit';
export const DEVICE_ID_KEY: string = "device_id_cache_harmony_key"; //设备ID的Key
/**
 * 定义移除操作的存储方法接口
 */
interface StorageMethodForRemove {
  removeSync: (key: string) => void;
}

/**
 * 定义获取和添加操作的存储方法接口
 */
interface StorageMethodForGetAdd {
  getSync: (key: string) => string | null;
  addSync: (key: string, value: string) => void;
}

/**
 * 设备相关工具类。
 * 提供设备信息、配置、能力、振动等功能的访问。
 *
 * @author 鸿蒙布道师
 * @since 2025/04/09
 */
export class DeviceUtil {
  private static deviceId: string = ''; // 设备ID
  /**
   * 获取设备ID（卸载APP后依旧不变）。
   * 如果未生成过设备ID，则会自动生成并存储。
   *
   * @param rule 是否包含 `-`，默认为 true。
   * @param generateId 自定义生成的ID（可选）。
   * @returns 返回设备ID。
   */
  static getDeviceId(rule: boolean = true, generateId?: string): string {
    if (StrUtil.isEmpty(DeviceUtil.deviceId)) {
      // 使用定义的接口类型
      const storageMethod: StorageMethodForGetAdd = AssetUtil.canIUse()
        ? AssetUtil
        : PreferencesUtil;

      const storedId: string | null = storageMethod.getSync(DEVICE_ID_KEY);
      let deviceId: string = StrUtil.toStr(storedId);

      if (StrUtil.isEmpty(deviceId)) {
        deviceId = generateId && StrUtil.isNotEmpty(generateId)
          ? generateId
          : RandomUtil.generateRandomUUID(true);

        if (!rule) {
          deviceId = deviceId.replace(/-/g, '');
        }

        storageMethod.addSync(DEVICE_ID_KEY, deviceId);
        !AssetUtil.canIUse() && LogUtil.error('当前设备不支持关键资产存储服务');
      }
      DeviceUtil.deviceId = deviceId;
    }
    return DeviceUtil.deviceId;
  }

  /**
   * 移除设备ID。
   */
  static deleteDeviceId(): void {
    DeviceUtil.deviceId = '';

    // 使用定义的接口类型
    const storageMethod: StorageMethodForRemove = AssetUtil.canIUse()
      ? AssetUtil
      : PreferencesUtil;

    storageMethod.removeSync(DEVICE_ID_KEY);
  }

  /**
   * 获取设备品牌名称。示例：HUAWEI。
   */
  static getBrand(): string {
    return deviceInfo.brand;
  }

  /**
   * 获取认证型号。示例：ALN-AL00。
   */
  static getProductModel(): string {
    return deviceInfo.productModel;
  }

  /**
   * 获取品牌和型号组合。示例：HUAWEI ALN-AL00。
   */
  static getBrandModel(): string {
    return `${deviceInfo.brand} ${deviceInfo.productModel}`;
  }

  /**
   * 获取市场名称。示例：HUAWEI Mate 60 Pro。
   */
  static getMarketName(): string {
    return deviceInfo.marketName;
  }

  /**
   * 获取硬件版本号。示例：HL1CMSM。
   */
  static getHardwareModel(): string {
    return deviceInfo.hardwareModel;
  }

  /**
   * 获取设备厂家名称。示例：HUAWEI。
   */
  static getManufacture(): string {
    return deviceInfo.manufacture;
  }

  /**
   * 获取系统版本。示例：HarmonyOS 5.0.0。
   */
  static getOsFullName(): string {
    return deviceInfo.osFullName;
  }

  /**
   * 获取产品版本。示例：ALN-AL00 5.0.0.1(XXX)。
   */
  static getDisplayVersion(): string {
    return deviceInfo.displayVersion;
  }

  /**
   * 获取系统软件API版本。示例：12。
   */
  static getSdkApiVersion(): number {
    return deviceInfo.sdkApiVersion;
  }

  /**
   * 获取编译构建的版本号。
   */
  static getBuildVersion(): number {
    return deviceInfo.buildVersion;
  }

  /**
   * 获取OS版本号。示例：5.0.0。
   */
  static getOsVersion(): string {
    return `${deviceInfo.majorVersion}.${deviceInfo.seniorVersion}.${deviceInfo.featureVersion}`;
  }

  /**
   * 获取开发者匿名设备标识符。
   */
  static getODID(): string {
    return deviceInfo.ODID;
  }

  /**
   * 获取设备序列号。需要权限：ohos.permission.sec.ACCESS_UDID。
   */
  static getSerial(): string {
    return deviceInfo.serial;
  }

  /**
   * 获取设备UDID。需要权限：ohos.permission.sec.ACCESS_UDID。
   */
  static getUdid(): string {
    return deviceInfo.udid;
  }

  /**
   * 获取开放匿名设备标识符。需要权限：ohos.permission.APP_TRACKING_CONSENT。
   */
  static async getOAID(): Promise<string> {
    return identifier.getOAID();
  }

  /**
   * 获取应用二进制接口（Abi）。示例：arm64-v8a。
   */
  static getAbiList(): string {
    return deviceInfo.abiList;
  }

  /**
   * 获取系统的发布类型。取值为：Canary、Beta、Release。
   */
  static getOsReleaseType(): string {
    return deviceInfo.osReleaseType;
  }

  /**
   * 获取当前设备类型编号。
   */
  static getDeviceType(): number {
    return DeviceUtil.getDeviceCapabilitySync().deviceType;
  }

  /**
   * 获取当前设备类型的字符串描述。
   */
  static getDeviceTypeStr(): string {
    switch (DeviceUtil.getDeviceType()) {
      case DeviceType.DEVICE_TYPE_PHONE:
        return '手机';
      case DeviceType.DEVICE_TYPE_TABLET:
        return '平板';
      case DeviceType.DEVICE_TYPE_PC:
        return '电脑';
      case DeviceType.DEVICE_TYPE_TV:
        return '电视';
      case DeviceType.DEVICE_TYPE_CAR:
        return '汽车';
      case DeviceType.DEVICE_TYPE_WEARABLE:
        return '穿戴';
      case DeviceType.DEVICE_TYPE_2IN1:
        return '2IN1';
      default:
        return '';
    }
  }

  /**
   * 获取设备的Configuration（异步）。
   */
  static async getConfiguration(): Promise<resourceManager.Configuration> {
    return ResUtil.getConfiguration(true);
  }

  /**
   * 获取设备的Configuration（同步）。
   */
  static getConfigurationSync(): resourceManager.Configuration {
    return ResUtil.getConfigurationSync();
  }

  /**
   * 获取当前设备屏幕方向。
   */
  static getDirection(): Direction {
    return DeviceUtil.getConfigurationSync().direction;
  }

  /**
   * 获取设备的DeviceCapability（异步）。
   */
  static async getDeviceCapability(): Promise<resourceManager.DeviceCapability> {
    return ResUtil.getDeviceCapability(true);
  }

  /**
   * 获取设备的DeviceCapability（同步）。
   */
  static getDeviceCapabilitySync(): resourceManager.DeviceCapability {
    return ResUtil.getDeviceCapabilitySync();
  }

  /**
   * 获取当前设备屏幕密度。
   */
  static getScreenDensity(): ScreenDensity {
    return DeviceUtil.getDeviceCapabilitySync().screenDensity;
  }

  /**
   * 开启振动。
   * 需要权限：ohos.permission.VIBRATE。
   *
   * @param duration 振动时长（毫秒），默认为 1000ms。
   * @param usage 振动用途，默认为 'media'。
   */
  static startVibration(duration: number = 1000, usage: vibrator.Usage = 'media'): Promise<void> {
    return vibrator.startVibration({ type: 'time', duration }, { id: 0, usage });
  }

  /**
   * 停止振动。
   * 需要权限：ohos.permission.VIBRATE。
   */
  static stopVibration(): Promise<void> {
    return vibrator.stopVibration(VibratorStopMode.VIBRATOR_STOP_MODE_TIME);
  }
}

代码如下：

TypeScript 复制代码 
import { vibrator, VibratorStopMode } from '@kit.SensorServiceKit';
import { LogUtil } from './LogUtil';
import { resourceManager, DeviceType, Direction, ScreenDensity } from '@kit.LocalizationKit';
import { StrUtil } from './StrUtil';
import { AssetUtil } from './AssetUtil';
import { PreferencesUtil } from './PreferencesUtil';
import { RandomUtil } from './RandomUtil';
import deviceInfo from '@ohos.deviceInfo';
import { ResUtil } from './ResUtil';
import { identifier } from '@kit.AdsKit';
export const DEVICE_ID_KEY: string = "device_id_cache_harmony_key"; //设备ID的Key
/**
 * 定义移除操作的存储方法接口
 */
interface StorageMethodForRemove {
  removeSync: (key: string) => void;
}

/**
 * 定义获取和添加操作的存储方法接口
 */
interface StorageMethodForGetAdd {
  getSync: (key: string) => string | null;
  addSync: (key: string, value: string) => void;
}

/**
 * 设备相关工具类。
 * 提供设备信息、配置、能力、振动等功能的访问。
 *
 * @author 鸿蒙布道师
 * @since 2025/04/09
 */
export class DeviceUtil {
  private static deviceId: string = ''; // 设备ID
  /**
   * 获取设备ID（卸载APP后依旧不变）。
   * 如果未生成过设备ID，则会自动生成并存储。
   *
   * @param rule 是否包含 `-`，默认为 true。
   * @param generateId 自定义生成的ID（可选）。
   * @returns 返回设备ID。
   */
  static getDeviceId(rule: boolean = true, generateId?: string): string {
    if (StrUtil.isEmpty(DeviceUtil.deviceId)) {
      // 使用定义的接口类型
      const storageMethod: StorageMethodForGetAdd = AssetUtil.canIUse()
        ? AssetUtil
        : PreferencesUtil;

      const storedId: string | null = storageMethod.getSync(DEVICE_ID_KEY);
      let deviceId: string = StrUtil.toStr(storedId);

      if (StrUtil.isEmpty(deviceId)) {
        deviceId = generateId && StrUtil.isNotEmpty(generateId)
          ? generateId
          : RandomUtil.generateRandomUUID(true);

        if (!rule) {
          deviceId = deviceId.replace(/-/g, '');
        }

        storageMethod.addSync(DEVICE_ID_KEY, deviceId);
        !AssetUtil.canIUse() && LogUtil.error('当前设备不支持关键资产存储服务');
      }
      DeviceUtil.deviceId = deviceId;
    }
    return DeviceUtil.deviceId;
  }

  /**
   * 移除设备ID。
   */
  static deleteDeviceId(): void {
    DeviceUtil.deviceId = '';

    // 使用定义的接口类型
    const storageMethod: StorageMethodForRemove = AssetUtil.canIUse()
      ? AssetUtil
      : PreferencesUtil;

    storageMethod.removeSync(DEVICE_ID_KEY);
  }

  /**
   * 获取设备品牌名称。示例：HUAWEI。
   */
  static getBrand(): string {
    return deviceInfo.brand;
  }

  /**
   * 获取认证型号。示例：ALN-AL00。
   */
  static getProductModel(): string {
    return deviceInfo.productModel;
  }

  /**
   * 获取品牌和型号组合。示例：HUAWEI ALN-AL00。
   */
  static getBrandModel(): string {
    return `${deviceInfo.brand} ${deviceInfo.productModel}`;
  }

  /**
   * 获取市场名称。示例：HUAWEI Mate 60 Pro。
   */
  static getMarketName(): string {
    return deviceInfo.marketName;
  }

  /**
   * 获取硬件版本号。示例：HL1CMSM。
   */
  static getHardwareModel(): string {
    return deviceInfo.hardwareModel;
  }

  /**
   * 获取设备厂家名称。示例：HUAWEI。
   */
  static getManufacture(): string {
    return deviceInfo.manufacture;
  }

  /**
   * 获取系统版本。示例：HarmonyOS 5.0.0。
   */
  static getOsFullName(): string {
    return deviceInfo.osFullName;
  }

  /**
   * 获取产品版本。示例：ALN-AL00 5.0.0.1(XXX)。
   */
  static getDisplayVersion(): string {
    return deviceInfo.displayVersion;
  }

  /**
   * 获取系统软件API版本。示例：12。
   */
  static getSdkApiVersion(): number {
    return deviceInfo.sdkApiVersion;
  }

  /**
   * 获取编译构建的版本号。
   */
  static getBuildVersion(): number {
    return deviceInfo.buildVersion;
  }

  /**
   * 获取OS版本号。示例：5.0.0。
   */
  static getOsVersion(): string {
    return `${deviceInfo.majorVersion}.${deviceInfo.seniorVersion}.${deviceInfo.featureVersion}`;
  }

  /**
   * 获取开发者匿名设备标识符。
   */
  static getODID(): string {
    return deviceInfo.ODID;
  }

  /**
   * 获取设备序列号。需要权限：ohos.permission.sec.ACCESS_UDID。
   */
  static getSerial(): string {
    return deviceInfo.serial;
  }

  /**
   * 获取设备UDID。需要权限：ohos.permission.sec.ACCESS_UDID。
   */
  static getUdid(): string {
    return deviceInfo.udid;
  }

  /**
   * 获取开放匿名设备标识符。需要权限：ohos.permission.APP_TRACKING_CONSENT。
   */
  static async getOAID(): Promise<string> {
    return identifier.getOAID();
  }

  /**
   * 获取应用二进制接口（Abi）。示例：arm64-v8a。
   */
  static getAbiList(): string {
    return deviceInfo.abiList;
  }

  /**
   * 获取系统的发布类型。取值为：Canary、Beta、Release。
   */
  static getOsReleaseType(): string {
    return deviceInfo.osReleaseType;
  }

  /**
   * 获取当前设备类型编号。
   */
  static getDeviceType(): number {
    return DeviceUtil.getDeviceCapabilitySync().deviceType;
  }

  /**
   * 获取当前设备类型的字符串描述。
   */
  static getDeviceTypeStr(): string {
    switch (DeviceUtil.getDeviceType()) {
      case DeviceType.DEVICE_TYPE_PHONE:
        return '手机';
      case DeviceType.DEVICE_TYPE_TABLET:
        return '平板';
      case DeviceType.DEVICE_TYPE_PC:
        return '电脑';
      case DeviceType.DEVICE_TYPE_TV:
        return '电视';
      case DeviceType.DEVICE_TYPE_CAR:
        return '汽车';
      case DeviceType.DEVICE_TYPE_WEARABLE:
        return '穿戴';
      case DeviceType.DEVICE_TYPE_2IN1:
        return '2IN1';
      default:
        return '';
    }
  }

  /**
   * 获取设备的Configuration（异步）。
   */
  static async getConfiguration(): Promise<resourceManager.Configuration> {
    return ResUtil.getConfiguration(true);
  }

  /**
   * 获取设备的Configuration（同步）。
   */
  static getConfigurationSync(): resourceManager.Configuration {
    return ResUtil.getConfigurationSync();
  }

  /**
   * 获取当前设备屏幕方向。
   */
  static getDirection(): Direction {
    return DeviceUtil.getConfigurationSync().direction;
  }

  /**
   * 获取设备的DeviceCapability（异步）。
   */
  static async getDeviceCapability(): Promise<resourceManager.DeviceCapability> {
    return ResUtil.getDeviceCapability(true);
  }

  /**
   * 获取设备的DeviceCapability（同步）。
   */
  static getDeviceCapabilitySync(): resourceManager.DeviceCapability {
    return ResUtil.getDeviceCapabilitySync();
  }

  /**
   * 获取当前设备屏幕密度。
   */
  static getScreenDensity(): ScreenDensity {
    return DeviceUtil.getDeviceCapabilitySync().screenDensity;
  }

  /**
   * 开启振动。
   * 需要权限：ohos.permission.VIBRATE。
   *
   * @param duration 振动时长（毫秒），默认为 1000ms。
   * @param usage 振动用途，默认为 'media'。
   */
  static startVibration(duration: number = 1000, usage: vibrator.Usage = 'media'): Promise<void> {
    return vibrator.startVibration({ type: 'time', duration }, { id: 0, usage });
  }

  /**
   * 停止振动。
   * 需要权限：ohos.permission.VIBRATE。
   */
  static stopVibration(): Promise<void> {
    return vibrator.stopVibration(VibratorStopMode.VIBRATOR_STOP_MODE_TIME);
  }
}
相关推荐
kymjs张涛1 小时前
零一开源｜前沿技术周报 #7
android·前端·ios
wuwu_q3 小时前
RK3566/RK3568 Android11 修改selinux模式
android·rk3568
思考着亮3 小时前
15-错误处理
ios
财经三剑客3 小时前
鸿蒙智行6月交付新车52747辆 单日交付量3651辆
华为·harmonyos
睿麒3 小时前
鸿蒙app 开发中的 map 映射方式和用法
华为·harmonyos
思考着亮3 小时前
9.方法
ios
_一条咸鱼_4 小时前
Android Runtime内存共享与访问控制原理剖析(71)
android·面试·android jetpack
嘉小华4 小时前
第三章：焦点分发全链路源码解析
android
嘉小华4 小时前
Android 协程全景式深度解析：第六章 高阶并发模式
android
嘉小华4 小时前
Android 协程全景式深度解析：第七章 协程调试与性能优化
android
热门推荐
01【无标题】02集群聊天服务器---MySQL数据库的建立03Coze扣子平台完整体验和实践（附国内和国际版对比）04Java类变量（静态变量）05KGG转MP3工具|非KGM文件|解密音频06扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解07绿色建筑新态势：楼宇自控助力能效提升，推动成本优化新路径08使用Ruby接入实时行情API教程09DeepSeek各版本说明与优缺点分析10基于uni-app的书法学习管理小程序的设计与实现