當(dāng)前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等

發(fā)布時(shí)間：2023/12/16 编程问答 37 豆豆

生活随笔收集整理的這篇文章主要介紹了 Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

Device模塊管理設(shè)備信息，用于獲取手機(jī)設(shè)備的相關(guān)信息，如IMEI、IMSI、型號(hào)、廠商等。通過plus.device獲取設(shè)備信息管理對(duì)象。

屬性：

imei: 設(shè)備的國(guó)際移動(dòng)設(shè)備身份碼
imsi: 設(shè)備的國(guó)際移動(dòng)用戶識(shí)別碼
model: 設(shè)備的型號(hào)
vendor: 設(shè)備的生產(chǎn)廠商
uuid: 設(shè)備的唯一標(biāo)識(shí)

方法：

beep: 發(fā)出蜂鳴聲
dial: 撥打電話
getInfo: 獲取設(shè)備信息
getOAID: 獲取匿名設(shè)備標(biāo)識(shí)符
getVAID: 獲取開發(fā)者匿名設(shè)備標(biāo)識(shí)符
getAAID: 獲取應(yīng)用匿名設(shè)備標(biāo)識(shí)符
getVolume: 獲取設(shè)備的系統(tǒng)音量
isWakelock: 獲取程序是否一直保持喚醒（屏幕常亮）狀態(tài)
setWakelock: 設(shè)置應(yīng)用是否保持喚醒（屏幕常亮）狀態(tài)
setVolume: 設(shè)置設(shè)備的系統(tǒng)音量
vibrate: 設(shè)備振動(dòng)

對(duì)象：

DeviceInfo: 設(shè)備信息對(duì)象
screen: Screen模塊管理設(shè)備屏幕信息
display: Display模塊管理應(yīng)用可使用的顯示區(qū)域信息
networkinfo: networkinfo模塊用于獲取網(wǎng)絡(luò)信息
os: OS模塊管理操作系統(tǒng)信息

回調(diào)方法：

DeviceSuccessCallback: 成功回調(diào)函數(shù)
DeviceFailCallback: 失敗回調(diào)函數(shù)
DeviceCompleteCallback: 操作完成回調(diào)函數(shù)

權(quán)限：

5+功能模塊（permissions）

<code> { // ... "permissions":{// ..."Device": {"description": "設(shè)備信息"} } }</code>

imei

設(shè)備的國(guó)際移動(dòng)設(shè)備身份碼

<code> plus.device.imei;</code>

說明：

String?類型只讀屬性

此API將廢棄，HBuilderX2.0.0以后版本使用plus.device.getInfo。
調(diào)用此屬性獲取設(shè)備的國(guó)際移動(dòng)設(shè)備身份碼。如果設(shè)備不支持則返回空字符串。如果設(shè)備存在多個(gè)身份碼，則以“,”字符分割拼接，如“862470039452950,862470039452943”。

平臺(tái)支持：

Android - 2.2+ (支持) :
如果應(yīng)用無法獲取（如未獲授權(quán)）則返回空字符串。
iOS - 4.5+ (不支持) :
iOS設(shè)備不支持獲取imei值，返回空字符串。

示例：

<code> //獲取設(shè)備的國(guó)際移動(dòng)設(shè)備身份碼 function getIMEI(){console.log("IMEI: "+plus.device.imei); }</code>

uni-app使用plus注意事項(xiàng)

imsi

設(shè)備的國(guó)際移動(dòng)用戶識(shí)別碼

<code> plus.device.imsi;</code>

說明：

Array[String] 類型只讀屬性

此API將廢棄，HBuilderX2.0.0以后版本使用plus.device.getInfo。
字符串?dāng)?shù)組類型，獲取設(shè)備上插入SIM的國(guó)際移動(dòng)設(shè)備身份碼。如果設(shè)備支持多卡模式則返回所有SIM身份碼。如果設(shè)備不支持或沒有插入SIM卡則返回空數(shù)組。

平臺(tái)支持：

Android - 2.2+ (支持) :
如果設(shè)備沒有插入SIM卡，則返回空數(shù)組。
iOS - 4.5+ (不支持) :
iOS設(shè)備不支持獲取SIM卡信息，返回空數(shù)組。

示例：

<code> //獲取設(shè)備的國(guó)際移動(dòng)用戶識(shí)別碼 function getIMSI(){console.log("IMSI: " + plus.device.imsi); }</code>

uni-app使用plus注意事項(xiàng)

model

設(shè)備的型號(hào)

<code> plus.device.model;</code>

說明：

String?類型只讀屬性

調(diào)用此屬性獲取設(shè)備的型號(hào)信息。如果設(shè)備不支持則返回空字符串。

示例：

<code> //獲取設(shè)備的型號(hào) function getModel(){console.log("Model: " + plus.device.model); }</code>

uni-app使用plus注意事項(xiàng)

vendor

設(shè)備的生產(chǎn)廠商

<code> plus.device.vendor;</code>

說明：

String?類型只讀屬性

調(diào)用此屬性獲取設(shè)備的生產(chǎn)廠商信息。如果設(shè)備不支持則返回空字符串。

平臺(tái)支持：

Android - 2.2+ (支持)
iOS - 4.3+ (支持)

示例：

<code> //獲取設(shè)備的生產(chǎn)廠商 function getVendor(){console.log("Vendor: " + plus.device.vendor); }</code>

uni-app使用plus注意事項(xiàng)

uuid

設(shè)備的唯一標(biāo)識(shí)

<code> plus.device.uuid;</code>

