bl.getSystemInfoAsync
以 Promise 风格 调用:不支持
小程序插件:不支持
功能描述
异步获取系统信息。需要一定的bilibili客户端版本支持,在不支持的客户端上,会使用同步实现来返回。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.success 回调函数
参数
Object res
| 属性 | 类型 | 说明 | 最低版本 |
|---|---|---|---|
| brand | string | 设备品牌 | |
| model | string | 设备型号。新机型刚推出一段时间会显示unknown,bilibili会尽快进行适配。 | |
| pixelRatio | number | 设备像素比 | |
| screenWidth | number | 屏幕宽度,单位px | |
| screenHeight | number | 屏幕高度,单位px | |
| windowWidth | number | 可使用窗口宽度,单位px | |
| windowHeight | number | 可使用窗口高度,单位px | |
| statusBarHeight | number | 状态栏的高度,单位px | |
| language | string | bilibili设置的语言 | |
| version | string | bilibili版本号 | |
| system | string | 操作系统及版本 | |
| platform | string | 客户端平台 | |
| 合法值说明iosiOSbilibili(包含 iPhone、iPad)androidAndroidbilibiliohosHarmonyOSbilibiliwindowsWindowsbilibilimacmacOSbilibilidevtoolsbilibili开发者工具 | |||
| fontSizeSetting | number | 用户字体大小(单位px)。以bilibili客户端「我-设置-通用-字体大小」中的设置为准 | |
| SDKVersion | string | 客户端基础库版本 | |
| benchmarkLevel | number | 设备性能等级(仅 Android)。取值为:-2 或 0(该设备无法运行小游戏),-1(性能未知),>=1(设备性能值,该值越高,设备性能越好)注意:性能等级当前仅反馈真机机型,暂不支持 IDE 模拟器机型 | |
| albumAuthorized | boolean | 允许bilibili使用相册的开关(仅 iOS 有效) | |
| cameraAuthorized | boolean | 允许bilibili使用摄像头的开关 | |
| locationAuthorized | boolean | 允许bilibili使用定位的开关 | |
| microphoneAuthorized | boolean | 允许bilibili使用麦克风的开关 | |
| notificationAuthorized | boolean | 允许bilibili通知的开关 | |
| notificationAlertAuthorized | boolean | 允许bilibili通知带有提醒的开关(仅 iOS 有效) | |
| notificationBadgeAuthorized | boolean | 允许bilibili通知带有标记的开关(仅 iOS 有效) | |
| notificationSoundAuthorized | boolean | 允许bilibili通知带有声音的开关(仅 iOS 有效) | |
| phoneCalendarAuthorized | boolean | 允许bilibili使用日历的开关 | |
| bluetoothEnabled | boolean | 蓝牙的系统开关 | |
| locationEnabled | boolean | 地理位置的系统开关 | |
| wifiEnabled | boolean | Wi-Fi 的系统开关 | |
| safeArea | Object | 在竖屏正方向下的安全区域。部分机型没有安全区域概念,也不会返回 safeArea 字段,开发者需自行兼容。 | |
| 结构属性类型说明leftnumber安全区域左上角横坐标rightnumber安全区域右下角横坐标topnumber安全区域左上角纵坐标bottomnumber安全区域右下角纵坐标widthnumber安全区域的宽度,单位逻辑像素heightnumber安全区域的高度,单位逻辑像素 | |||
| locationReducedAccuracy | boolean | true 表示模糊定位,false 表示精确定位,仅 iOS 支持 | |
| theme | string | 系统当前主题,取值为light或dark,全局配置"darkmode":true时才能获取,否则为 undefined (不支持小游戏) | |
| 合法值说明dark深色主题light浅色主题 | |||
| host | Object | 当前小程序运行的宿主环境 | |
| 结构属性类型说明appIdstring宿主 app 对应的 appId | |||
| enableDebug | boolean | 是否已打开调试。可通过右上角菜单或bl.setEnableDebug打开调试。 | |
| deviceOrientation | string | 设备方向(注意:IOS客户端横屏游戏获取deviceOrientation可能不准,建议以屏幕宽高为准) | |
| 合法值说明portrait竖屏landscape横屏 |
示例代码
bl.getSystemInfoAsync({
success (res) {
console.log(res.model)
console.log(res.pixelRatio)
console.log(res.windowWidth)
console.log(res.windowHeight)
console.log(res.language)
console.log(res.version)
console.log(res.platform)
}
})