设备信息

      更新时间：

      接口声明

      { "name": "blueos.hardware.deviceInfo" }
      复制代码

      导入模块

      import device from '@blueos.hardware.deviceInfo' 或 const device = require('@blueos.hardware.deviceInfo')
      复制代码

      开发者需要在 manifest.json 里面配置权限：

      {
  "permissions": [{ "name": "watch.permission.DEVICE_INFO" }]
}
      复制代码

      接口定义

      device.getInfo(OBJECT)

      获取设备信息

      参数：

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      brand String 设备品牌
      manufacturer String 设备生产商
      model String 设备型号
      product String 设备代号
      osType String 操作系统名称
      osVersionName String 操作系统版本名称
      osVersionCode Integer 操作系统版本号
      platformVersionName String 运行平台版本名称
      platformVersionCode Integer 运行平台版本号
      language String 系统语言
      deviceName String 设备名称
      hardwareVersion String 硬件版本
      softwareVersion String 软件版本
      region String 系统地区
      screenWidth Integer 屏幕宽
      screenHeight Integer 屏幕高
      windowWidth Integer 可使用窗口宽度
      windowHeight Integer 可使用窗口高度
      statusBarHeight Integer 状态栏高度
      screenDensity Float 设备的屏幕密度
      vendorOsName String 系统的名称，如 BlueOS
      vendorOsVersion String 蓝河应用的版本号
      cutout Array 针对异形屏(比如刘海屏、水滴屏和开孔屏)返回异形区域的位置大小。Array 中每个 item 表示一个异形区域的描述。item 参数：
      left:cutout 左边界距离屏幕左边距离
      top:cutout 上边界距离屏幕上边距离
      right:cutout 右边界距离屏幕右边距离
      bottom:cutout 下边界距离屏幕下边距离
      cutout 的坐标描述以竖屏为基准。即在横屏和竖屏下获取的 cutout 参数描述都是一样的。
      deviceType String 当前蓝河应用引擎的设备类型，手表版为'watch'
      screenRefreshRate Float 获取屏幕显示刷新率(获取帧率可能不为 60, 90, 144 等标准帧率)

      示例：

      device.getInfo({
  success: function (ret) {
    console.log(`handling success， brand = ${ret.brand}`)
  },
})
      复制代码

      device.getInfoSync()

      同步获取设备信息

      参数

      无

      返回值

      参数值 类型 说明
      deviceInfo Object 当前设备信息,deviceInfo 参数信息如上 device.getInfo success 返回值

      示例

      const deviceInfo = device.getInfoSync()
      复制代码

      device.getRegionSync()

      同步获取设备地区信息

      参数

      无

      返回值

      类型 说明
      string CN 中国
      ID 印度尼西亚
      TH 泰国
      MY 马来西亚
      SG 新加坡
      PH 菲律宾
      ZA 南非
      CO 哥伦比亚
      TR 土耳其
      RU 俄罗斯

      示例

      const region = device.getRegionSync()
