快應(yīng)用 設(shè)備信息

2020-08-10 15:12 更新

接口聲明

{"name": "system.device"}

導(dǎo)入模塊

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

接口定義

device.getInfo(OBJECT)

獲取設(shè)備信息

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
brand String 設(shè)備品牌
manufacturer String 設(shè)備生產(chǎn)商
model String 設(shè)備型號
product String 設(shè)備代號
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)

批量獲取設(shè)備標識,需要用戶授權(quán)

權(quán)限要求

獲取手機狀態(tài)

后臺運行限制

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

參數(shù):

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

按照傳入的type返回對應(yīng)的id,未在type中出現(xiàn)的id類型不會返回

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

示例:

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+

獲取設(shè)備唯一標識。需要用戶授權(quán)

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
deviceId String 設(shè)備唯一標識。在Android上返回IMEI或MEID
fail返回錯誤代碼
錯誤碼 說明
201 用戶拒絕授權(quán)
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+

獲取用戶唯一標識

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
userId String 設(shè)備唯一標識。在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+

獲取廣告唯一標識

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
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+

獲取存儲空間的總大小

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
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+

獲取存儲空間的可用大小

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
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信息

參數(shù):

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

后臺運行限制

無限制。

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


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號