OBJECT 参数说明:
success 返回参数说明:
参数 | 说明 | 平台差异说明 |
---|---|---|
brand | 手机品牌 | 微信小程序 |
model | 手机型号 | |
pixelRatio | 设备像素比 | |
screenWidth | 屏幕宽度 | |
screenHeight | 屏幕高度 | |
windowWidth | 可使用窗口宽度 | |
windowHeight | 可使用窗口高度 | |
windowTop | 可使用窗口的顶部位置 | 5+App、H5 |
windowBottom | 可使用窗口的底部位置 | 5+App、H5 |
statusBarHeight | 状态栏的高度 | |
language | 应用设置的语言 | |
version | 引擎版本号 | 微信小程序、5+App |
system | 操作系统版本 | |
platform | 客户端平台,值域为:、android | |
fontSizeSetting | 用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位:px | 微信小程序 |
SDKVersion | 客户端基础库版本 | 微信小程序、5+App |
safeArea | 在竖屏正方向下的安全区域 | 微信小程序 |
Tips
- 屏幕高度=状态栏高度+原生导航栏高度+可使用窗口高度+原生tabbar高度
- H5端,windowHeight不包含NavigationBar和TabBar的高度,windowTop等于NavigationBar高度,windowBottom等于TabBar高度,statusBarHeight为0safeArea 的结构
示例
同步返回参数说明
参数 | 说明 | 平台差异说明 |
---|---|---|
brand | 手机品牌 | 微信小程序、百度小程序 |
model | 手机型号 | |
pixelRatio | 设备像素比 | |
screenWidth | 屏幕宽度 | |
screenHeight | 屏幕高度 | |
windowWidth | 可使用窗口宽度 | |
windowHeight | 可使用窗口高度 | |
windowTop | 可使用窗口的顶部位置 | 5+App、H5 |
windowBottom | 可使用窗口的底部位置 | 5+App、H5 |
statusBarHeight | 状态栏的高度 | 5+App、微信小程序、百度小程序 |
language | 应用设置的语言 | 5+App、微信小程序、支付宝小程序、百度小程序 |
version | 引擎版本号 | 5+App、微信小程序 |
system | 操作系统版本 | |
platform | 客户端平台 | |
fontSizeSetting | 用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位:px | 微信小程序、支付宝小程序、百度小程序 |
SDKVersion | 客户端基础库版本 | 5+App、微信小程序、百度小程序、头条小程序 |
safeArea | 在竖屏正方向下的安全区域 | 微信小程序 |
Tips
示例
获取设备标记
Android已经改进用户隐私保护,在很多新手机上,获取imei等信息时需要弹框让用户授权。
- H5平台:常用的方式是uv,即在uni.storage里存一个随机数,本质是存在浏览器的localstorage里。将随机数发给服务器,进行用户身份识别和统计。当然如果用户浏览器清空了localstorage、更换了浏览器、或使用隐私模式,那么就统计数据就会有误差。
- 小程序平台:小程序也可以采用与H5类似的方式,在uni.storage里存一个随机数。如果想获取用户的微信唯一ID,也可以弹框请求用户授权。
- App iOS平台:iOS并不提供imei的获取API,可通过 可以获得设备的唯一标识(uuid),这个id其实也是一种随机数概念。卸载app重装会发生变化;iOS还有一个叫
idfa
的广告识别符,可通过Native.js实现,在社区中搜索可见。 - App Android平台:Android也可以使用UUID,同iOS。但Android还能得到imei,在plus.device.getInfo 可以获得设备的国际移动设备身份码(imei)。注意很多新手机在获取imei时会弹框要求用户授权。
plus.device.getInfo
的API是从HBuilderX 2.0.3+开始提供的,老版需使用plus.devide.uuid或plus.device.imei。
判断应用的 API,回调,参数,组件等是否在当前版本可用。
平台差异说明
5+App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 头条小程序 |
---|---|---|---|---|---|
√ | x | √ | √ | √ | √ |
String 参数说明
${method}
代表调用方式,有效值为return, success, object, callback- 代表参数或者返回值
${options}
代表参数的可选值${component}
代表组件名字- 代表组件属性的可选值示例
发现错误?想参与编辑?