1# @system.device (设备信息) 2 3本模块提供当前设备的信息。 4 5> **说明：** 6> - 从API Version 6开始，该接口不再维护，推荐使用新接口[`@ohos.deviceInfo`](js-apis-device-info.md)进行设备信息查询。 7> 8> - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 9 10## 导入模块 11 12``` 13import device from '@system.device'; 14``` 15 16## device.getInfo 17 18getInfo(options?: GetDeviceOptions): void 19 20获取当前设备的信息。 21 22> **说明：**<br> 23> 在首页的onShow生命周期之前不建议调用device.getInfo接口。 24 25**系统能力：** SystemCapability.Startup.SystemInfo 26 27**参数：** 28 29| 参数名 | 类型 | 必填 | 说明 | 30| -------- | -------- | -------- | -------- | 31| options | [GetDeviceOptions](#getdeviceoptions) | 否 | 定义设备信息获取的参数选项。 | 32 33## GetDeviceOptions 34 35定义设备信息获取的参数选项。 36 37**系统能力：** SystemCapability.Startup.SystemInfo 38 39| 名称 | 类型 | 必填 | 说明 | 40| -------- | -------- | -------- | -------- | 41| success | (data：DeviceResponse）=> void | 否 | 接口调用成功的回调函数。 data为成功返回的设备信息，具体参考[DeviceResponse](#deviceresponse)。| 42| fail | (data：any,code:number）=> void | 否 | 接口调用失败的回调函数。 code为失败返回的错误码。<br>code:200，表示返回结果中存在无法获得的信息。| 43| complete | （）=> void | 否 | 接口调用结束的回调函数。 | 44 45## DeviceResponse 46 47设备信息。 48 49**系统能力：** SystemCapability.Startup.SystemInfo 50 51| 名称 | 类型 | 说明 | 52| -------- | -------- | -------- | 53| brand | string | 品牌。 | 54| manufacturer | string | 生产商。 | 55| model | string | 型号。 | 56| product | string | 代号。 | 57| language<sup>4+</sup> | string | 系统语言。 | 58| region<sup>4+</sup> | string | 系统地区。 | 59| windowWidth | number | 可使用的窗口宽度。 | 60| windowHeight | number | 可使用的窗口高度。 | 61| screenDensity<sup>4+</sup> | number | 屏幕密度。 | 62| screenShape<sup>4+</sup> | string | 屏幕形状。可取值：<br/>- rect：方形屏；<br/>- circle：圆形屏。 | 63| apiVersion<sup>4+</sup> | number | 系统API版本号。 | 64| releaseType<sup>4+</sup> | string | 版本发布类型，值为类型+版本号，如Beta1。<br/>类型可能值有：<br/>- Canary：同一apiVersion下，canary版本之间保持API兼容，beta版本不对canary版本兼容。<br/>- Beta：同一apiVersion下，beta版本之间保持API兼容，release版本不对beta版本兼容。<br/>- Release：release版本会保持5个API版本兼容。 | 65| deviceType<sup>4+</sup> | string | 设备类型。 | 66 67 68**示例：** 69 70``` 71export default { 72 getInfo() { 73 device.getInfo({ 74 success: function(data) { 75 console.log('Device information obtained successfully. Device brand:' + data.brand); 76 }, 77 fail: function(data, code) { 78 console.log('Failed to obtain device information. Error code:'+ code + '; Error information: ' + data); 79 }, 80 }); 81 }, 82} 83```