快應用 設備信息

2020-08-10 15:12 更新

接口聲明

{"name": "system.device"}

導入模塊

import device from '@system.device' 
或 
const device = require('@system.device')

接口定義

device.getInfo(OBJECT)

獲取設備信息

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
brand String 設備品牌
manufacturer String 設備生產商
model String 設備型號
product String 設備代號
osType String 操作系統(tǒng)名稱
osVersionName String 操作系統(tǒng)版本名稱
osVersionCode Integer 操作系統(tǒng)版本號
platformVersionName String 運行平臺版本名稱
platformVersionCode Integer 運行平臺版本號
language String 系統(tǒng)語言
region String 系統(tǒng)地區(qū)
screenWidth Integer 屏幕寬
screenHeight Integer 屏幕高

示例:

device.getInfo({
  success: function (ret) {
    console.log(`handling success, brand = ${ret.brand}`)
  }
})

device.getId(OBJECT)

批量獲取設備標識,需要用戶授權

權限要求

獲取手機狀態(tài)

后臺運行限制

無限制。后臺運行詳細用法參見后臺運行 腳本。

參數:

參數名 類型 必填 說明
type Array 支持device、mac、user、advertising 1000+四種類型,可提供一至多個
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:

按照傳入的type返回對應的id,未在type中出現的id類型不會返回

參數名 類型 說明
device String 設備唯一標識。在Android上返回IMEI或MEID
mac String 設備的mac地址。在Android M及以上返回固定值:02:00:00:00:00:00
user String 用戶唯一標識。在Android上返回androidid
advertising 1000+ String 廣告唯一標識
fail返回錯誤代碼
錯誤碼 說明
201 用戶拒絕授權

示例:

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

device.getDeviceId(OBJECT) 1000+

獲取設備唯一標識。需要用戶授權

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
deviceId String 設備唯一標識。在Android上返回IMEI或MEID
fail返回錯誤代碼
錯誤碼 說明
201 用戶拒絕授權
device.getDeviceId({
  success: function(data) {
    console.log(`handling success: ${data.deviceId}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getUserId(OBJECT) 1000+

獲取用戶唯一標識

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
userId String 設備唯一標識。在Android上返回androidid
device.getUserId({
  success: function (data) {
    console.log(`handling success: ${data.userId}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getAdvertisingId(OBJECT) 1000+

獲取廣告唯一標識

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
advertisingId String 廣告唯一標識
device.getAdvertisingId({
  success: function (data) {
    console.log(`handling success: ${data.advertisingId}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getTotalStorage(OBJECT) 1000+

獲取存儲空間的總大小

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
totalStorage Long 存儲空間的總大小,單位是Byte。在Android上返回的是外部存儲的總大小
device.getTotalStorage({
  success: function (data) {
    console.log(`handling success: ${data.totalStorage}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getAvailableStorage(OBJECT) 1000+

獲取存儲空間的可用大小

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
availableStorage Long 存儲空間的可用大小,單位是Byte。在Android上返回的是外部存儲的可用大小
device.getAvailableStorage({
  success: function (data) {
    console.log(`handling success: ${data.availableStorage}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getCpuInfo(OBJECT) 1000+

返回CPU信息

參數:

參數名 類型 必填 說明
success Function 成功回調
fail Function 失敗回調
complete Function 執(zhí)行結束后的回調
success返回值:
參數值 類型 說明
cpuInfo String CPU信息。在Android上返回的是/proc/cpuinfo文件的內容
device.getCpuInfo({
  success: function (data) {
    console.log(`handling success: ${data.cpuInfo}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后臺運行限制

無限制。

后臺運行詳細用法參見 后臺運行腳本。


以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號