tap.getSystemInfo(Object object)

建议使用 tap.getSystemSetting、tap.getAppAuthorizeSetting、tap.getDeviceInfo、tap.getWindowInfo、tap.getAppBaseInfo 代替

以 Promise 风格调用：支持

功能描述

获取系统信息。由于历史原因，tap.getSystemInfo 是异步的调用格式，但是是同步返回，需要异步获取系统信息请使用 tap.getSystemInfoAsync。

参数

Object object

属性	类型	默认值	必填	说明
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

	属性	类型	说明
	brand	string	设备品牌
	model	string	设备型号。新机型刚推出一段时间会显示unknown， TapTap 会尽快进行适配。
	pixelRatio	number	设备像素比
	screenWidth	number	屏幕宽度，单位px
	screenHeight	number	屏幕高度，单位px
	windowWidth	number	可使用窗口宽度，单位px
	windowHeight	number	可使用窗口高度，单位px
	statusBarHeight	number	状态栏的高度，单位px
	language	string	TapTap 设置的语言
	version	string	TapTap 版本号
	system	string	操作系统及版本
	platform	string	客户端平台
	合法值 说明 ios iOS TapTap （包含 iPhone、iPad） android Android TapTap
	fontSizeSetting	number	注意： TapTap 不支持设置通用字体大小，返回固定值16
	SDKVersion	string	客户端基础库版本
	benchmarkLevel	number	设备性能等级，iOS返回固定值-1，Android返回固定值32
	albumAuthorized	boolean	允许 TapTap 使用相册的开关（仅 iOS 有效）
	cameraAuthorized	boolean	允许 TapTap 使用摄像头的开关
	locationAuthorized	boolean	允许 TapTap 使用定位的开关
	microphoneAuthorized	boolean	允许 TapTap 使用麦克风的开关
	notificationAuthorized	boolean	允许 TapTap 通知的开关
	notificationAlertAuthorized	boolean	允许 TapTap 通知带有提醒的开关（仅 iOS 有效）
	notificationBadgeAuthorized	boolean	允许 TapTap 通知带有标记的开关（仅 iOS 有效）
	notificationSoundAuthorized	boolean	允许 TapTap 通知带有声音的开关（仅 iOS 有效）
	phoneCalendarAuthorized	boolean	允许 TapTap 使用日历的开关
	blueToothAuthorized	boolean	允许 TapTap 使用蓝牙的开关
	bluetoothEnabled	boolean	蓝牙的系统开关
	locationEnabled	boolean	地理位置的系统开关
	wifiEnabled	boolean	Wi-Fi 的系统开关
	safeArea	Object	在竖屏正方向下的安全区域。部分机型没有安全区域概念，也不会返回 safeArea 字段，开发者需自行兼容。
	结构属性 类型 说明 left number 安全区域左上角横坐标 right number 安全区域右下角横坐标 top number 安全区域左上角纵坐标 bottom number 安全区域右下角纵坐标 width number 安全区域的宽度，单位逻辑像素 height number 安全区域的高度，单位逻辑像素
	locationReducedAccuracy	boolean	`true` 表示模糊定位，`false` 表示精确定位，仅 iOS 支持
	theme	string	系统当前主题，取值为`light`或`dark`，全局配置`"darkmode":true`时才能获取，否则为 undefined （不支持小游戏）
	合法值 说明 dark 深色主题 light 浅色主题
	host	Object	当前小游戏运行的宿主环境
	结构属性 类型 说明 appId string 宿主 app 对应的 appId
	enableDebug	boolean	是否已打开调试。可通过右上角菜单或 tap.setEnableDebug 打开调试。
	deviceOrientation	string	设备方向（注意：iOS客户端横屏游戏获取deviceOrientation可能不准，建议以屏幕宽高为准）
	合法值 说明 portrait 竖屏 landscape 横屏
	mode	string	注意：iOS中返回固定值default
	renderer	string	注意：iOS中返回固定值h5

示例代码

tap.getSystemInfo({
  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)
  }
})


try {
  const res = tap.getSystemInfoSync()
  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)
} catch (e) {
  // Do something when catch error
}

注意事项

• 当 tap.getSystemInfoSync() 接口发生错误时可能会返回空对象
• tap.getSystemInfo 接口由于会获取系统权限，可能触发授权弹窗，请使用 tap.getSystemSetting、tap.getAppAuthorizeSetting、tap.getDeviceInfo、tap.getWindowInfo、tap.getAppBaseInfo 替代