Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
bb825981
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3216
Star
106
Fork
815
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
94
列表
看板
标记
里程碑
合并请求
70
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
94
Issue
94
列表
看板
标记
里程碑
合并请求
70
合并请求
70
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
bb825981
编写于
5月 31, 2022
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
chore: getSystemInfo、getAppBaseInfo、getDeviceInfo
上级
3f96f13f
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
27 addition
and
26 deletion
+27
-26
docs/api/system/getAppBaseInfo.md
docs/api/system/getAppBaseInfo.md
+6
-6
docs/api/system/getDeviceInfo.md
docs/api/system/getDeviceInfo.md
+6
-3
docs/api/system/info.md
docs/api/system/info.md
+15
-17
未找到文件。
docs/api/system/getAppBaseInfo.md
浏览文件 @
bb825981
...
...
@@ -15,18 +15,18 @@
|appVersion|string|
`manifest.json`
中应用版本名称。||
|appVersionCode|string|
`manifest.json`
中应用版本名号。||
|appLanguage|string|应用设置的语言
`en`
、
`zh-Hans`
、
`zh-Hant`
、
`fr`
、
`es`
|
`App`
、
`H5`
|
|hostLanguage|string|
浏览器语言、小程序宿主语言|
`App 仅 UNIMPSDK
支持`
|
|hostVersion|string|App、小程序宿主版本。如:微信版本号
。Web 端为浏览器版本|
`App 仅 UNIMPSDK
支持`
|
|hostName|string|
浏览器名称、小程序宿主名称|
`App 仅 UNIMPSDK
支持`
|
|hostLanguage|string|
小程序宿主语言|
`App 仅 UNIMPSDK 支持`
、
`H5 不
支持`
|
|hostVersion|string|App、小程序宿主版本。如:微信版本号
|
`App 仅 UNIMPSDK 支持`
、
`H5 不
支持`
|
|hostName|string|
小程序宿主名称|
`App 仅 UNIMPSDK 支持`
、
`H5 不
支持`
|
|hostPackageName|string|小程序宿主包名|
`仅 UNIMPSDK 支持`
|
|hostFontSizeSetting|string|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位:px|
`仅 UNIMPSDK 支持`
|
|hostSDKVersion|string|uni小程序SDK版本、小程序客户端基础库版本|
`App 仅 UNIMPSDK 支持`
、
`H5 不支持`
|
|hostTheme|string|系统当前主题,取值为light或dark。微信小程序全局配置"darkmode":true时才能获取,否则为 undefined (不支持小游戏)|
`App 仅 UNIMPSDK 支持`
、
`H5 不支持`
|
|hostFontSizeSetting|string|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位:px|
`仅 小程序 支持`
|
小程序特殊的返回参数
|参数名|类型|说明|平台差异说明|
|:-|:-|:-|:-|
|hostSDKVersion|string|客户端基础库版本|
`仅微信小程序`
|
|hostTheme|string|系统当前主题,取值为light或dark,全局配置"darkmode":true时才能获取,否则为 undefined (不支持小游戏)|
`仅微信小程序`
|
|SDKVersion|string|客户端基础库版本|
`仅微信小程序`
|
|enableDebug|boolean|是否已打开调试。可通过右上角菜单或 wx.setEnableDebug 打开调试|
`仅微信小程序`
|
|host|Object|当前小程序运行的宿主环境|
`仅微信小程序`
|
...
...
docs/api/system/getDeviceInfo.md
浏览文件 @
bb825981
...
...
@@ -10,7 +10,7 @@
|参数名|类型|说明|平台差异说明|
|:-|:-|:-|:-|
|deviceBrand|string|设备品牌。如:
`apple`
、
`huawei`
||
|deviceBrand|string|设备品牌。如:
`apple`
、
`huawei`
|
`H5 不支持`
|
|deviceId|string|设备 id 。由 uni-app 框架生成并存储,清空 Storage 会导致改变||
|deviceModel|string|设备型号||
|deviceType|string|设备类型
`phone`
、
`pad`
、
`pc`
||
...
...
@@ -30,5 +30,8 @@
|参数名|类型|说明|平台差异说明|
|:-|:-|:-|:-|
|brand|string|设备品牌||
|model|string|设备型号。新机型刚推出一段时间会显示unknown,微信会尽快进行适配。||
\ No newline at end of file
|brand|string|设备品牌|
`H5 不支持`
|
|model|string|设备型号。新机型刚推出一段时间会显示unknown,微信会尽快进行适配。||
**Tips**
-
`deviceId`
:
`android 平台`
根据优先使用imei、mac,如果没有获取到就使用随机生成的标识。
`ios 平台`
是直接使用随机生成的标识
\ No newline at end of file
docs/api/system/info.md
浏览文件 @
bb825981
...
...
@@ -29,7 +29,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|:- |:- |:- |:- |:- |:- |:- |:- |
|device |deviceId |设备 id 。由 uni-app 框架生成并存储,清空 Storage 会导致改变 | | | | | |
| |deviceType |设备类型 |
`phone`
、
`pad`
、
`pc`
|
`phone`
、
`pad`
、
`pc`
|
`phone`
、
`pad`
、
`pc`
| |
`uni-app (3.4.10+)`
|
| |deviceBrand |设备品牌。如:
`apple`
、
`huawei`
| |
部分设备无法获取
| | |
`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+)`
|
...
...
@@ -39,23 +39,23 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
| |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`
。Web 端为浏览器名称 |仅UniMPSDK 支持 |浏览器名称
|
[
取值如下
](
#hostname
)
|微信小程序真机运行才有真值|
`uni-app (3.4.10+)`
|
| |hostVersion |App、小程序宿主版本。如:微信版本号
。Web 端为浏览器版本|仅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 |
客户端基础库版本|仅
UniMPSDK 支持 |不支持|| |
`uni-app (3.4.13+)`
|
|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+)`
|
| |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+)`
|
| |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`
|
不支持
||
`uni-app (3.4.13+)`
|
|rom |romName |rom 名称|Android 部分机型获取不到值,
[
取值如下
](
#romname
)
。iOS
恒为
`ios`
|不支持|不支持| |
`uni-app (3.4.13+)`
|
| |romVersion |rom 版本|Android 部分机型获取不到值,
[
取值如下
](
#romname
)
。iOS
恒为
`ios 版本号`
|不支持|不支持| |
`uni-app (3.4.13+)`
|
| |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 |屏幕高度 | | | | | |
...
...
@@ -114,6 +114,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
-
Web端,windowTop等于NavigationBar高度,windowBottom等于TabBar高度
-
App端,windowTop等于透明状态NavigationBar高度,windowBottom等于透明状态TabBar高度
-
高度相关信息,要放在 onReady 里获取
-
`deviceId`
:
`android 平台`
根据优先使用imei、mac,如果没有获取到就使用随机生成的标识。
`ios 平台`
是直接使用随机生成的标识
**safeArea 的结构**
...
...
@@ -135,8 +136,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|top |Number |安全区顶部插入位置 |
|bottom |Number |安全区域底部插入位置 |
<a
id=
"uniplatform"
style=
"padding-top:6rem;"
></a>
<b
style=
"color:#268BD2"
>
uniPlatform
</b>
**可取值如下:**
#### uniPlatform 取值 @uniplatform
|值|生效条件|
|:-|:-|
...
...
@@ -155,8 +155,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|quickapp-webview-union|快应用联盟|
|quickapp-webview-huawei|快应用华为|
<a
id=
"hostname"
style=
"padding-top:6rem;"
></a>
<b
style=
"color:#268BD2"
>
hostName
</b>
**可取值如下:**
#### hostName 取值 @hostname
|值|生效条件|
|:-|:-|
...
...
@@ -174,8 +173,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|
[
字节宿主平台枚举值列表
](
https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/device/system-information/tt-get-system-info/#appname-%E8%AF%B4%E6%98%8E
)
|字节跳动系列|
|KUAISHOU|快手|
<a
id=
"romname"
style=
"padding-top:6rem;"
></a>
<b
style=
"color:#268BD2"
>
romName
</b>
**可取值如下:**
#### romName 取值 @romname
|值|生效条件|
|:-|:-|
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录