docs: 更新获取系统信息相关文档

fsinbad · Aug 22, 2019 · b7e587e · b7e587e
1 parent 3a9ad94
commit b7e587e
Showing 1 changed file with 82 additions and 39 deletions.
diff --git a/docs/api/system/info.md b/docs/api/system/info.md
@@ -13,7 +13,7 @@
 
 |参数|说明|平台差异说明|
 |:-|:-|:-|
-|brand|手机品牌|微信小程序|
+|brand|手机品牌|微信小程序、百度小程序、头条小程序、QQ小程序|
 |model|手机型号||
 |pixelRatio|设备像素比||
 |screenWidth|屏幕宽度||
@@ -22,30 +22,51 @@
 |windowHeight|可使用窗口高度||
 |windowTop|可使用窗口的顶部位置|5+App、H5|
 |windowBottom|可使用窗口的底部位置|5+App、H5|
-|statusBarHeight|状态栏的高度||
-|language|应用设置的语言||
-|version|引擎版本号|微信小程序、5+App|
+|statusBarHeight|状态栏的高度|头条小程序不支持|
+|navigationBarHeight|导航栏的高度|百度小程序|
+|titleBarHeight|标题栏高度|支付宝小程序|
+|language|应用设置的语言|头条小程序不支持|
+|version|引擎版本号|H5不支持|
+|storage|设备磁盘容量|支付宝小程序|
+|currentBattery|当前电量百分比|支付宝小程序|
+|appName|宿主APP名称|头条小程序|
+|AppPlatform|App平台|QQ小程序|
+|host|宿主平台|百度小程序|
+|app|当前运行的客户端|支付宝小程序|
+|cacheLocation|上一次缓存的位置信息|百度小程序|
 |system|操作系统版本||
 |platform|客户端平台，值域为：`ios`、`android`||
-|fontSizeSetting|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px|微信小程序|
-|SDKVersion|客户端基础库版本|微信小程序、5+App|
-|safeArea|在竖屏正方向下的安全区域|微信小程序|
+|fontSizeSetting|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px|微信小程序、支付宝小程序、百度小程序、QQ小程序|
+|SDKVersion|客户端基础库版本|支付宝小程序和H5不支持|
+|swanNativeVersion|宿主平台版本号|百度小程序|
+|albumAuthorized	|	允许微信使用相册的开关（仅 iOS 有效）	|微信小程序|
+|cameraAuthorized	|	允许微信使用摄像头的开关	|微信小程序|
+|locationAuthorized	|	允许微信使用定位的开关	|微信小程序|
+|microphoneAuthorized	|	允许微信使用麦克风的开关	|微信小程序|
+|notificationAuthorized	|	允许微信通知的开关	|微信小程序|
+|notificationAlertAuthorized	|	允许微信通知带有提醒的开关（仅 iOS 有效）	|微信小程序|
+|notificationBadgeAuthorized	|	允许微信通知带有标记的开关（仅 iOS 有效）	|微信小程序|
+|notificationSoundAuthorized	|	允许微信通知带有声音的开关（仅 iOS 有效）	|微信小程序|
+|bluetoothEnabled	|	蓝牙的系统开关	|微信小程序|
+|locationEnabled	|	地理位置的系统开关	|微信小程序|
+|wifiEnabled	|	Wi-Fi 的系统开关	|微信小程序|
+|safeArea|在竖屏正方向下的安全区域|5+App、H5、微信小程序|
 
 **Tips**
 - 屏幕高度=状态栏高度+原生导航栏高度+可使用窗口高度+原生tabbar高度
-- H5端，windowHeight不包含NavigationBar和TabBar的高度，windowTop等于NavigationBar高度，windowBottom等于TabBar高度，statusBarHeight为0
+- H5端，windowHeight不包含NavigationBar和TabBar的高度，windowTop等于NavigationBar高度，windowBottom等于TabBar高度，statusBarHeight为0
+
+**safeArea 的结构**
 
-**safeArea 的结构**
-
 |参数	|类型	|说明							|
-|:-		|:-								|
-|left	|Number	|安全区域左上角横坐标			|
-|right	|Number	|安全区域右下角横坐标			|
-|top	|Number	|安全区域左上角纵坐标			|
-|bottom	|Number	|安全区域右下角纵坐标			|
-|width	|Number	|安全区域的宽度，单位逻辑像素	|
+|:-		|:-								|:-								|
+|left	|Number	|安全区域左上角横坐标			|
+|right	|Number	|安全区域右下角横坐标			|
+|top	|Number	|安全区域左上角纵坐标			|
+|bottom	|Number	|安全区域右下角纵坐标			|
+|width	|Number	|安全区域的宽度，单位逻辑像素	|
 |height	|Number	|安全区域的高度，单位逻辑像素	|
-
+
 
 **示例**
 
