uni-app如何实留在App端获取手机屏幕的物理分辨率及密度

雨杰同学_6792

雨杰同学_6792

2026-06-26

590人浏览

原创

uni.getsysteminfosync() 返回的 screenwidth/screenheight 是物理像素,如 iphone 14 pro 对应 1170×2532;windowwidth/windowheight 才是动态逻辑尺寸;pixelratio 表示物理像素与 css 像素比,影响高清图加载与 canvas 渲染。

uni-app如何实留在app端获取手机屏幕的物理分辨率及密度

uni.getSystemInfoSync() 返回的 screenWidth/screenHeight 是物理像素还是逻辑像素?

返回的是设备屏幕的**物理像素值**,不是 CSS 像素或逻辑像素。比如 iPhone 14 Pro 的 screenWidth 是 1170,screenHeight 是 2532 —— 这就是它真实 LCD 面板的像素数。

但要注意:windowWidth 和 windowHeight 才是当前渲染区域的逻辑尺寸(单位:px),受状态栏、导航栏、软键盘弹出等影响,实际可用视口可能更小。

  • screenWidth/screenHeight:固定不变,代表整块屏幕物理分辨率
  • windowWidth/windowHeight:动态变化,代表当前 WebView 可绘制区域大小
  • 两者在全屏无导航栏时可能接近,但绝不等价

pixelRatio 是什么?它和 DPI/PPI 有什么关系?

pixelRatio 是设备像素比(device pixel ratio),等于 物理像素 / CSS 像素。它不直接等于系统标称的 DPI 或 PPI,但高度相关 —— 比如 pixelRatio === 3 意味着 1 个 CSS 像素要由 3×3=9 个物理像素渲染。

这个值决定了高清图加载策略、canvas 绘制缩放、字体渲染精度等关键行为。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • iOS 设备通常为 2 或 3(iPhone 8 是 2,iPhone 14 Pro 是 3)
  • Android 设备差异大,常见 2.0、2.75、3.0、3.5+,部分厂商还伪造该值
  • 不能用 pixelRatio 精确换算 DPI,但可用于分级选图(如 @2x / @3x)

App 端获取失败或数值异常的常见原因

在 App(iOS/Android)环境下,uni.getSystemInfoSync() 有时返回默认值(如 screenWidth: 375)或明显错误值,主要因为:

  • 调用时机太早:在 onLoad 之前(如 data 初始化阶段)调用,此时 native 层尚未就绪
  • Android 权限缺失:某些定制 ROM(如华为 EMUI、小米 MIUI)需声明 android.permission.READ_PHONE_STATE 才能准确读取屏幕参数(虽非强制,但影响部分字段)
  • 微信小程序混淆:如果项目同时编译到微信小程序,getSystemInfoSync 在小程序端返回的是逻辑尺寸,容易误判为 App 行为
  • 未区分平台:iOS 的 screenHeight 包含底部安全区,而 Android 多数不包含;建议优先用 windowHeight 做布局,用 screenHeight 做资源适配

推荐写法:安全获取并缓存屏幕信息

不要每次渲染都调用 uni.getSystemInfoSync(),也不要在 data 里直接赋值。应封装成可复用的工具函数,并在生命周期早期(onLaunch 或首个页面 onLoad)执行一次缓存。

const screenInfo = (() => {
  try {
    const info = uni.getSystemInfoSync()
    return {
      width: info.screenWidth,
      height: info.screenHeight,
      dpr: info.pixelRatio,
      windowWidth: info.windowWidth,
      windowHeight: info.windowHeight
    }
  } catch (e) {
    // fallback to safe defaults
    return { width: 750, height: 1334, dpr: 1, windowWidth: 750, windowHeight: 1200 }
  }
})()

后续组件中直接引用 screenInfo.width 即可,避免重复调用和异常中断渲染。

真正容易被忽略的是:App 启动后屏幕方向切换(横竖屏)不会触发 getSystemInfoSync 自动更新 —— 如果你的应用支持横屏,必须监听 uni.onWindowResize 并手动刷新 windowWidth/windowHeight,screenWidth/screenHeight 则始终不变。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

uni-app

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2143

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4583

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5730

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5178

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

743

5

es6新特性
es6新特性

es6新特性有:1、块级作用域变量;2、箭头函数;3、模板字符串;4、解构赋值;5、默认参数;6、 扩展运算符;7、 类和继承;8、Promise。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

265

5

es6新特性有哪些
es6新特性有哪些

es6的新特性有:1、块级作用域;2、箭头函数;3、解构赋值;4、默认参数;5、扩展运算符;6、模板字符串;7、类和模块;8、迭代器和生成器;9、Promise对象;10、模块化导入和导出等等。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.04

386

5

JavaScript ES6新特性
JavaScript ES6新特性

ES6是JavaScript的根本性升级,引入let/const实现块级作用域、箭头函数解决this绑定问题、解构赋值与模板字符串简化数据处理、对象简写与模块化提升代码可读性与组织性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.24

355

12

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

3591

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习