鸿蒙语言基础类库：【@system.device (设备信息)】

爱桥代码的程序媛2024-07-17 21:24

设备信息

说明：

从API Version 6开始，该接口不再维护，推荐使用新接口 $`@ohos.deviceInfo`$ 进行设备信息查询。

本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

复制代码

import device from '@system.device';

device.getInfo

getInfo(Object): void

获取当前设备的信息。

说明： 在首页的onShow生命周期之前不建议调用device.getInfo接口。

系统能力： SystemCapability.Startup.SysInfo

参数：

参数名	类型	必填	说明
success	Function	否	接口调用成功的回调函数。
fail	Function	否	接口调用失败的回调函数。
complete	Function	否	接口调用结束的回调函数。

success返回值：

参数名	类型	说明
brand	string	品牌。
manufacturer	string	生产商。
model	string	型号。
product	string	代号。
language4+	string	系统语言。
region4+	string	系统地区。
windowWidth	number	可使用的窗口宽度。
windowHeight	number	可使用的窗口高度。
screenDensity4+	number	屏幕密度。
screenShape4+	string	屏幕形状。可取值： - rect：方形屏； - circle：圆形屏。
apiVersion4+	number	系统API版本号。
releaseType4+	string	版本发布类型，值为类型+版本号，如Beta1。类型可能值有： - Canary：同一apiVersion下，canary版本之间保持API兼容，beta版本不对canary版本兼容。 - Beta：同一apiVersion下，beta版本之间保持API兼容，release版本不对beta版本兼容。 - Release：release版本会保持5个API版本兼容。
deviceType4+	string	设备类型。

fail返回错误代码：

错误码	说明
200	返回结果中存在无法获得的信息。

示例：

复制代码

export default {    
  getInfo() {        
    device.getInfo({            
      success: function(data) {                
        console.log('Device information obtained successfully. Device brand:' + data.brand);            
      },            
      fail: function(data, code) {                
        console.log('Failed to obtain device information. Error code:'+ code + '; Error information: ' + data);            
      },        
    });    
  },
}