@@ -70,7 +91,7 @@ uni.getSystemInfo({
 
 |参数|说明|平台差异说明|
 |:-|:-|:-|
-|brand|手机品牌|微信小程序、百度小程序|
+|brand|手机品牌|微信小程序、百度小程序、头条小程序、QQ小程序|
 |model|手机型号||
 |pixelRatio|设备像素比||
 |screenWidth|屏幕宽度||
@@ -79,28 +100,50 @@ uni.getSystemInfo({
 |windowHeight|可使用窗口高度||
 |windowTop|可使用窗口的顶部位置|5+App、H5|
 |windowBottom|可使用窗口的底部位置|5+App、H5|
-|statusBarHeight|状态栏的高度|5+App、微信小程序、百度小程序|
-|language|应用设置的语言|5+App、微信小程序、支付宝小程序、百度小程序|
-|version|引擎版本号|5+App、微信小程序|
+|statusBarHeight|状态栏的高度|头条小程序不支持|
+|navigationBarHeight|导航栏的高度|百度小程序|
+|titleBarHeight|标题栏高度|支付宝小程序|
+|language|应用设置的语言|头条小程序不支持|
+|version|引擎版本号|H5不支持|
+|storage|设备磁盘容量|支付宝小程序|
+|currentBattery|当前电量百分比|支付宝小程序|
+|appName|宿主APP名称|头条小程序|
+|AppPlatform|App平台|QQ小程序|
+|host|宿主平台|百度小程序|
+|app|当前运行的客户端|支付宝小程序|
+|cacheLocation|上一次缓存的位置信息|百度小程序|
 |system|操作系统版本||
-|platform|客户端平台||
-|fontSizeSetting|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px|微信小程序、支付宝小程序、百度小程序|
-|SDKVersion|客户端基础库版本|5+App、微信小程序、百度小程序、头条小程序|
-|safeArea|在竖屏正方向下的安全区域|微信小程序|
+|platform|客户端平台，值域为：`ios`、`android`||
+|fontSizeSetting|用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px|微信小程序、支付宝小程序、百度小程序、QQ小程序|
+|SDKVersion|客户端基础库版本|支付宝小程序和H5不支持|
+|swanNativeVersion|宿主平台版本号|百度小程序|
+|albumAuthorized	|	允许微信使用相册的开关（仅 iOS 有效）	|微信小程序|
+|cameraAuthorized	|	允许微信使用摄像头的开关	|微信小程序|
+|locationAuthorized	|	允许微信使用定位的开关	|微信小程序|
+|microphoneAuthorized	|	允许微信使用麦克风的开关	|微信小程序|
+|notificationAuthorized	|	允许微信通知的开关	|微信小程序|
+|notificationAlertAuthorized	|	允许微信通知带有提醒的开关（仅 iOS 有效）	|微信小程序|
+|notificationBadgeAuthorized	|	允许微信通知带有标记的开关（仅 iOS 有效）	|微信小程序|
+|notificationSoundAuthorized	|	允许微信通知带有声音的开关（仅 iOS 有效）	|微信小程序|
+|bluetoothEnabled	|	蓝牙的系统开关	|微信小程序|
+|locationEnabled	|	地理位置的系统开关	|微信小程序|
+|wifiEnabled	|	Wi-Fi 的系统开关	|微信小程序|
+|safeArea|在竖屏正方向下的安全区域|5+App、H5、微信小程序|
+
 **Tips**
-- 使用注意同上getSystemInfo
+- 使用注意同上getSystemInfo
+
+**safeArea 的结构**
 
-**safeArea 的结构**
-
 |参数	|类型	|说明							|
-|:-		|:-								|
-|left	|Number	|安全区域左上角横坐标			|
-|right	|Number	|安全区域右下角横坐标			|
-|top	|Number	|安全区域左上角纵坐标			|
-|bottom	|Number	|安全区域右下角纵坐标			|
-|width	|Number	|安全区域的宽度，单位逻辑像素	|
-|height	|Number	|安全区域的高度，单位逻辑像素	|
-
+|:-		|:-								|:-								|
+|left	|Number	|安全区域左上角横坐标			|
+|right	|Number	|安全区域右下角横坐标			|
+|top	|Number	|安全区域左上角纵坐标			|
+|bottom	|Number	|安全区域右下角纵坐标			|
+|width	|Number	|安全区域的宽度，单位逻辑像素	|
+|height	|Number	|安全区域的高度，单位逻辑像素	|
+
 
 **示例**
 
@@ -137,9 +180,9 @@ Android已经改进用户隐私保护，在很多新手机上，获取imei等信
 
 平台差异说明
 
-|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|
-|:-:|:-:|:-:|:-:|:-:|:-:|
-|√|x|√|√|√|√|
+|5+App|H5|微信小程序|支付宝小程序|百度小程序|头条小程序|QQ程序|
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+|√|x|√|√|√|√|√|
 
 **String 参数说明**