Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
suncj1314
unidocs-zh
提交
48243337
U
unidocs-zh
项目概览
suncj1314
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
48243337
编写于
6月 05, 2022
作者:
DCloud_Heavensoft
提交者:
Gitee
6月 05, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs/api/system/info.md.
上级
368c1160
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
36 addition
and
25 deletion
+36
-25
docs/api/system/info.md
docs/api/system/info.md
+36
-25
未找到文件。
docs/api/system/info.md
浏览文件 @
48243337
...
...
@@ -47,7 +47,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
| |hostLanguage |宿主语言|仅 UniMPSDK 支持 |不支持|小程序宿主语言||uni-app 3.4.10+|
| |hostTheme |宿主主题|
`light`
、
`dark`
。仅 UniMPSDK 支持 |不支持|
`light`
、
`dark`
。前提是微信小程序全局配置"darkmode":true时才能获取||uni-app 3.4.10+|
| |hostFontSizeSetting |用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位:px|不支持|不支持|微信小程序、支付宝小程序、百度小程序、QQ小程序、字节小程序(2.53.0+)||uni-app 3.4.13+|
| |hostPackageName |小程序宿主包名
。仅 App 支持
|仅 UniMPSDK 支持 |不支持|不支持||uni-app 3.4.10+|
| |hostPackageName |小程序宿主包名|仅 UniMPSDK 支持 |不支持|不支持||uni-app 3.4.10+|
| |hostSDKVersion |uni小程序SDK版本、小程序客户端基础库版本|仅 UniMPSDK 支持 |不支持|||uni-app 3.4.13+|
|uni-app框架 |uniPlatform |uni-app 运行平台,与条件编译平台相同。
[
详见
](
#uniplatform
)
|app|
`web`
或
`h5`
|各家小程序,如
`mp-weixin`
||uni-app 3.4.10+|
| |uniCompileVersion |uni 编译器版本号。
[
详见
](
#uniplatform
)
|
`3.4.10`
、
`3.2.9`
等|
`3.4.10`
、
`3.2.9`
等|
`3.4.10`
、
`3.2.9`
等||uni-app 3.4.10+|
...
...
@@ -110,7 +110,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|fontSizeSetting|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准,单位:px|微信小程序、支付宝小程序、百度小程序、QQ小程序、字节小程序(2.53.0+)|
#### uniPlatform
取值
@uniplatform
#### uniPlatform
返回值说明
@uniplatform
|值|生效条件|
|:-|:-|
...
...
@@ -129,7 +129,31 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|quickapp-webview-union|快应用联盟|
|quickapp-webview-huawei|快应用华为|
#### hostName 取值 @hostname
`uniCompileVersion`
编译器版本 和
`uniRuntimeVersion`
运行时版本,正常情况应该是一样的值,即uni-app的版本。
如果使用HBuilder自带的uni-app开发,该值即等同于HBuilder的版本;如果使用单独的uni-app cli开发,则等同于cli版本。
但在App平台,
`uniCompileVersion`
和
`uniRuntimeVersion`
在某些情况的值会不一样:
-
App云打包选择了不匹配的打包机版本,比如HBuilder版本较老,云端已经没有对应打包机,此时打包后
`uniCompileVersion`
会小于
`uniRuntimeVersion`
-
App离线打包,使用了不匹配的离线SDK
-
App wgt升级,即手机上安装的App是老版的
`uniRuntimeVersion`
,wgt的新版使用了不同版本的HBuilder或uni-app cli版本,并且实施了应用资源升级
#### romName 返回值说明 @romname
|值|解释|
|:-|:-|
|MIUI|小米|
|EMUI|华为|
|HarmonyOS|华为鸿蒙|
|Magic OS|荣耀|
|ColorOS|oppo|
|Funtouch OS|vivo|
|FLymeOS|魅族|
|SmartisanOS|锤子|
注意:不同rom的版本号规则不同,比如
`MIUI`
版本号是
`V130`
,而
`HarmonyOS`
的版本号是
`2.0.0`
#### hostName 返回值说明 @hostname
|值|解释|
|:-|:-|
...
...
@@ -147,22 +171,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|qq|QQ|
|KUAISHOU|快手|
#### romName 取值 @romname
|值|解释|
|:-|:-|
|MIUI|小米|
|EMUI|华为|
|HarmonyOS|华为鸿蒙|
|Magic OS|荣耀|
|ColorOS|oppo|
|Funtouch OS|vivo|
|FLymeOS|魅族|
|SmartisanOS|锤子|
注意:不同rom的版本号规则不同,比如
`MIUI`
版本号是
`V130`
,而
`HarmonyOS`
的版本号是
`2.0.0`
#### safeArea 的结构 @safearea
#### safeArea 返回值说明 @safearea
|参数 |类型 |说明 |
|:- |:- |:- |
...
...
@@ -182,8 +191,7 @@ uni-app提供了同步(`uni.getSystemInfo`)和异步(`uni.getSystemInfoSync`)的
|top |Number |安全区顶部插入位置 |
|bottom |Number |安全区域底部插入位置 |
#### language说明
#### language 返回值说明
language的国际规范是
`BCP47规范`
,分为三段,主语言-次语言-地区。例如
`zh-Hans-CN`
,表示 中文-简体-中国大陆
...
...
@@ -195,7 +203,7 @@ language的国际规范是`BCP47规范`,分为三段,主语言-次语言-地
所以获取语言后,不能直接字符串比较,需要拆段比较,npm上也有专门做
`BCP47语言规范`
比较的库。
#### deviceId说明
#### deviceId
返回值
说明
Web、小程序、iOS,属于对用户隐私保护比较严格的平台,在这些平台很难获取有效的设备唯一标记。
...
...
@@ -212,7 +220,7 @@ deviceId,在`app-android`平台,会根据优先使用imei、mac(仅在用
app下需要广告追踪的场景,在iOS上可以使用
[
idfa
](
https://ask.dcloud.net.cn/article/36107
)
、部分国产Android手机可以使用
[
OAID
](
http://www.html5plus.org/doc/zh_cn/device.html#plus.device.getOAID
)
####
Tips
@tips
####
其他注意
@tips
-
`deviceType`
:
-
`app-ios`
只支持
`phone`
、
`pad`
。
-
`app-android`
支持
`phone`
、
`pad`
、
`tv`
、
`car`
、
`watch`
、
`vr`
、
`appliance`
、
`undefined`
、
`unknown`
,关于各个类型的更详细解释参考
[
Android官方文档
](
https://developer.android.com/guide/
)
。
...
...
@@ -252,7 +260,7 @@ uni.getSystemInfo({
});
```
在不同平台 getSystemInfo 的返回值
在不同平台 getSystemInfo 的返回值
(表格较长,可缩放页面后拖动横向滚动条)
> 标明 `-` 的都为 undefined,其他值都与所列出项相同
...
...
@@ -291,4 +299,7 @@ uni.getSystemInfo({
### uni.getSystemInfoSync()
获取系统信息的同步接口。
`调用方式和返回值同上getSystemInfo`
。
获取系统信息的同步接口。
`调用参数和返回值同上getSystemInfo`
。
> 设备信息内容多且复杂,欢迎开发者测试更多环境设备并编辑本文档参与贡献。
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录