說明：

String?類型只讀屬性

此API將廢棄，HBuilderX2.0.0以后版本使用plus.device.getInfo。
調(diào)用此屬性獲取設(shè)備的唯一標(biāo)識(shí)號(hào)。

平臺(tái)支持：

Android - 2.2+ (支持) :
與設(shè)備的imei號(hào)一致。注意：如果無法獲取設(shè)備imei則使用設(shè)備wifi的mac地址，如果無法獲取設(shè)備mac地址則隨機(jī)生成設(shè)備標(biāo)識(shí)號(hào)（不同App在同一臺(tái)設(shè)備上獲取的值一致）。
iOS - 4.5+ (支持) :
根據(jù)包名隨機(jī)生成的設(shè)備標(biāo)識(shí)號(hào)。注意：在設(shè)備重置后會(huì)重新生成。

示例：

<code> //獲取設(shè)備的唯一標(biāo)識(shí)號(hào) function getUUID(){console.log("UUID: "+plus.device.uuid); }</code>

uni-app使用plus注意事項(xiàng)

beep

發(fā)出蜂鳴聲

<code> void plus.device.beep(times);</code>

說明：

調(diào)用此方法使得設(shè)備發(fā)出蜂鳴聲。

參數(shù)：

times:?(?Number?) 可選?蜂鳴聲重復(fù)的次數(shù)，默認(rèn)發(fā)出一次蜂鳴聲

返回值：

void?: 無

平臺(tái)支持：

Android - 2.2+ (支持) :
播放系統(tǒng)設(shè)置中指定的默認(rèn)通知鈴聲
iOS - 4.3+ (支持) :
忽略times參數(shù)，播放系統(tǒng)的通知鈴聲

示例：

<code> //發(fā)出蜂鳴聲 function beep(){plus.device.beep( 3 ); }</code>

uni-app使用plus注意事項(xiàng)

dial

撥打電話

<code> void plus.device.dial(number, confirm);</code>

說明：

調(diào)用系統(tǒng)程序撥打電話。

參數(shù)：

number:?(?String?) 必選?要撥打的電話號(hào)碼
confirm:?(?Boolean?) 可選?是否需要用戶確認(rèn)后開始撥打電話
設(shè)置為true表示打開系統(tǒng)撥打電話界面，需用戶點(diǎn)擊撥號(hào)按鈕后才開始撥打電話，false則無需確認(rèn)直接撥打電話，默認(rèn)值為true。

返回值：

void?: 無

平臺(tái)支持：

Android - 2.2+ (支持) :
撥打電話需添加以下權(quán)限：
- "<uses-permission android:name="android.permission.CALL_PHONE"/>"
更多權(quán)限相關(guān)說明請(qǐng)參考：Android平臺(tái)云端打包權(quán)限配置 - DCloud問答。
iOS - 5.1+ (支持) :
忽略confirm參數(shù)，調(diào)用直接撥打電話。

示例：

<code> //撥打電話 function dial() {plus.device.dial("10086", false); }</code>

uni-app使用plus注意事項(xiàng)

getInfo

獲取設(shè)備信息

<code> void plus.device.getInfo(options);</code>

說明：

包括國(guó)際移動(dòng)設(shè)備身份碼、國(guó)際移動(dòng)用戶識(shí)別碼、設(shè)備的唯一標(biāo)識(shí)等信息。
Android平臺(tái)調(diào)用此方法需要申請(qǐng)?jiān)L問設(shè)備標(biāo)識(shí)（部分設(shè)備提示為撥打電話）權(quán)限，詳情參考獲取設(shè)備信息（imei、imsi、uuid）的調(diào)整使用plus.device.getInfo方法的說明 - DCloud問答。

參數(shù)：

options參數(shù)為json類型，包含以下屬性：

success:?(?DeviceSuccessCallback?) 可選?獲取設(shè)備信息成功回調(diào)函數(shù)
回調(diào)函數(shù)參數(shù)event對(duì)象類型為DeviceInfo。
fail:?(?DeviceFailCallback?) 可選?獲取設(shè)備信息失敗回調(diào)函數(shù)
complete:?(?DeviceCompleteCallback?) 可選?獲取設(shè)備信息操作完成回調(diào)函數(shù)
調(diào)用成功或失敗都會(huì)觸發(fā)此回調(diào)。

返回值：

void?: 無

示例：

<code> // 獲取設(shè)備信息 function getDeviceInfo(){plus.device.getInfo({success:function(e){console.log('getDeviceInfo success: '+JSON.stringify(e));},fail:function(e){console.log('getDeviceInfo failed: '+JSON.stringify(e));}}); }</code>

uni-app使用plus注意事項(xiàng)

getOAID

獲取匿名設(shè)備標(biāo)識(shí)符

<code> void plus.device.getOAID(options);</code>

說明：

HBuilderX2.4.0+版本新增支持。
Android10以前獲取設(shè)備標(biāo)識(shí)（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用戶隱私且需用戶授權(quán)，Android10+系統(tǒng)不再支持獲取設(shè)備標(biāo)識(shí)信息。為解決此問題移動(dòng)安全聯(lián)盟聯(lián)合各手機(jī)廠商推出移動(dòng)智能設(shè)備標(biāo)識(shí)公共服務(wù)平臺(tái)提供補(bǔ)充設(shè)備標(biāo)識(shí)體系，包括匿名設(shè)備標(biāo)識(shí)符（OAID）、開發(fā)者匿名設(shè)備標(biāo)識(shí)符（VAID）和應(yīng)用匿名設(shè)備標(biāo)識(shí)符（AAID）。
匿名設(shè)備標(biāo)識(shí)符（OAID）最長(zhǎng)為64位字符串，所有應(yīng)用獲取的值相同，可用于個(gè)性化推薦、廣告等業(yè)務(wù)。系統(tǒng)首次啟動(dòng)后生成，用戶手動(dòng)重置、恢復(fù)出廠設(shè)置、設(shè)備商重置、被刷機(jī)等操作會(huì)重置此標(biāo)識(shí)。

