# 设备

# 获取手机基础信息

# 使用说明

Android	iOS	PC	是否需要鉴权
支持	支持	不支持	不需要

// 全量引入调用方式
yy.device.base.getPhoneInfo({
  onSuccess: function (data) {
    /*
      {
        screenWidth: 1080, // 手机屏幕宽度
        screenHeight: 1920, // 手机屏幕高度
        brand:'Mi'， // 手机品牌
        model:'Note4', // 手机型号
        version:'7.0'. // 版本
        netInfo:'wifi' , // 网络类型 wifi／4g／3g
        operatorType :'xx' // 运营商信息
      }
      */
  },
  onFail: function (err) {}
});

// 按需加载调用方式，参数与全量引入相同
getPhoneInfo({...});

# 参数说明

无

# 返回说明

返回值	参数类型	说明
screenWidth	Number	手机屏幕宽度
screenHeight	Number	手机屏幕高度
brand	String	手机品牌
model	String	手机型号
version	String	版本
netInfo	String	网络类型: wifi、2g、3g、4g、unknown、none，none 表示离线
operatorType	String	运营商信息

# 调试

device.base.getPhoneInfo

# 获取 uuid

# 使用说明

Android	iOS	PC v4.1.34	是否需要鉴权
支持	支持	支持	是

// 全量引入调用方式
yy.device.base.getUUID({
  onSuccess: function (data) {
    /*
      {
          uuid: 'ertyuiorty', // 通用唯一识别码
      }
      */
  },
  onFail: function (err) {}
});

// 按需加载调用方式，参数与全量引入相同
getUUID({...});

# 参数说明

无

# 返回说明

返回值	参数类型	说明
uuid	String	通用唯一识别码

# 调试

device.base.getUUID

# 检测计步权限 v4.0.0

# 使用说明

Android	iOS	PC	是否需要鉴权
支持	支持	不支持	是

// 全量引入调用方式
yy.device.base.checkStepPermission({
  onSuccess: function () {
    // 成功后可调用获取步数接口
  },
  onFail: function (err) {
    // 失败可输出错误日志
  }
});

// 按需加载调用方式，参数与全量引入相同
checkStepPermission({...});

# 参数说明

参数	参数类型	必传	说明
appid	number	是	企业 ID

# 返回说明

无

# 调试

device.base.checkStepPermission

# 手机震动

# 使用说明

Android	iOS	PC	是否需要鉴权
支持	支持	不支持	否

// 全量引入调用方式
yy.device.notification.vibrate({
  duration: 300,
  onSuccess: function (result) {
    /*
      {}
      */
  },
  onFail: function (err) {},
});

// 按需加载调用方式，参数与全量引入相同
vibrate({...});

# 参数说明

参数	参数类型	必传	说明
duration	Number	否	震动时间，仅支持 Android 端配置

# 返回说明

无

# 调试

device.notification.vibrate

# 调节亮度

# 使用说明

启动调节亮度。

Android	iOS	PC	是否需要鉴权
支持	支持	不支持	否

// 全量引入调用方式
yy.device.system.setLight({
  onSuccess: function (result) {},
  onFail: function (err) {},
});

// 按需加载调用方式，参数与全量引入相同
setLight({...});

# 参数说明

参数	参数类型	必须	说明
light	float	是	屏幕亮度值：范围[0, 1]，精确到小数点后 3 位；0 最暗，1 最亮。

# 返回说明

无

# 调试

device.system.setLight

← 会话 IOS 控件 →