console.log("region is", region)
      复制代码

      device.getRegion()

      异步获取设备地区信息

      参数：

      属性 必填 类型 说明
      success 否 Function 成功回调
      fail 否 Function 失败回调

      success 返回值:

      类型 说明
      string CN 中国
      ID 印度尼西亚
      TH 泰国
      MY 马来西亚
      SG 新加坡
      PH 菲律宾
      ZA 南非
      CO 哥伦比亚
      TR 土耳其
      RU 俄罗斯

      示例：

      device.getRegion({
  success: function (region) {
    console.log("region is", region)
  },
})
      复制代码

      device.getPeerDeviceInfo(OBJECT)

      获取连接手机的信息

      参数：

      属性 必填 类型 说明
      success 否 Function 成功回调
      fail 否 Function 失败回调

      success 返回值:

      属性 类型 说明
      brand String 设备品牌
      osType String 操作系统名称

      fail 返回值:

      示例：

      device.getPeerDeviceInfo({
  success: function (ret) {
    console.log(`handling success， brand = ${ret.brand}`)
  },
})
      复制代码

      device.getId(OBJECT)

      批量获取设备标识

      权限要求

      获取手表状态

      参数：

      参数名 类型 必填 说明
      type Array 是 支持 device、mac、user、advertising 四种类型，可提供一至多个
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：

      按照传入的 type 返回对应的 id，未在 type 中出现的 id 类型不会返回

      参数名 类型 说明
      device String 设备唯一标识。
      mac String 设备的 mac 地址。
      user String 用户唯一标识。
      advertising String 广告唯一标识
      fail 返回错误代码
      错误码 说明
      400 拒绝授予权限
      402 权限错误（未声明该权限）

      示例：

      device.getId({
  type: ['device', 'mac'],
  success: function (data) {
    console.log(`handling success: ${data.device}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}, errorMsg=${data}`)
  },
})
      复制代码

      device.getDeviceId(OBJECT)

      获取设备唯一标识

      权限要求

      获取手表状态

      参数：

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      deviceId String 设备唯一标识。
      fail 返回错误代码
      错误码 说明
      400 拒绝授予权限
      402 权限错误（未声明该权限） 
      device.getDeviceId({
  success: function (data) {
    console.log(`handling success: ${data.deviceId}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.getSerial(OBJECT)

      获取设备序列号

      权限要求

      获取手表状态

      参数：

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      serial String 设备序列号 
      device.getSerial({
  success: function (data) {
    console.log(`handling success: ${data.serial}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.getTotalStorage(OBJECT)

      获取存储空间的总大小

      参数：

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      totalStorage Number 存储空间的总大小，单位是 Byte。 
      device.getTotalStorage({
  success: function (data) {
    console.log(`handling success: ${data.totalStorage}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.getAvailableStorage(OBJECT)

      获取存储空间的可用大小

      参数：

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      availableStorage Number 存储空间的可用大小，单位是 Byte。 
      device.getAvailableStorage({
  success: function (data) {
    console.log(`handling success: ${data.availableStorage}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.getDeviceICCID(OBJECT)

      获取卡识别码

      参数

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      iccid String 卡识别码 
      device.getDeviceICCID({
  success: function (data) {
    console.log(`handling success: ${data.iccid}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.getUserId(OBJECT)

      获取用户唯一标识

      参数

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      userId String 设备唯一标识。 
      device.getUserId({
  success: function (data) {
    console.log(`handling success: ${data.userId}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.getCpuInfo(OBJECT)

      返回 CPU 信息

      参数

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      参数值 类型 说明
      cpuInfo String CPU 信息。 
      device.getCpuInfo({
  success: function (data) {
    console.log(`handling success: ${data.cpuInfo}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
      复制代码

      device.isSupported(name: string)

      断硬件设备能力是否支持

      参数

      类型 必填 说明
      String 是 支持的硬件能力枚举，见下文【硬件设备能力枚举】
      返回值
      类型 说明
      Boolean 是否支持，true 支持，false 不支持
      示例
      const isSupported = device.isSupported('sys.modem.support')
      复制代码

      device.getFeatureList(OBJECT)

      获取全部硬件功能列表

      参数

      参数名 类型 必填 说明
      success Function 否 成功回调
      fail Function 否 失败回调
      complete Function 否 执行结束后的回调
      success 返回值：
      类型 说明
      Array<string> 获取全部硬件功能列表，见下文【硬件设备能力枚举】
      示例
      device.getFeatureList({
  success: function (data) {
    console.log(`handling success: ${data}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}, errorMsg=${data}`)
  },
})
      复制代码
      类型 说明
      Array<string> 硬件设备支持的功能列表

      硬件设备能力枚举

      枚举值 说明
      sys.modem.support modem 功能
      sys.sensor.ecg.support ecg 功能
      上一篇
      屏幕亮度
      下一篇
      基础软件能力
      以上内容对您是否有帮助？
      • 毫无帮助
      • 帮助不大
      • 一般
      • 很好
      • 非常好
      意见反馈