Appearance
qin.getSystemSetting
获取设备设置
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 抖音小程序 | 快手小程序 |
|---|---|---|---|---|
| x | 基础库 (2.20.1+) | x | x | x |
返回参数说明
| 属性 | 类型 | 说明 |
|---|---|---|
| bluetoothEnabled | boolean | 蓝牙的系统开关。当值为 false 时, App 端:有可能是配置不正确导致,此时会返回 bluetoothError 属性描述错误。 |
| bluetoothError | String | App 端: Android 平台没有权限或者 iOS 平台模块配置错误时返回字符串,否则不返回此属性。详情见下 |
| locationEnabled | boolean | 地理位置的系统开关。当值为 false 时, App 端:Android 平台是准确的; iOS 平台有可能是配置不正确导致,此时会返回 locationError 属性描述错误. |
| locationError | String | App 端: Android 平台不返回此属性; iOS 平台模块配置错误时返回字符串,否则不返回此属性。详情见下 |
| wifiEnabled | boolean | Wi-Fi 的系统开关 |
| wifiError | String | App 端: Android 平台没有权限时返回此属性; iOS 平台不返回此属性。详情见下 |
| deviceOrientation | string | 设备方向。竖屏: portrait,横屏: landscape |
注意
bluetoothError:- Android平台值为
"Missing permissions required by BluetoothAdapter.isEnabled: android.permission.BLUETOOTH"表示没有android.permission.BLUETOOTH权限 - iOS平台值为
"Missing bluetooth module in manifest.json",表示没有在manifest.json -> App模块配置中配置BlueTooth(低功耗蓝牙)模块
- Android平台值为
locationError:- Android平台不会返回此值;
- iOS平台值为
"Missing geolocation module in manifest.json"表示没有在manifest.json -> App模块配置中配置Geolocation(定位)模块
wifiError- Android平台值为
"Missing permissions required by WifiManager.isWifiEnabled: android.permission.ACCESS_WIFI_STATE"表示没有android.permission.ACCESS_WIFI_STATE权限 - iOS平台不会返回此值;
- Android平台值为
示例
js
const systemSetting = qin.getSystemSetting();
console.log(systemSetting.bluetoothEnabled);
console.log(systemSetting.deviceOrientation);
console.log(systemSetting.locationEnabled);
console.log(systemSetting.wifiEnabled);const systemSetting = qin.getSystemSetting();
console.log(systemSetting.bluetoothEnabled);
console.log(systemSetting.deviceOrientation);
console.log(systemSetting.locationEnabled);
console.log(systemSetting.wifiEnabled);