參數(shù)：

options參數(shù)為json類型，包含以下屬性：

success:?(?DeviceSuccessCallback?) 可選?獲取匿名設(shè)備標(biāo)識(shí)成功回調(diào)函數(shù)
回調(diào)函數(shù)參數(shù)event對(duì)象類型為json，包含oaid屬性保存獲取的匿名設(shè)備標(biāo)識(shí)符。
fail:?(?DeviceFailCallback?) 可選?獲取匿名設(shè)備標(biāo)識(shí)失敗回調(diào)函數(shù)
complete:?(?DeviceCompleteCallback?) 可選?獲取匿名設(shè)備標(biāo)識(shí)操作完成回調(diào)函數(shù)
調(diào)用成功或失敗都會(huì)觸發(fā)此回調(diào)，成功時(shí)回調(diào)參數(shù)與DeviceSuccessCallback一致，失敗時(shí)回調(diào)參數(shù)與DeviceCompleteCallback一致。

返回值：

void?: 無

平臺(tái)支持：

Android - 10+ (支持) :
僅在華為、OPPO、VIVO、小米、聯(lián)想等設(shè)備支持。

示例：

<code> // 獲取匿名設(shè)備標(biāo)識(shí)符 function getOAID(){plus.device.getOAID({success:function(e){console.log('getOAID success: '+JSON.stringify(e));},fail:function(e){console.log('getOAID failed: '+JSON.stringify(e));}}); }</code>

uni-app使用plus注意事項(xiàng)

getVAID

獲取開發(fā)者匿名設(shè)備標(biāo)識(shí)符

<code> void plus.device.getVAID(options);</code>

說明：

HBuilderX2.4.0+版本新增支持。
Android10以前獲取設(shè)備標(biāo)識(shí)（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用戶隱私且需用戶授權(quán)，Android10+系統(tǒng)不再支持獲取設(shè)備標(biāo)識(shí)信息。為解決此問題移動(dòng)安全聯(lián)盟聯(lián)合各手機(jī)廠商推出移動(dòng)智能設(shè)備標(biāo)識(shí)公共服務(wù)平臺(tái)提供補(bǔ)充設(shè)備標(biāo)識(shí)體系，包括匿名設(shè)備標(biāo)識(shí)符（OAID）、開發(fā)者匿名設(shè)備標(biāo)識(shí)符（VAID）和應(yīng)用匿名設(shè)備標(biāo)識(shí)符（AAID）。
開發(fā)者匿名設(shè)備標(biāo)識(shí)符（VAID）最長(zhǎng)為64位字符串，同一開發(fā)者不同應(yīng)用獲取的值相同，可用于同一開發(fā)者不同應(yīng)用之間的推薦等。在應(yīng)用安裝時(shí)生成，用戶恢復(fù)出廠設(shè)置、卸載所有開發(fā)商應(yīng)用、設(shè)備商重置、被刷機(jī)等操作會(huì)重置此標(biāo)識(shí)。

參數(shù)：

options參數(shù)為json類型，包含以下屬性：

success:?(?DeviceSuccessCallback?) 可選?獲取開發(fā)者匿名設(shè)備標(biāo)識(shí)成功回調(diào)函數(shù)
回調(diào)函數(shù)參數(shù)event對(duì)象類型為json，包含vaid屬性保存獲取的開發(fā)者匿名設(shè)備標(biāo)識(shí)符。
fail:?(?DeviceFailCallback?) 可選?獲取開發(fā)者匿名設(shè)備標(biāo)識(shí)失敗回調(diào)函數(shù)
complete:?(?DeviceCompleteCallback?) 可選?獲取開發(fā)者匿名設(shè)備標(biāo)識(shí)操作完成回調(diào)函數(shù)
調(diào)用成功或失敗都會(huì)觸發(fā)此回調(diào)，成功時(shí)回調(diào)參數(shù)與DeviceSuccessCallback一致，失敗時(shí)回調(diào)參數(shù)與DeviceCompleteCallback一致。

返回值：

void?: 無

平臺(tái)支持：

Android - 10+ (支持) :
僅在華為、OPPO、VIVO、小米、聯(lián)想等設(shè)備支持。

示例：

<code> // 獲取開發(fā)者匿名設(shè)備標(biāo)識(shí)符 function getVAID(){plus.device.getVAID({success:function(e){console.log('getVAID success: '+JSON.stringify(e));},fail:function(e){console.log('getVAID failed: '+JSON.stringify(e));}}); }</code>

uni-app使用plus注意事項(xiàng)

getAAID

獲取應(yīng)用匿名設(shè)備標(biāo)識(shí)符

<code> void plus.device.getAAID(options);</code>

說明：

