Skip to content

unidocs-zh
unidocs-zh

DCloud / unidocs-zh

通知 3597
Star 108
Fork 921
unidocs-zh
unidocs-zh
提交 2aab2630 编写于 作者: D DCloud_LXH
浏览文件
操作

chore: systemInfo

上级 7efae940
隐藏空白更改
内联 并排
Showing with 41 addition and 41 deletion
docs/api/system/info.md
浏览文件 @ 2aab2630
......@@ -25,47 +25,47 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
**success 返回参数说明：**
|参数分类 |参数 |说明 |App平台值域 |Web平台值域 |小程序平台值域 |平台差异说明 |uni框架版本要求 |
|:- |:- |:- |:- |:- |:- |:- |:- |
|device |deviceId |设备 id 。由 uni-app 框架生成并存储，清空 Storage 会导致改变 | | | | | |
| |deviceType |设备类型 |`phone`、`pad`、`tv`、`car`、`unknow`|`phone`、`pad`、`pc`、`unknow`|`phone`、`pad`、`pc`| |`uni-app (3.4.10+)` |
| |deviceBrand |设备品牌。如：`apple`、`huawei` | |不支持 | | |`uni-app (3.4.10+)` |
| |deviceModel |设备型号 | |部分设备无法获取 | | |`uni-app (3.4.10+)` |
| |devicePixelRatio |设备像素比 | | | | |`uni-app (3.4.13+)` |
| |deviceOrientation |设备方向 |`竖屏 portrait`、`横屏 landscape`|`竖屏 portrait`、`横屏 landscape`|`竖屏 portrait`、`横屏 landscape`|小程序端仅`微信小程序`、`百度小程序`支持|`uni-app (3.4.13+)` |
|参数分类 |参数|说明 |App平台值域 |Web平台值域 |小程序平台值域 |平台差异说明 |uni框架版本要求 |
|:- |:-|:-|:-|:-|:-|:-|:-|
|device |deviceId |设备 id 。由 uni-app 框架生成并存储，清空 Storage 会导致改变||||||
| |deviceType |设备类型 |`phone`、`pad`、`tv`、`car`、`unknow`|`phone`、`pad`、`pc`、`unknow`|`phone`、`pad`、`pc`||`uni-app (3.4.10+)` |
| |deviceBrand |设备品牌。如：`apple`、`huawei` ||不支持 |||`uni-app (3.4.10+)` |
| |deviceModel |设备型号 ||部分设备无法获取 |||`uni-app (3.4.10+)` |
| |devicePixelRatio |设备像素比 || |||`uni-app (3.4.13+)` |
| |deviceOrientation |设备方向 |`竖屏 portrait`、`横屏 landscape`|`竖屏 portrait`、`横屏 landscape`|`竖屏 portrait`、`横屏 landscape`|小程序端仅`微信小程序`、`百度小程序`支持|`uni-app (3.4.13+)` |
|os |osAndroidAPILevel |当前程序的宿主设备搭载的 Android 系统版本代码。详情参考[Android 官方文档](https://developer.android.google.cn/guide/topics/manifest/uses-sdk-element?hl=en#ApiLevels)|`仅 Android 支持`|不支持|不支持||`uni-app (3.4.10+)`|
| |osName |系统名称|ios、android|ios、android、windows、macos、linux|ios、android、windows、macos| |`uni-app (3.4.10+)`|
| |osVersion |操作系统版本。如 ios 版本，andriod 版本| | | | |`uni-app (3.4.10+)` |
| |osLanguage |操作系统语言 |`zh-CN 中文简体`、`zh-TW 中文繁体`、`en-US English`、`bo-CN 藏文`、`ug-CN 维吾尔语`等 |与浏览器语言一致 |不支持 | |`uni-app (3.4.10+)` |
| |osTheme |操作系统主题。 |light、dark|不支持 |不支持 | |`uni-app (3.4.10+)`
| |osName|系统名称|ios、android|ios、android、windows、macos、linux|ios、android、windows、macos||`uni-app (3.4.10+)`|
| |osVersion |操作系统版本。如 ios 版本，andriod 版本|||||`uni-app (3.4.10+)`|
| |osLanguage |操作系统语言|`zh-CN 中文简体`、`zh-TW 中文繁体`、`en-US English`、`bo-CN 藏文`、`ug-CN 维吾尔语`等 |与浏览器语言一致 |不支持 | |`uni-app (3.4.10+)`|
| |osTheme |操作系统主题。 |light、dark|不支持 |不支持 ||`uni-app (3.4.10+)`
|browser |browserName |浏览器名称或App平台系统webview名称|系统 webview 名称，x5webview、wkwebview、chrome |chrome、edge、safari、firefox |不支持||`uni-app (3.4.10+)`|
| |browserVersion |浏览器版本、webview 版本| | |不支持 | |`uni-app (3.4.10+)`|
|host |hostName |App、小程序宿主名称，如：`WeChat`、`FeiShu` |仅 UniMPSDK 支持 |不支持|[取值如下](#hostname)|微信小程序真机运行才有真值|`uni-app (3.4.10+)` |
| |hostVersion |App、小程序宿主版本。如：微信版本号|仅 UniMPSDK 支持 |不支持|小程序宿主版本| |`uni-app (3.4.10+)` |
| |hostLanguage |App、小程序宿主语言|仅 UniMPSDK 支持 |不支持|小程序宿主语言| |`uni-app (3.4.10+)` |
| |browserVersion |浏览器版本、webview 版本|||不支持 ||`uni-app (3.4.10+)`|
|host |hostName |App、小程序宿主名称，如：`WeChat`、`FeiShu`|仅 UniMPSDK 支持 |不支持|[取值如下](#hostname)|微信小程序真机运行才有真值|`uni-app (3.4.10+)`|
| |hostVersion |App、小程序宿主版本。如：微信版本号|仅 UniMPSDK 支持 |不支持|小程序宿主版本||`uni-app (3.4.10+)`|
| |hostLanguage |App、小程序宿主语言|仅 UniMPSDK 支持 |不支持|小程序宿主语言||`uni-app (3.4.10+)`|
| |hostTheme |App 主题、小程序端为系统当前主题|`light`、`dark`。仅 UniMPSDK 支持 |不支持|`light`、`dark`|仅微信小程序全局配置"darkmode":true时才能获取|`uni-app (3.4.10+)` |
| |hostPackageName |小程序宿主包名。仅 App 支持|仅 UniMPSDK 支持 |不支持|不支持| |`uni-app (3.4.10+)`|
| |hostSDKVersion |uni小程序SDK版本、小程序客户端基础库版本|仅 UniMPSDK 支持 |不支持|| |`uni-app (3.4.13+)`|
| |hostPackageName |小程序宿主包名。仅 App 支持|仅 UniMPSDK 支持 |不支持|不支持||`uni-app (3.4.10+)`|
| |hostSDKVersion |uni小程序SDK版本、小程序客户端基础库版本|仅 UniMPSDK 支持 |不支持|||`uni-app (3.4.13+)`|
| |hostFontSizeSetting |用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px|不支持|不支持||微信小程序、支付宝小程序、百度小程序、QQ小程序、字节小程序(2.53.0+)|`uni-app (3.4.13+)`|
|uni-app框架 |uniPlatform |uni-app 运行平台。[取值见下](#uniplatform) |-|-|-| |`uni-app (3.4.10+)`|
| |uniCompileVersion |uni 编译器版本号|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等| |`uni-app (3.4.10+)`|
| |uniRuntimeVersion |uni 运行时版本|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等| |`uni-app (3.4.10+)`|
|app |appId |`manifest.json` 中应用appid，即DCloud appid。 | | | | |`uni-app (3.4.10+)`|
| |appName |`manifest.json` 中应用名称 | | | |和`字节跳动小程序`字段冲突，`字节跳动小程序`原字段与`hostName`一致|`uni-app (3.4.10+)`|
| |appVersion |`manifest.json` 中应用版本名称。 | | | | |`uni-app (3.4.10+)`|
| |appVersionCode |`manifest.json` 中应用版本名号。 | | | | |`uni-app (3.4.10+)`|
|uni-app框架 |uniPlatform |uni-app 运行平台。[取值见下](#uniplatform) |-|-|-||`uni-app (3.4.10+)`|
| |uniCompileVersion |uni 编译器版本号|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等||`uni-app (3.4.10+)`|
| |uniRuntimeVersion |uni 运行时版本|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等|`3.4.10`、`3.2.9` 等||`uni-app (3.4.10+)`|
|app |appId|`manifest.json` 中应用appid，即DCloud appid。 |||||`uni-app (3.4.10+)`|
| |appName |`manifest.json` 中应用名称 ||||和`字节跳动小程序`字段冲突，`字节跳动小程序`原字段与`hostName`一致|`uni-app (3.4.10+)`|
| |appVersion |`manifest.json` 中应用版本名称。 |||||`uni-app (3.4.10+)`|
| |appVersionCode |`manifest.json` 中应用版本名号。 |||||`uni-app (3.4.10+)`|
| |appLanguage |应用设置的语言|`en`、`zh-Hans`、`zh-Hant`、`fr`、`es`|`en`、`zh-Hans`、`zh-Hant`、`fr`、`es`|`en`、`zh-Hans`、`zh-Hant`、`fr`、`es`||`uni-app (3.4.13+)`|
|rom |romName |rom 名称|Android 部分机型获取不到值，[取值如下](#romname)。iOS 不支持|不支持|不支持| |`uni-app (3.4.13+)` |
| |romVersion |rom 版本|Android 部分机型获取不到值，[取值如下](#romname)。iOS 不支持|不支持|不支持| |`uni-app (3.4.13+)` |
|其他 |ua | userAgent标识 | | |不支持 | |`uni-app (3.4.10+)` |
| |screenWidth |屏幕宽度| | | | | |
| |screenHeight |屏幕高度 | | | | | |
| |windowWidth |可使用窗口宽度 | | | | | |
| |windowHeight |可使用窗口高度 | | | | | |
| |windowTop |可使用窗口的顶部位置 | | | | | |
| |windowBottom |可使用窗口的底部位置 | | | | | |
| |statusBarHeight |手机状态栏的高度| | | | | |
| |safeArea |在竖屏正方向下的安全区域|App、Web、微信小程序| | | | |
|rom |romName |rom 名称|Android 部分机型获取不到值，[取值如下](#romname)。iOS 不支持|不支持|不支持||`uni-app (3.4.13+)`|
| |romVersion |rom 版本|Android 部分机型获取不到值，[取值如下](#romname)。iOS 不支持|不支持|不支持||`uni-app (3.4.13+)`|
|其他 |ua| userAgent标识 |||不支持 ||`uni-app (3.4.10+)` |
| |screenWidth |屏幕宽度||||| |
| |screenHeight |屏幕高度 ||||| |
| |windowWidth |可使用窗口宽度 ||||| |
| |windowHeight |可使用窗口高度 ||||| |
| |windowTop |可使用窗口的顶部位置 ||||| |
| |windowBottom |可使用窗口的底部位置 ||||| |
| |statusBarHeight |手机状态栏的高度||||||
| |safeArea |在竖屏正方向下的安全区域|App、Web、微信小程序|||||
| |safeAreaInsets |在竖屏正方向下的安全区域插入位置（2.5.3+）|App、Web、微信小程序|||||
某些小程序特殊的返回参数
......@@ -95,7 +95,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|参数|说明|平台差异说明|
|:-|:-|:-|
|pixelRatio |设备像素比 | |
|pixelRatio |设备像素比 ||
|brand|设备品牌|App、微信小程序、百度小程序、字节跳动小程序、飞书小程序、QQ小程序|
|model|设备型号|全平台支持。Web 端部分设备无法获取具体型号|
|system|操作系统名称及版本，如Android 10||
......@@ -119,8 +119,8 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
**safeArea 的结构**
|参数 |类型 |说明 |
|:- |:- |:- |
|参数 |类型 |说明 |
|:- |:- |:- |
|left |Number |安全区域左上角横坐标 |
|right |Number |安全区域右下角横坐标 |
|top |Number |安全区域左上角纵坐标 |
......@@ -130,8 +130,8 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
**safeAreaInsets 的结构**
|参数 |类型 |说明 |
|:- |:- |:- |
|参数 |类型 |说明 |
|:- |:- |:- |
|left |Number |安全区域左侧插入位置 |
|right |Number |安全区域右侧插入位置 |
|top |Number |安全区顶部插入位置 |
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或