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

编程问答

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

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

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

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

屬性：

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

方法：

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

對象：

DeviceInfo: 設(shè)備信息對象
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è)備的國際移動設(shè)備身份碼

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

說明：

String?類型只讀屬性

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

平臺支持：

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

示例：

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

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

imsi

設(shè)備的國際移動用戶識別碼

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

說明：

Array[String] 類型只讀屬性

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

平臺支持：

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

示例：

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

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

model

設(shè)備的型號

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

說明：

String?類型只讀屬性

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

示例：

<code> //獲取設(shè)備的型號 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è)備不支持則返回空字符串。

平臺支持：

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)識

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

說明：

String?類型只讀屬性

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

平臺支持：

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

示例：

<code> //獲取設(shè)備的唯一標(biā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?: 無

平臺支持：

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

返回值：

void?: 無

平臺支持：

Android - 2.2+ (支持) :
撥打電話需添加以下權(quán)限：
- "<uses-permission android:name="android.permission.CALL_PHONE"/>"
更多權(quán)限相關(guān)說明請參考：Android平臺云端打包權(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>

說明：

包括國際移動設(shè)備身份碼、國際移動用戶識別碼、設(shè)備的唯一標(biāo)識等信息。
Android平臺調(diào)用此方法需要申請?jiān)L問設(shè)備標(biāo)識（部分設(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對象類型為DeviceInfo。
fail:?(?DeviceFailCallback?) 可選?獲取設(shè)備信息失敗回調(diào)函數(shù)
complete:?(?DeviceCompleteCallback?) 可選?獲取設(shè)備信息操作完成回調(diào)函數(shù)
調(diào)用成功或失敗都會觸發(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)識符

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

說明：

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

參數(shù)：

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

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

返回值：

void?: 無

平臺支持：

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

示例：

<code> // 獲取匿名設(shè)備標(biāo)識符 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)識符

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

說明：

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

參數(shù)：

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

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

返回值：

void?: 無

平臺支持：

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

示例：

<code> // 獲取開發(fā)者匿名設(shè)備標(biāo)識符 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)識符

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

說明：

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

參數(shù)：

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

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

返回值：

void?: 無

平臺支持：

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

示例：

<code> // 獲取應(yīng)用匿名設(shè)備標(biāo)識符 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)的音量值

平臺支持：

Android - ALL (支持) :
Android平臺獲取的是系統(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)將會導(dǎo)致程序屏幕常亮、系統(tǒng)不會自動鎖屏，從而導(dǎo)致消耗更多的電量。若未設(shè)置一直保持喚醒狀態(tài)則會根據(jù)系統(tǒng)設(shè)置自動鎖定屏幕。

參數(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è)備音量后對所有程序生效，退出程序系統(tǒng)仍然保持最后設(shè)定的音量值。

返回值：

void?: 無

平臺支持：

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

示例：

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

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

vibrate

設(shè)備振動

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

說明：

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

參數(shù)：

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

返回值：

void?: 無

平臺支持：

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

示例：

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

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

DeviceInfo

設(shè)備信息對象

屬性：

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

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

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

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

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。

平臺支持：

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。

平臺支持：

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平臺支持，表示設(shè)置應(yīng)用的屏幕亮度與系統(tǒng)屏幕亮度保持一致。

返回值：

void?: 無

平臺支持：

Android - 5.0+ (支持) :
應(yīng)用有獨(dú)立的亮度，設(shè)置應(yīng)用的屏幕亮度不會修改系統(tǒng)屏幕亮度，僅對當(dāng)前應(yīng)用在前臺運(yùn)行時有效，退出應(yīng)用后屏幕亮度切換回系統(tǒng)屏幕亮度。如果要保證應(yīng)用的屏幕亮度與系統(tǒng)屏幕亮度一致，可以設(shè)置值為 -1。
iOS - 9.0+ (支持) :
應(yīng)用沒有獨(dú)立的亮度，設(shè)置時會修改系統(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)前屏幕的寬、高信息，返回數(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": 豎屏反方向，屏幕正方向按順時針旋轉(zhuǎn)180°； "landscape-primary": 橫屏正方向，屏幕正方向按順時針旋轉(zhuǎn)90°； "landscape-secondary": 橫屏方向，屏幕正方向按順時針旋轉(zhuǎn)270°； "portrait": 豎屏正方向或反方向，根據(jù)設(shè)備重力感應(yīng)器自動調(diào)整； "landscape": 橫屏正方向或反方向，根據(jù)設(shè)備重力感應(yī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ù)：

無

返回值：

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。

平臺支持：

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: 蜂窩移動2G網(wǎng)絡(luò)
CONNECTION_CELL3G: 蜂窩移動3G網(wǎng)絡(luò)
CONNECTION_CELL4G: 蜂窩移動4G網(wǎng)絡(luò)
CONNECTION_CELL5G: 蜂窩移動5G網(wǎng)絡(luò)

方法：

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

平臺支持

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

CONNECTION_CELL4G

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

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

說明：

Number?類型

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

平臺支持

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

CONNECTION_CELL5G

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

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

說明：

Number?類型

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

平臺支持

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ò)類型

平臺支持：

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。

平臺支持：

Android - 4.4+ (支持) :
僅支持判斷WiFi情況下是否設(shè)置代理，無法判斷移動網(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"表示語言為簡體中文、地區(qū)為中國大陸。

平臺支持：

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

示例：

<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ù)。

平臺支持：

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ù)。

平臺支持：

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ù)。

平臺支持：

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包含的屬性存在差異，具體參考對應(yīng)的接口描述說明。

參數(shù)：

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

返回值：

void?: 無

DeviceFailCallback

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

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

參數(shù)：

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

返回值：

void?: 無

DeviceCompleteCallback

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

說明：

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

參數(shù)：

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

返回值：

void?: 無

總結(jié)

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

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

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

日韩av黄I国产麻豆传媒I国产91av视频在线观看I日韩一区二区三区在线看I美女国产在线I麻豆视频国产在线观看I成人黄色短片

编程问答

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

屬性：

方法：

對象：

回調(diào)方法：

權(quán)限：

imei

說明：

平臺支持：

示例：

imsi

說明：

平臺支持：

示例：

model

說明：

示例：

vendor

說明：

平臺支持：

示例：

uuid

說明：

平臺支持：

示例：

beep

說明：

參數(shù)：

返回值：

平臺支持：

示例：

dial

說明：

參數(shù)：

返回值：

平臺支持：

示例：

getInfo

說明：

參數(shù)：

返回值：

示例：

getOAID

說明：

參數(shù)：

返回值：

平臺支持：

示例：

getVAID

說明：

參數(shù)：

返回值：

平臺支持：

示例：

getAAID

說明：

參數(shù)：

返回值：

平臺支持：

示例：

getVolume

說明：

參數(shù)：

返回值：

平臺支持：

isWakelock

說明：

參數(shù)：

返回值：

setWakelock

說明：

參數(shù)：

返回值：

示例：

setVolume

說明：

參數(shù)：

返回值：