快應(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è)備型號(hào)
product String 設(shè)備代號(hào)
osType String 操作系統(tǒng)名稱
osVersionName String 操作系統(tǒng)版本名稱
osVersionCode Integer 操作系統(tǒng)版本號(hào)
platformVersionName String 運(yùn)行平臺(tái)版本名稱
platformVersionCode Integer 運(yùn)行平臺(tái)版本號(hào)
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è)備標(biāo)識(shí),需要用戶授權(quán)

權(quán)限要求

獲取手機(jī)狀態(tài)

后臺(tái)運(yùn)行限制

無限制。后臺(tái)運(yùn)行詳細(xì)用法參見后臺(tái)運(yùn)行 腳本。

參數(shù):

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

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

參數(shù)名 類型 說明
device String 設(shè)備唯一標(biāo)識(shí)。在Android上返回IMEI或MEID
mac String 設(shè)備的mac地址。在Android M及以上返回固定值:02:00:00:00:00:00
user String 用戶唯一標(biāo)識(shí)。在Android上返回androidid
advertising 1000+ String 廣告唯一標(biāo)識(shí)
fail返回錯(cuò)誤代碼
錯(cuò)誤碼 說明
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è)備唯一標(biāo)識(shí)。需要用戶授權(quán)

參數(shù):

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

獲取用戶唯一標(biāo)識(shí)

參數(shù):

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

獲取廣告唯一標(biāo)識(shí)

參數(shù):

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

獲取存儲(chǔ)空間的總大小

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
totalStorage Long 存儲(chǔ)空間的總大小,單位是Byte。在Android上返回的是外部存儲(chǔ)的總大小
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+

獲取存儲(chǔ)空間的可用大小

參數(shù):

參數(shù)名 類型 必填 說明
success Function 成功回調(diào)
fail Function 失敗回調(diào)
complete Function 執(zhí)行結(jié)束后的回調(diào)
success返回值:
參數(shù)值 類型 說明
availableStorage Long 存儲(chǔ)空間的可用大小,單位是Byte。在Android上返回的是外部存儲(chǔ)的可用大小
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}`)
  }
})

后臺(tái)運(yùn)行限制

無限制。

后臺(tái)運(yùn)行詳細(xì)用法參見 后臺(tái)運(yùn)行腳本。


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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)