HBuilderX2.4.0+版本新增支持。
Android10以前獲取設(shè)備標(biāo)識(shí)（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用戶隱私且需用戶授權(quán)，Android10+系統(tǒng)不再支持獲取設(shè)備標(biāo)識(shí)信息。為解決此問題移動(dòng)安全聯(lián)盟聯(lián)合各手機(jī)廠商推出移動(dòng)智能設(shè)備標(biāo)識(shí)公共服務(wù)平臺(tái)提供補(bǔ)充設(shè)備標(biāo)識(shí)體系，包括匿名設(shè)備標(biāo)識(shí)符（OAID）、開發(fā)者匿名設(shè)備標(biāo)識(shí)符（VAID）和應(yīng)用匿名設(shè)備標(biāo)識(shí)符（AAID）。
應(yīng)用匿名設(shè)備標(biāo)識(shí)符（AAID）最長(zhǎng)為64位字符串，每個(gè)應(yīng)用獲取的值都不相同，可用于用戶統(tǒng)計(jì)等。在應(yīng)用安裝時(shí)生成，用戶恢復(fù)出廠設(shè)置、卸載應(yīng)用、清空應(yīng)用數(shù)據(jù)、設(shè)備商重置等操作會(huì)重置此標(biāo)識(shí)。

參數(shù)：

options參數(shù)為json類型，包含以下屬性：

success:?(?DeviceSuccessCallback?) 可選?獲取應(yīng)用匿名設(shè)備標(biāo)識(shí)成功回調(diào)函數(shù)
回調(diào)函數(shù)參數(shù)event對(duì)象類型為json，包含aaid屬性保存獲取的應(yīng)用匿名設(shè)備標(biāo)識(shí)符。
fail:?(?DeviceFailCallback?) 可選?獲取應(yīng)用匿名設(shè)備標(biāo)識(shí)失敗回調(diào)函數(shù)
complete:?(?DeviceCompleteCallback?) 可選?獲取應(yīng)用匿名設(shè)備標(biāo)識(shí)操作完成回調(diào)函數(shù)
調(diào)用成功或失敗都會(huì)觸發(fā)此回調(diào)，成功時(shí)回調(diào)參數(shù)與DeviceSuccessCallback一致，失敗時(shí)回調(diào)參數(shù)與DeviceCompleteCallback一致。

返回值：

void?: 無

平臺(tái)支持：

Android - 10+ (支持) :
僅在華為、OPPO、VIVO、小米、聯(lián)想等設(shè)備支持。

示例：

<code> // 獲取應(yīng)用匿名設(shè)備標(biāo)識(shí)符 function getAAID(){plus.device.getAAID({success:function(e){console.log('getAAID success: '+JSON.stringify(e));},fail:function(e){console.log('getAAID failed: '+JSON.stringify(e));}}); }</code>

uni-app使用plus注意事項(xiàng)

getVolume

獲取設(shè)備的系統(tǒng)音量

<code> Number plus.device.getVolume();</code>

說明：

系統(tǒng)音量值范圍為0到1，0表示靜音，1表示最大音量值。

參數(shù)：

無

返回值：

Number?: 系統(tǒng)的音量值

平臺(tái)支持：

Android - ALL (支持) :
Android平臺(tái)獲取的是系統(tǒng)多媒體音量。
iOS - ALL (支持)

isWakelock

獲取程序是否一直保持喚醒（屏幕常亮）狀態(tài)

<code> Boolean plus.device.isWakelock();</code>

說明：

調(diào)用此方法獲取程序是否一致保持喚醒狀態(tài)。

參數(shù)：

無

返回值：

Boolean?: 返回ture表示程序已設(shè)置為一直保持喚醒狀態(tài)，返回false表示程序未設(shè)置為一直保持喚醒狀態(tài)。

setWakelock

設(shè)置應(yīng)用是否保持喚醒（屏幕常亮）狀態(tài)

<code> plus.device.setWakelock(lock);</code>

說明：

調(diào)用此方法設(shè)置應(yīng)用是否一直保持喚醒狀態(tài)，保持喚醒狀態(tài)將會(huì)導(dǎo)致程序屏幕常亮、系統(tǒng)不會(huì)自動(dòng)鎖屏，從而導(dǎo)致消耗更多的電量。若未設(shè)置一直保持喚醒狀態(tài)則會(huì)根據(jù)系統(tǒng)設(shè)置自動(dòng)鎖定屏幕。

參數(shù)：

lock:?(?Boolean?) 必選?是否設(shè)置程序一直保持喚醒狀態(tài)
可取值true或false，true表示設(shè)定程序一直保持喚醒狀態(tài)，false表示關(guān)閉程序一直保持喚醒狀態(tài)。程序退出后將恢復(fù)默認(rèn)狀態(tài)，默認(rèn)為關(guān)閉程序保持喚醒狀態(tài)。

返回值：

void?: 無

示例：

<code> // 設(shè)置應(yīng)用保持喚醒（屏幕常亮）狀態(tài) function setWakelock(){plus.device.setWakelock(true); }</code>

uni-app使用plus注意事項(xiàng)

setVolume

設(shè)置設(shè)備的系統(tǒng)音量

<code> plus.device.setVolume(volume);</code>

說明：

調(diào)用此方法調(diào)節(jié)設(shè)備的系統(tǒng)音量。

參數(shù)：

volume:?(?Number?) 必選?設(shè)備的系統(tǒng)音量值
取值范圍為0到1，0表示靜音，1表示最大音量值。設(shè)置設(shè)備音量后對(duì)所有程序生效，退出程序系統(tǒng)仍然保持最后設(shè)定的音量值。

返回值：

void?: 無

平臺(tái)支持：

