免费AI编程助手
百度智能小程序 获取系统信息同步接口
swan.getSystemInfoSync
Tip： 基础库 3.140.1 之前，无法判断接口是否调用失败；基础库 3.140.1 及以后，接口调用失败时会返回一个标准的Error对象，可通过instanceof来判断接口是否调用失败。
解释：获取系统信息同步接口
Web 态说明：由于浏览器的限制，在 Web 态下部分系统信息无法获取，详见下方 success 返回参数说明。
方法参数
无
同步返回参数说明
| 参数 | 参数类型 | 说明 | 最低版本 | Web 态说明 |
|---|---|---|---|---|
|
brand |
String |
手机品牌 |
- | |
|
model |
String |
手机型号 |
- | |
|
pixelRatio |
Number |
设备像素比 |
- | |
|
screenWidth |
Number |
屏幕宽度 |
- | |
|
screenHeight |
Number |
屏幕高度 |
- | |
|
windowWidth |
Number |
可使用窗口宽度 |
- | |
|
windowHeight |
Number |
可使用窗口高度 |
- | |
|
statusBarHeight |
Number |
状态栏的高度 |
- | |
|
navigationBarHeight |
Number |
导航栏的高度 |
3.0.17 |
- |
|
language |
String |
宿主 App 设置的语言 |
- | |
|
version |
String |
宿主 App 版本号 |
- | |
|
system |
String |
操作系统版本 |
- | |
|
platform |
String |
客户端平台，如：ios 。 |
- | |
|
fontSizeSetting |
Number |
用户字体大小设置，取值为 1、2、3、4，分别对应小、中、大、特大四种字体等级。 |
- | |
|
SDKVersion |
String |
客户端基础库版本 |
- | |
|
host |
String |
宿主平台，详见宿主平台枚举值列表 。 |
3.30.2 |
- |
|
cacheLocation |
Object |
上一次缓存的位置信息 |
安卓端最低基础库版本 3.40.4 ；ios 最低支持版本 3.70.2 。 |
暂不支持 |
|
swanNativeVersion |
String |
宿主平台版本号 |
最低支持版本 1.13.18 |
- |
|
devicePixelRatio |
Number |
屏幕密度 |
安卓最低支持基础库版本 3.0.39 ； ios 最低支持版本 3.0.39 。 |
- |
|
albumAuthorized |
Boolean |
允许宿主使用相册的开关（仅 iOS 有效） |
ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
notificationAuthorized |
Boolean |
允许宿主通知的开关 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
notificationAlertAuthorized |
Boolean |
允许宿主通知带有提醒的开关（仅 iOS 有效） |
ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
notificationBadgeAuthorized |
Boolean |
允许宿主通知带有标记的开关（仅 iOS 有效） |
ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
notificationSoundAuthorized |
Boolean |
允许宿主通知带有声音的开关（仅 iOS 有效） |
ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
cameraAuthorized |
Boolean |
允许宿主使用摄像头的开关 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
locationAuthorized |
Boolean |
允许宿主使用定位的开关 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
microphoneAuthorized |
Boolean |
允许宿主使用麦克风的开关 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
locationEnabled |
Boolean |
地理位置的系统开关 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
wifiEnabled |
Boolean |
Wi-Fi 的系统开关 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
|
safeArea |
Object |
在竖屏正方向下的安全区域 |
安卓最低支持基础库版本 3.110.3 ； ios 最低支持版本 3.110.3 ； 开发者工具暂不支持。 |
暂不支持 |
示例
图片示例
代码示例
// 完整代码请点击上方 "在开发者工具中打开" 预览
let res = swan.getSystemInfoSync();
// 基础库 3.140.1 之前，无法判断接口是否调用失败
// 基础库 3.140.1 及以后，通过 instanceof 来判断接口是否调用失败
if (!(res instanceof Error)) {
console.log('getSystemInfoSync success', res);
}
else {
console.log('getSystemInfoSync fail', res.message);
}
Bug & Tip
- Tip： 基础库 3.140.1 之前，无法判断接口是否调用失败；基础库 3.140.1 及以后，接口调用失败时会返回一个标准的
Error对象，可通过instanceof来判断接口是否调用失败。
错误码
Android
| 错误码 | 说明 |
|---|---|
|
202 |
解析失败，请检查参数是否正确。 |
更多建议：