讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app获取设备信息 uni-app如何获取手机系统和型号

浅晨吖_1425

浅晨吖_1425

发布时间:2026-03-21 20:24:46

|

993人浏览过

|

来源于php中文网

原创

uni.getSystemInfoSync()是最稳的获取方式,同步返回完整设备信息,避免异步时机问题;model字段才是手机型号,brand为厂商名,platform仅为运行平台;真机调试才可靠,精确识别需UTS调原生API。

uni-app获取设备信息 uni-app如何获取手机系统和型号

uni.getSystemInfoSync() 是最稳的获取方式

绝大多数场景下,直接用 uni.getSystemInfoSync() 就够了——它同步返回完整设备信息,不涉及回调、Promise 或平台差异处理,也不会因异步时机问题拿不到值。

常见错误现象:有人在 onLoad 里写 uni.getSystemInfo()(异步版)却没等 success 回调就直接用 res,结果拿到 undefined;还有人误以为要先调 uni.getDeviceInfo() 才能取型号,其实它只返回 platform("ios"/"android")和一些极简字段,不包含 model。

  • model 字段才是「手机型号」,比如 "iPhone 15 Pro" 或 "Xiaomi 23127PN0CC"
  • brand 是厂商名,如 "Apple"、"Xiaomi",但部分安卓定制系统可能返回空或 "unknown"
  • platform 是运行平台("ios"/"android"/"harmony"),不是手机型号,别混淆
  • 真机调试时才可靠,HBuilderX 模拟器返回的是模拟值,不能用于判断硬件能力

需要精确到芯片/代际?得用 UTS 直接调原生 API

当项目要求识别是否为 M系列 Mac(macOS)、是否搭载 A17 芯片、或想读取 Build.MODEL 原始字符串(比如区分 "SM-S918B" 和 "SM-S918U")时,uni.getSystemInfoSync() 的 model 会被规范化(如统一成 "Samsung Galaxy S23"),这时必须进 UTS 层。

使用场景:做灰度发布开关、适配某款新机型独有 bug、对接硬件 SDK 要求精确设备指纹。

  • Android 端在 UTS 中写 import Build from 'android.os.Build',然后用 Build.MODEL 或 Build.DEVICE
  • iOS 端用 UTSiOS.UIDevice.currentDevice.model(返回 "iPhone" 或 "iPad")配合 UTSiOS.NSProcessInfo.processInfo.environment["SIMULATOR_DEVICE_NAME"] 辅助判断
  • 鸿蒙端需检查 osHarmonySDKAPIVersion 是否 ≥ 14,再调 @ohos.deviceInfo 模块
  • 注意:UTS 代码无法在 H5 平台运行,务必加平台判断或 fallback

model 字段在不同平台表现不一致

model 看似统一,实则各端填充逻辑不同,容易引发兼容性问题。比如 iOS 返回 "iPhone15,2" 这类代号,而 Android 多数返回用户可见型号(但 OEM 定制 ROM 可能乱填)。

性能影响小,但逻辑判断时若写死字符串匹配(如 res.model.includes("iPhone 15")),上线后可能漏掉部分设备。

  • 不要依赖 model 做精确机型白名单,优先用 platform + system + SDKVersion 组合判断
  • 华为/荣耀设备可能返回 "HMA-AL00" 这类内部型号,brand 却是 "HUAWEI",需额外兼容
  • 鸿蒙 NEXT(纯血鸿蒙)下 uni.getSystemInfoSync().model 返回值尚未完全对齐安卓/iOS,建议用 uni.getDeviceInfo().osHarmonySDKAPIVersion 辅助识别

别在 onLaunch 里盲目缓存 deviceInfo

有人习惯在 App.vue 的 onLaunch 里调一次 uni.getSystemInfoSync() 存到 vuex 或 globalData,觉得“只查一次更省”。但实际中,这个值可能被后续热更新、分包加载、甚至某些插件重置。

使用场景:启动页展示设备型号、埋点初始化、动态加载资源前做兼容判断。

  • 如果只是页面内用,就在页面 onLoad 里调,别跨生命周期强依赖
  • 若真要全局缓存,请用 uni.setStorageSync 存一次,并加时间戳校验,避免旧值残留超过 24 小时
  • 特别注意:鸿蒙平台首次安装后,onLaunch 可能触发两次(冷启+热启),重复写缓存会导致覆盖异常

真正麻烦的不是怎么取,而是取回来之后发现 model 不可比、brand 不可信、platform 在鸿蒙 NEXT 里突然多了一个 "harmony" 值——这些边界情况,文档很少写,但线上一出问题就是整批用户不可用。

数码产品性能查询
数码产品性能查询

该软件包括了市面上所有手机CPU,手机跑分情况,电脑CPU,电脑产品信息等等,方便需要大家查阅数码产品最新情况,了解产品特性,能够进行对比选择最具性价比的商品。

下载

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

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

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

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

2543

2023.08.11

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

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

5503

2023.10.09

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

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

6510

2024.03.19

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

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

6158

2024.03.22

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

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

883

2024.05.22

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

20

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

0

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

20

2026.10.16

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn