如何使用 uni.getDeviceInfo 获取设备信息？

推荐答案

// www.javascriptcn.com code example
uni.getDeviceInfo({
  success: function (res) {
    console.log('设备品牌:', res.brand);
    console.log('设备型号:', res.model);
    console.log('系统版本:', res.system);
    console.log('平台:', res.platform);
    console.log('屏幕宽度:', res.screenWidth);
    console.log('屏幕高度:', res.screenHeight);
    console.log('像素比:', res.pixelRatio);
    console.log('状态栏高度:', res.statusBarHeight);
    console.log('安全区域:', res.safeArea);
  },
  fail: function (err) {
    console.error('获取设备信息失败:', err);
  }
});

本题详细解读

1. uni.getDeviceInfo 的作用

uni.getDeviceInfo 是 uni-app 提供的一个 API，用于获取当前设备的相关信息。这些信息包括设备的品牌、型号、操作系统版本、平台、屏幕尺寸、像素比、状态栏高度以及安全区域等。

2. API 参数说明

• success: 获取设备信息成功的回调函数，返回一个包含设备信息的对象。
• fail: 获取设备信息失败的回调函数，返回错误信息。

3. 返回的设备信息对象

• brand: 设备品牌，如 "Apple" 或 "Xiaomi"。
• model: 设备型号，如 "iPhone X" 或 "Mi 10"。
• system: 操作系统版本，如 "iOS 14.0" 或 "Android 10"。
• platform: 运行平台，如 "ios" 或 "android"。
• screenWidth: 屏幕宽度，单位为 px。
• screenHeight: 屏幕高度，单位为 px。
• pixelRatio: 设备像素比。
• statusBarHeight: 状态栏高度，单位为 px。
• safeArea: 安全区域信息，包含 top、bottom、left、right 等属性，单位为 px。

4. 使用场景

• 适配不同设备的屏幕尺寸。
• 根据设备信息进行特定的逻辑处理。
• 获取状态栏高度以调整页面布局。

5. 注意事项

• uni.getDeviceInfo 是异步操作，需要使用回调函数处理返回结果。
• 不同平台的设备信息可能有所不同，建议在实际开发中进行兼容性测试。