OpenHarmony如何查询设备类型

1,360 阅读5分钟

携手创作,共同成长!这是我参与「掘金日新计划 · 8 月更文挑战」的第10天, 点击查看活动详情

如何查询设备类型

在应用开发过程中查询设备类型。

  • 通过js接口查询指定系统参数(const.build.characteristics)进而确定设备类型,详见系统属性
// @ts-nocheckimport parameter from '@ohos.systemParameter'@Entry
@Component
struct GetDeviceTypeSample {
  @State deviceType: string = 'unknown';
​
​
​
  build() {
    Column() {
      Text("获取设备类型").fontSize(24)
      Text(this.deviceType).fontSize(24).onClick(()=>{
        try {
          this.deviceType = parameter.getSync("const.build.characteristics");
        } catch(e) {
          console.log("getSync unexpected error: " + e);
        }
​
      })
    }
    .width('100%')
    .height('100%')
  }
}

通过deviceInfo查询设备类型,deviceInfo中各个字段的含义请参考设备信息

// @ts-nocheck
/*
 * Copyright (c) 2021 JianGuo Device Co., Ltd.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
import parameter from '@ohos.systemParameter'@Entry
@Component
struct GetDeviceTypeSample {
  @State deviceType: string = 'unknown';
​
​
​
  build() {
    Column() {
      Text("获取设备类型").fontSize(24)
      //通过js接口查询指定系统参数(const.build.characteristics)进而确定设备类型
      Text(this.deviceType).fontSize(24).onClick(()=>{
        try {
          this.deviceType = parameter.getSync("const.build.characteristics");
        } catch(e) {
          console.log("getSync unexpected error: " + e);
        }
​
      })
      //通过deviceInfo查询设备类型
      Text(this.deviceType).fontSize(24).onClick(()=>{
        try {
          this.deviceType= deviceInfo.deviceType;
        } catch(e) {
          console.log("getSync unexpected error: " + e);
        }
​
      })
      //通过display查询显示设备的属性(包括屏幕宽、高和屏幕密度等)
      Text(this.deviceType).fontSize(24).onClick(()=>{
        display.getDefaultDisplay()
          .then((displayInfo) => {
            console.info('Display width: '+ displayInfo.width);
            console.info('Display height: '+ displayInfo.height);
            console.info('Display density: '+ displayInfo.densityDPI);
          })
          .catch((error) => {
            console.error('Failed to obtain the default display size. Cause:  '+JSON.stringify(error));
          })
​
      })
    }
    .width('100%')
    .height('100%')
  }
}

如何查询屏幕/窗口尺寸

在应用开发过程中,为了在不同的设备上取得更好的显示效果,开发者可能需要查询屏幕尺寸或应用显示窗口尺寸。

  • 通过display查询显示设备的属性(包括屏幕宽、高和屏幕密度等),详见屏幕属性
// @ts-nocheck
/*
 * Copyright (c) 2021 JianGuo Device Co., Ltd.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
import deviceInfo from'@ohos.deviceInfo'
import parameter from '@ohos.systemParameter'
import display from '@ohos.display';
​
@Entry
@Component
struct GetDeviceTypeSample {
  @State deviceType: string = 'deviceType';
  @State device: string = 'device';
  @State displayInfo: string = 'displayInfo';
​
  aboutToAppear() {
    try {
      this.deviceType = parameter.getSync("const.build.characteristics");
    } catch(e) {
      console.log("getSync unexpected error: " + e);
    }
  }
  build() {
    Column() {
      Text("设备属性").fontSize(36)
      //通过js接口查询指定系统参数(const.build.characteristics)进而确定设备类型
      Text(this.deviceType).fontSize(28).onClick(() => {
        try {
          this.deviceType = parameter.getSync("const.build.characteristics");
          console.log("坚果"
          +
          this.deviceType);
        } catch (e) {
          console.log("getSync unexpected error: " + e);
        }
​
      })
      //通过deviceInfo查询设备类型
      Text(   this.device).fontSize(28).onClick(() => {
        this.device= deviceInfo.deviceType;
      })
      //通过display查询显示设备的属性(包括屏幕宽、高和屏幕密度等)
      Text(this.displayInfo).fontSize(28).onClick(() => {
        display.getDefaultDisplay()
          .then((displayInfo) => {
            console.info('Display width: ' + displayInfo.width);
            console.info('Display height: ' + displayInfo.height);
            console.info('Display density: ' + displayInfo.densityDPI);
            this.displayInfo=JSON.stringify(displayInfo);
            console.info('Display density: ' +   JSON.stringify(displayInfo));
​
          })
          .catch((error) => {
            console.error('Failed to obtain the default display size. Cause:  ' + JSON.stringify(error));
          })
​
      })
    }
    .width('100%')
    .height('100%').justifyContent(FlexAlign.Center).alignItems(HorizontalAlign.Center)
  }
}

运行之后,在控制台打印

{"alive":true,"densityDPI":560,"densityPixels":3.5,"height":2560,"id":0,"name":"内置屏幕","refreshRate":60.000004,"rotation":0,"scaledDensity":3.5,"state":2,"width":1440,"xDPI":560,"yDPI":560}

下面是参数描述

Display

描述display对象的属性。

系统能力: 以下各项对应的系统能力均为 SystemCapability.WindowManager.WindowManager.Core。

名称参数类型可读可写说明
idnumber显示设备的id号。
namestring显示设备的名称。
aliveboolean显示设备是否启用。
stateDisplayState显示设备的状态。
refreshRatenumber显示设备的刷新率。
rotationnumber显示设备的屏幕旋转角度。
widthnumber显示设备的宽度,单位为像素。
heightnumber显示设备的高度,单位为像素。
densityDPInumber显示设备的屏幕密度,单位为DPI。
densityPixelsnumber显示设备的屏幕密度,单位为像素。
scaledDensitynumber显示设备的显示字体的缩放因子。
xDPInumberx方向中每英寸屏幕的确切物理像素值。
yDPInumbery方向中每英寸屏幕的确切物理像素值。

设备信息

icon-note.gif 说明: 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import deviceInfo from '@ohos.deviceInfo'

属性

系统能力:以下各项对应的系统能力均为SystemCapability.Startup.SysInfo。 权限:以下各项所需要的权限有所不同,详见下表。

名称参数类型可读可写描述
deviceTypestring设备类型。
manufacturestring设备厂家名称。
brandstring设备品牌名称。
marketNamestring外部产品系列。
productSeriesstring产品系列。
productModelstring认证型号。
softwareModelstring内部软件子型号。
hardwareModelstring硬件版本号。
hardwareProfilestring硬件Profile。
serialstring设备序列号。 需要权限:ohos.permission.sec.ACCESS_UDID,该权限为系统权限
bootloaderVersionstringBootloader版本号。
abiListstring应用二进制接口(Abi)列表。
securityPatchTagstring安全补丁级别。
displayVersionstring产品版本。
incrementalVersionstring差异版本号。
osReleaseTypestring系统的发布类型,取值为: - Canary:面向特定开发者发布的早期预览版本,不承诺API稳定性。 - Beta:面向开发者公开发布的Beta版本,不承诺API稳定性。 - Release:面向开发者公开发布的正式版本,承诺API稳定性。
osFullNamestring系统版本。
majorVersionnumberMajor版本号,随主版本更新增加。
seniorVersionnumberSenior版本号,随局部架构、重大特性增加。
featureVersionnumberFeature版本号,标识规划的新特性版本。
buildVersionnumberBuild版本号,标识编译构建的版本号。
sdkApiVersionnumber系统软件API版本。
firstApiVersionnumber首个版本系统软件API版本。
versionIdstring版本ID。
buildTypestring构建类型。
buildUserstring构建用户。
buildHoststring构建主机。
buildTimestring构建时间。
buildRootHashstring构建版本Hash。
udid7+string设备Udid。 需要权限:ohos.permission.sec.ACCESS_UDID,该权限为系统权限

屏幕属性