iOS - 4.3+ (支持)
Android - 2.2+ (支持) :
設(shè)置音量后對(duì)所有項(xiàng)的音量生效，如通話音量、系統(tǒng)音量、鈴聲音量、音樂音量、提示聲音音量。

示例：

<code> // 設(shè)備的系統(tǒng)音量值 function setVolume(){plus.device.setVolume(0.5); }</code>

uni-app使用plus注意事項(xiàng)

vibrate

設(shè)備振動(dòng)

<code> plus.device.vibrate(milliseconds);</code>

說明：

調(diào)用此方法使得設(shè)備振動(dòng)。

參數(shù)：

milliseconds:?(?Number?) 必選?設(shè)備振動(dòng)持續(xù)的時(shí)間
數(shù)值類型，單位為ms，默認(rèn)為500ms。

返回值：

void?: 無

平臺(tái)支持：

Android - 2.2+ (支持) :
支持振動(dòng)指定的時(shí)長(zhǎng)，需添加以下權(quán)限： "<uses-permission android:name="android.permission.VIBRATE"/>" 更多權(quán)限相關(guān)說明請(qǐng)參考：https://ask.dcloud.net.cn/article/36982。
iOS - 4.3+ (支持) :
不支持milliseconds參數(shù)，使用系統(tǒng)默認(rèn)振動(dòng)時(shí)長(zhǎng)，僅iPhone設(shè)備支持，iPad和iTouch設(shè)備不支持，調(diào)用此接口無任何效果。注意：如果在系統(tǒng)設(shè)置中關(guān)閉振動(dòng)功能則無法調(diào)用設(shè)備振動(dòng)（設(shè)置->聲音->振動(dòng)）。

示例：

<code> // 設(shè)備振動(dòng) function vibrate(){plus.device.vibrate(2000); }</code>

uni-app使用plus注意事項(xiàng)

DeviceInfo

設(shè)備信息對(duì)象

屬性：

imei:?(String?類型 )設(shè)備的國(guó)際移動(dòng)設(shè)備身份碼
如果設(shè)備不支持或無法獲取（如用戶未授權(quán)）則返回空字符串。如果設(shè)備存在多個(gè)身份碼，則以“,”字符分割拼接，如“862470039452950,862470039452943”。

平臺(tái)支持
- Android - ALL (支持) :
- iOS - ALL (不支持) :
  無法獲取設(shè)備身份碼，返回空字符串。
imsi:?(Array[String] 類型 )設(shè)備的國(guó)際移動(dòng)用戶識(shí)別碼
字符串?dāng)?shù)組類型，獲取設(shè)備上插入SIM的國(guó)際移動(dòng)設(shè)備身份碼。如果設(shè)備支持多卡模式則返回所有SIM身份碼。如果設(shè)備不支持或沒有插入SIM卡則返回空數(shù)組。

平臺(tái)支持
- Android - ALL (支持) :
  如果無法獲取國(guó)際移動(dòng)用戶標(biāo)識(shí)（如用戶未授權(quán)）則返回空數(shù)組。
- iOS - ALL (不支持) :
  無法獲取設(shè)備移動(dòng)用戶識(shí)別碼，返回空數(shù)組。
uuid:?(String?類型 )設(shè)備標(biāo)識(shí)
設(shè)備的唯一標(biāo)識(shí)號(hào)。

平臺(tái)支持
- Android - ALL (支持) :
  與設(shè)備的imei號(hào)一致。注意：如果無法獲取設(shè)備imei則使用設(shè)備wifi的mac地址，如果無法獲取設(shè)備mac地址則隨機(jī)生成設(shè)備標(biāo)識(shí)號(hào)（不同App在同一臺(tái)設(shè)備上獲取的值一致）。
- iOS - ALL (支持) :
  根據(jù)包名隨機(jī)生成的設(shè)備標(biāo)識(shí)號(hào)。注意：設(shè)備重置（刷機(jī)）后會(huì)重新生成。

screen

Screen模塊管理設(shè)備屏幕信息

<code> interface plus.screen {attribute String dpiX;attribute String dpiY;attribute Number height;attribute Number width;attribute Number resolutionHeight;attribute Number resolutionWidth;attribute Number scale;function void setBrightness(brightness);function Number getBrightness();function void lockOrientation(orientation);function void unlockOrientation(); }</code>

屬性：

dpiX: 設(shè)備屏幕水平方向的密度
dpiY: 設(shè)備屏幕垂直方向的密度
height: 屏幕高度物理分辨率
width: 屏幕寬度物理分辨率
resolutionHeight: 屏幕高度邏輯分辨率
resolutionWidth: 屏幕寬度邏輯分辨率
scale: 邏輯分辨率與物理分辨率的縮放比例

方法：

setBrightness: 設(shè)置屏幕亮度
getBrightness: 獲取屏幕亮度值
getCurrentSize: 獲取當(dāng)前屏幕信息
lockOrientation: 鎖定屏幕方向
unlockOrientation: 解除鎖定屏幕方向

dpiX

設(shè)備屏幕水平方向的密度

<code> plus.screen.dpiX;</code>

說明：

Number?類型只讀屬性

設(shè)備屏幕的密度為每英寸所顯示的像素點(diǎn)數(shù)，密度越高顯示清晰度越高，單位為dpi。

平臺(tái)支持：

Android - 2.2+ (支持)
iOS - 4.3+ (支持)

示例：

<code> // 獲取水平方向密度 function getDPI(){plus.nativeUI.alert("DPI X: " + plus.screen.dpiX); }</code>

uni-app使用plus注意事項(xiàng)

dpiY

設(shè)備屏幕垂直方向的密度

<code> plus.screen.dpiY;</code>

說明：

Number?類型只讀屬性

設(shè)備屏幕的密度為每英寸所顯示的像素點(diǎn)數(shù)，密度越高顯示清晰度越高，單位為dpi。

平臺(tái)支持：

Android - 2.2+ (支持)
iOS - 4.3+ (支持)

示例：

<code> // 獲取垂直方向密度 function getDPI(){plus.nativeUI.alert("DPI Y: " + plus.screen.dpiY); }</code>

uni-app使用plus注意事項(xiàng)

height

屏幕高度物理分辨率

<code> // 獲取物理高度 plus.screen.height;</code>

說明：

Number?類型只讀屬性

單位為px，設(shè)備屏幕的實(shí)際物理分辨率。物理分辨率跟屏幕密度相關(guān)，通常建議使用邏輯分辨率。

Android - 2.2+ (支持)
iOS - 4.3+ (支持)

示例：

<code> // 獲取邏輯分辨率與物理分辨率的縮放比例 function getScale(){plus.nativeUI.alert("Scale: " + plus.screen.scale); }</code>

uni-app使用plus注意事項(xiàng)

setBrightness

設(shè)置屏幕亮度

<code> plus.screen.setBrightness(brightness);</code>

說明：

調(diào)用此方法調(diào)節(jié)設(shè)備屏幕亮度。

參數(shù)：

brightness:?(?Number?) 必選?屏幕的亮度值
取值范圍為0到1，0表示最低亮度值，1表示最高亮度值。 HBuilderX3.2.11+版本新增支持取值-1，僅Android平臺(tái)支持，表示設(shè)置應(yīng)用的屏幕亮度與系統(tǒng)屏幕亮度保持一致。

返回值：

void?: 無

平臺(tái)支持：

Android - 5.0+ (支持) :
應(yīng)用有獨(dú)立的亮度，設(shè)置應(yīng)用的屏幕亮度不會(huì)修改系統(tǒng)屏幕亮度，僅對(duì)當(dāng)前應(yīng)用在前臺(tái)運(yùn)行時(shí)有效，退出應(yīng)用后屏幕亮度切換回系統(tǒng)屏幕亮度。如果要保證應(yīng)用的屏幕亮度與系統(tǒng)屏幕亮度一致，可以設(shè)置值為 -1。
iOS - 9.0+ (支持) :
應(yīng)用沒有獨(dú)立的亮度，設(shè)置時(shí)會(huì)修改系統(tǒng)屏幕亮度。不支持設(shè)置值為 -1。

示例：

<code> // 設(shè)置屏幕亮度 function setBrightness(){plus.screen.setBrightness( 0.5 ); }</code>

uni-app使用plus注意事項(xiàng)

getBrightness

獲取屏幕亮度值

<code> Number plus.screen.getBrightness();</code>

說明：

屏幕亮度值范圍為0到1，0表示最低亮度值，1表示最高亮度值。

參數(shù)：

無

返回值：

Number?: 返回程序的屏幕亮度值

示例：

<code> // 獲取屏幕亮度 function getBrightness(){plus.nativeUI.alert("Brightness: " + plus.screen.getBrightness()); }</code>

uni-app使用plus注意事項(xiàng)

getCurrentSize

獲取當(dāng)前屏幕信息

<code> JSON plus.screen.getCurrentSize();</code>

說明：

當(dāng)前屏幕的寬、高信息，返回?cái)?shù)據(jù)包括以下屬性：

"height" - 屏幕物理分辨率高度，單位為px
"width" - 屏幕物理分辨率寬度，單位為px
"resolutionHeight" - 屏幕邏輯分辨率高度，單位為px
"resolutionWidth" - 屏幕邏輯分辨率寬度，單位為px

注意：HBuilderX2.6.9+版本支持。

參數(shù)：

無

返回值：

JSON?: 屏幕的寬、高信息

示例：

<code> // 獲取當(dāng)前屏幕信息 function getScreenInfo(){var info = plus.screen.getCurrentSize();console.log('ScreenInfo: "+JSON.stringify(info)); }</code>

uni-app使用plus注意事項(xiàng)

lockOrientation

鎖定屏幕方向

<code> void plus.screen.lockOrientation(orientation);</code>

說明：

鎖定屏幕方向后屏幕只能按鎖定的屏幕方向顯示，關(guān)閉當(dāng)前頁面后仍然有效。可再次調(diào)用此方法修改屏幕鎖定方向或調(diào)用unlockOrientation()方法恢復(fù)到應(yīng)用的默認(rèn)值。

參數(shù)：

orientation:?(?String?) 必選?要鎖定的屏幕方向值
鎖定屏幕方向可取以下值： "portrait-primary": 豎屏正方向； "portrait-secondary": 豎屏反方向，屏幕正方向按順時(shí)針旋轉(zhuǎn)180°； "landscape-primary": 橫屏正方向，屏幕正方向按順時(shí)針旋轉(zhuǎn)90°； "landscape-secondary": 橫屏方向，屏幕正方向按順時(shí)針旋轉(zhuǎn)270°； "portrait": 豎屏正方向或反方向，根據(jù)設(shè)備重力感應(yīng)器自動(dòng)調(diào)整； "landscape": 橫屏正方向或反方向，根據(jù)設(shè)備重力感應(yīng)器自動(dòng)調(diào)整；

返回值：

void?: 無

示例：

<code> // 鎖定屏幕方向 function lockOrientation(){plus.screen.lockOrientation("landscape-primary"); }</code>

uni-app使用plus注意事項(xiàng)

unlockOrientation

解除鎖定屏幕方向

<code> void plus.screen.unlockOrientation();</code>

說明：

解除鎖定屏幕方向后將恢復(fù)應(yīng)用默認(rèn)的屏幕顯示方向（通常為應(yīng)用打包發(fā)布時(shí)設(shè)置的方向）。

參數(shù)：

無

返回值：

void?: 無

示例：

<code> // 解除鎖定屏幕方向 function unlockOrientation(){plus.screen.unlockOrientation(); }</code>

uni-app使用plus注意事項(xiàng)

display

Display模塊管理應(yīng)用可使用的顯示區(qū)域信息

屬性：

resolutionHeight: 應(yīng)用可使用的屏幕高度邏輯分辨率
resolutionWidth: 應(yīng)用可使用的屏幕寬度邏輯分辨率

resolutionHeight

應(yīng)用可使用的屏幕高度邏輯分辨率

<code> plus.display.resolutionHeight;</code>

說明：

Number?類型只讀屬性

設(shè)備屏幕區(qū)域包括系統(tǒng)狀態(tài)欄顯示區(qū)域和應(yīng)用顯示區(qū)域，display獲取的是應(yīng)用顯示區(qū)域的邏輯分辨率，單位為px。如果需要獲取實(shí)際分辨率則需要乘以比例值scale。

平臺(tái)支持：

Android - 2.2+ (支持)
iOS - 4.3+ (支持)

resolutionWidth

應(yīng)用可使用的屏幕寬度邏輯分辨率

<code> plus.display.resolutionWidth;</code>

說明：

Number?類型只讀屬性

networkinfo

networkinfo模塊用于獲取網(wǎng)絡(luò)信息

<code> interface plus.networkinfo {const attribute Number CONNECTION_UNKNOW = 0;const attribute Number CONNECTION_NONE = 1;const attribute Number CONNECTION_ETHERNET = 2;const attribute Number CONNECTION_WIFI = 3;const attribute Number CONNECTION_CELL2G = 4;const attribute Number CONNECTION_CELL3G = 5;const attribute Number CONNECTION_CELL4G = 6;function Number getCurrentType();function Boolean isSetProxy(); }</code>

常量：

CONNECTION_UNKNOW: 網(wǎng)絡(luò)連接狀態(tài)未知
CONNECTION_NONE: 未連接網(wǎng)絡(luò)
CONNECTION_ETHERNET: 有線網(wǎng)絡(luò)
CONNECTION_WIFI: 無線WIFI網(wǎng)絡(luò)
CONNECTION_CELL2G: 蜂窩移動(dòng)2G網(wǎng)絡(luò)
CONNECTION_CELL3G: 蜂窩移動(dòng)3G網(wǎng)絡(luò)
CONNECTION_CELL4G: 蜂窩移動(dòng)4G網(wǎng)絡(luò)
CONNECTION_CELL5G: 蜂窩移動(dòng)5G網(wǎng)絡(luò)

方法：

getCurrentType: 獲取設(shè)備當(dāng)前連接的網(wǎng)絡(luò)類型
isSetProxy: 獲取當(dāng)前網(wǎng)絡(luò)是否設(shè)置代理

平臺(tái)支持

Android - 2.2+ (支持)
iOS - 7.0+ (支持)

CONNECTION_CELL4G

蜂窩移動(dòng)4G網(wǎng)絡(luò)

<code> plus.networkinfo.CONNECTION_CELL4G;</code>

說明：

Number?類型

網(wǎng)絡(luò)狀態(tài)常量，當(dāng)前設(shè)備連接到蜂窩移動(dòng)4G網(wǎng)絡(luò)，固定值為6。

平臺(tái)支持

Android - 2.2+ (支持)
iOS - 7.0+ (支持)

CONNECTION_CELL5G

蜂窩移動(dòng)5G網(wǎng)絡(luò)

<code> plus.networkinfo.CONNECTION_CELL5G;</code>

說明：

Number?類型

網(wǎng)絡(luò)狀態(tài)常量，當(dāng)前設(shè)備連接到蜂窩移動(dòng)5G網(wǎng)絡(luò)，固定值為7。

平臺(tái)支持

Android - 2.2+ (支持)
iOS - 14.0+ (支持)

getCurrentType

獲取設(shè)備當(dāng)前連接的網(wǎng)絡(luò)類型

<code> Number plus.networkinfo.getCurrentType();</code>

說明：

獲取當(dāng)前設(shè)備連接的網(wǎng)絡(luò)類型，返回值為網(wǎng)絡(luò)類型常量，可取值CONNECTION_*常量。

參數(shù)：

無

返回值：

Number?: 設(shè)備當(dāng)前網(wǎng)絡(luò)類型

平臺(tái)支持：

Android - 2.3+ (支持)
iOS - 7.0+ (支持)

示例：

<code> // 獲取設(shè)備當(dāng)前連接的網(wǎng)絡(luò)類型 function getNetworkType(){var types = {}; types[plus.networkinfo.CONNECTION_UNKNOW] = "Unknown connection"; types[plus.networkinfo.CONNECTION_NONE] = "None connection"; types[plus.networkinfo.CONNECTION_ETHERNET] = "Ethernet connection"; types[plus.networkinfo.CONNECTION_WIFI] = "WiFi connection"; types[plus.networkinfo.CONNECTION_CELL2G] = "Cellular 2G connection"; types[plus.networkinfo.CONNECTION_CELL3G] = "Cellular 3G connection"; types[plus.networkinfo.CONNECTION_CELL4G] = "Cellular 4G connection"; console.log("Network: " + types[plus.networkinfo.getCurrentType()]); }</code>

uni-app使用plus注意事項(xiàng)

isSetProxy

獲取當(dāng)前網(wǎng)絡(luò)是否設(shè)置代理

<code> Boolean plus.networkinfo.isSetProxy();</code>

說明：

注意：HBuilderX3.0.0及以上版本支持。

參數(shù)：

無

返回值：

Boolean?: 如果設(shè)置了代理則返回true，否則返回false。

平臺(tái)支持：

Android - 4.4+ (支持) :
僅支持判斷WiFi情況下是否設(shè)置代理，無法判斷移動(dòng)網(wǎng)絡(luò)設(shè)置代理的情況
iOS - 9.0+ (支持)

os

OS模塊管理操作系統(tǒng)信息

屬性：

language: 系統(tǒng)語言信息
name: 系統(tǒng)的名稱
vendor: 系統(tǒng)的供應(yīng)商信息
version: 系統(tǒng)版本信息

language

系統(tǒng)語言信息

<code> plus.os.language;</code>

說明：

String?類型只讀屬性

獲取當(dāng)前操作系統(tǒng)設(shè)置的系統(tǒng)語言，字符串類型數(shù)據(jù)，格式為"語言-地區(qū)"，如"zh-CN"表示語言為簡(jiǎn)體中文、地區(qū)為中國(guó)大陸。

平臺(tái)支持：

Android - 2.2+ (支持)
iOS - 4.3+ (支持) :
iOS系統(tǒng)支持跟多的語言選擇，會(huì)包含更豐富的語言信息，如"zh-Hans-CN“，其中"zh-Hans"表示語言為簡(jiǎn)體中文，對(duì)應(yīng)繁體中文為"zh-Hant”，最后的"CN“表示地區(qū)為中國(guó)大陸。

示例：

<code> // 獲取系統(tǒng)語言信息 function getLanguage(){console.log("OS language: " + plus.os.language); }</code>

uni-app使用plus注意事項(xiàng)

name

系統(tǒng)的名稱

說明：

String?類型只讀屬性

獲取當(dāng)前操作系統(tǒng)的名稱，字符串類型數(shù)據(jù)。

平臺(tái)支持：

Android - 2.2+ (支持) :
返回字符串“Android”
iOS - 4.3+ (支持) :
返回字符串“iOS”

示例：

<code> // 獲取系統(tǒng)的名稱 function plusReady(){console.log("OS name: " + plus.os.name); }</code>

uni-app使用plus注意事項(xiàng)

vendor

系統(tǒng)的供應(yīng)商信息

<code> plus.os.vendor;</code>

說明：

String?類型只讀屬性

獲取當(dāng)前操作系統(tǒng)的供應(yīng)商名稱，字符串類型數(shù)據(jù)。

平臺(tái)支持：

Android - 2.2+ (支持) :
返回字符串“Google”
iOS - 4.3+ (支持) :
返回字符串“Apple”

示例：

<code> // 獲取系統(tǒng)的供應(yīng)商信息 function getVendor(){console.log("OS name: " + plus.os.vendor ); }</code>

uni-app使用plus注意事項(xiàng)

version

系統(tǒng)版本信息

<code> plus.os.version;</code>

說明：

String?類型只讀屬性

獲取當(dāng)前操作系統(tǒng)的版本信息，字符串類型數(shù)據(jù)。

平臺(tái)支持：

Android - 2.2+ (支持)
iOS - 4.3+ (支持)

示例：

<code> // 獲取系統(tǒng)版本信息 function getVersion(){console.log("OS version: " + plus.os.version); }</code>

uni-app使用plus注意事項(xiàng)

DeviceSuccessCallback

成功回調(diào)函數(shù)

<code> void onSuccess(Object event){ }</code>

說明：

不同接口觸發(fā)的成功回調(diào)參數(shù)event包含的屬性存在差異，具體參考對(duì)應(yīng)的接口描述說明。

參數(shù)：

event:?(?Object?) 必選?回調(diào)參數(shù)
回調(diào)參數(shù)包含的屬性由調(diào)用接口決定，具體參考對(duì)應(yīng)的接口描述說明。

返回值：

void?: 無

DeviceFailCallback

失敗回調(diào)函數(shù)

<code> function void onFail(Exception error){// Handle errorvar code = error.code; // 錯(cuò)誤編碼var message = error.message; // 錯(cuò)誤描述信息 }</code>

參數(shù)：

error:?(?Exception?) 必選?回調(diào)參數(shù)，錯(cuò)誤信息
可通過error.code（Number類型）獲取錯(cuò)誤編碼；可通過error.message（String類型）獲取錯(cuò)誤描述信息。

返回值：

void?: 無

DeviceCompleteCallback

操作完成回調(diào)函數(shù)

說明：

調(diào)用成功或失敗都會(huì)觸發(fā)此回調(diào)。

參數(shù)：

event:?(?Object?) 可選?回調(diào)參數(shù)
調(diào)用成功時(shí)回調(diào)參數(shù)與DeviceSuccessCallback一致，調(diào)用失敗時(shí)回調(diào)參數(shù)與DeviceFailCallback一致。

返回值：

void?: 無

總結(jié)

以上是生活随笔為你收集整理的Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。

上一篇：什么是devicenet跟以太网啥区别
下一篇： angular中自定义webpack配置