uni.getSystemSetting()

获取设备设置

平台差异说明

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

getSystemSetting 兼容性

HarmonyOS
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

返回值

类型
GetSystemSettingResult
名称 类型 必填 默认值 兼容性 描述 bluetoothEnabled boolean 否 - HarmonyOS HBuilderX 4.25 蓝牙是否开启 bluetoothError string 否 - HarmonyOS HBuilderX 4.25 蓝牙的报错信息 locationEnabled boolean 是 - HarmonyOS HBuilderX 4.25 位置是否开启 wifiEnabled boolean 否 - HarmonyOS HBuilderX 4.25 wifi是否开启 wifiError string 否 - HarmonyOS HBuilderX 4.25 wifi的报错信息 deviceOrientation string 是 - HarmonyOS 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)