设备信息

icon-note.gif 说明:

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

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

导入模块

import device from '@system.device';

device.getInfo

getInfo(Object): void

获取当前设备的信息。

icon-note.gif 说明: 在首页的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);            
      },        
    });    
  },
}