`uni.getSystemInfo` 是 uni-app 提供的一个 API,用于获取系统信息,包括设备、屏幕、操作系统等相关信息。

1,604 阅读1分钟

使用说明

通过调用 uni.getSystemInfo,可以获取当前设备的各种详细信息,如屏幕尺寸、操作系统版本、设备品牌等。这对于开发中的适配和特定功能的实现非常有用。

API 结构

uni.getSystemInfo({
    success: function (res) {
        console.log(res.model);
        console.log(res.pixelRatio);
        console.log(res.windowWidth);
        console.log(res.windowHeight);
        console.log(res.language);
        console.log(res.version);
        console.log(res.platform);
        // ...其他信息
    },
    fail: function (err) {
        console.error('获取系统信息失败', err);
    },
    complete: function () {
        console.log('获取系统信息调用结束');
    }
});

参数说明

  • success(Function):接口调用成功的回调函数,res 参数中将包含系统信息。
  • fail(Function):接口调用失败的回调函数。
  • complete(Function):接口调用结束的回调函数(无论成功或失败都会执行)。

示例代码

以下是使用 uni.getSystemInfo 的一个示例:

uni.getSystemInfo({
    success: function (res) {
        console.log('手机型号:' + res.model);
        console.log('设备像素比:' + res.pixelRatio);
        console.log('窗口宽度:' + res.windowWidth);
        console.log('窗口高度:' + res.windowHeight);
        console.log('系统语言:' + res.language);
        console.log('操作系统版本:' + res.system);
        console.log('平台:' + res.platform);
        // ...其他信息
    },
    fail: function (err) {
        console.error('获取系统信息失败:', err);
    },
    complete: function () {
        console.log('获取系统信息调用结束');
    }
});

在这个示例中,成功回调中打印了设备的各种信息,包括设备型号、屏幕尺寸、操作系统版本等。

更多详情和参数配置,请参考 uni-app 官方文档