uni.getSystemSetting()

获取设备设置

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序、飞书小程序	钉钉小程序	QQ小程序	快手小程序	京东小程序	元服务
HBuilderX (3.5.2+)	x	基础库 (2.20.1+)	x	x	x	x	x	x	x	x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.31

返回参数说明

属性	类型	说明
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

返回值 HarmonyOS Next 兼容性

类型
GetSystemSettingResult
名称 HarmonyOS Next 兼容性 bluetoothEnabled HBuilderX 4.25 bluetoothError HBuilderX 4.25 locationEnabled HBuilderX 4.25 wifiEnabled HBuilderX 4.25 wifiError HBuilderX 4.25 deviceOrientation HBuilderX 4.25

Tips

• 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(低功耗蓝牙) 模块
• 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平台不会返回此值；

示例

const systemSetting = uni.getSystemSetting()

console.log(systemSetting.bluetoothEnabled)
console.log(systemSetting.deviceOrientation)
console.log(systemSetting.locationEnabled)
console.log(systemSetting.wifiEnabled)