當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

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

發布時間：2023/12/16 编程问答 34 豆豆

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

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

屬性：

imei: 設備的國際移動設備身份碼
imsi: 設備的國際移動用戶識別碼
model: 設備的型號
vendor: 設備的生產廠商
uuid: 設備的唯一標識

方法：

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

對象：

DeviceInfo: 設備信息對象
screen: Screen模塊管理設備屏幕信息
display: Display模塊管理應用可使用的顯示區域信息
networkinfo: networkinfo模塊用于獲取網絡信息
os: OS模塊管理操作系統信息

回調方法：

DeviceSuccessCallback: 成功回調函數
DeviceFailCallback: 失敗回調函數
DeviceCompleteCallback: 操作完成回調函數

權限：

5+功能模塊（permissions）

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

imei

設備的國際移動設備身份碼

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

說明：

String?類型只讀屬性

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

平臺支持：

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

示例：

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

uni-app使用plus注意事項

imsi

設備的國際移動用戶識別碼

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

說明：

Array[String] 類型只讀屬性

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

平臺支持：

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

示例：

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

uni-app使用plus注意事項

model

設備的型號

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

說明：

String?類型只讀屬性

調用此屬性獲取設備的型號信息。如果設備不支持則返回空字符串。

示例：

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

uni-app使用plus注意事項

vendor

設備的生產廠商

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

說明：

String?類型只讀屬性

調用此屬性獲取設備的生產廠商信息。如果設備不支持則返回空字符串。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

uuid

設備的唯一標識

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

說明：

String?類型只讀屬性

此API將廢棄，HBuilderX2.0.0以后版本使用plus.device.getInfo。
調用此屬性獲取設備的唯一標識號。

平臺支持：

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

示例：

<code> //獲取設備的唯一標識號 function getUUID(){console.log("UUID: "+plus.device.uuid); }</code>

uni-app使用plus注意事項

beep

發出蜂鳴聲

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

說明：

調用此方法使得設備發出蜂鳴聲。

參數：

times:?(?Number?) 可選?蜂鳴聲重復的次數，默認發出一次蜂鳴聲

返回值：

void?: 無

平臺支持：

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

示例：

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

uni-app使用plus注意事項

dial

撥打電話

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

說明：

調用系統程序撥打電話。

參數：

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

返回值：

void?: 無

平臺支持：

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

示例：

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

uni-app使用plus注意事項

getInfo

獲取設備信息

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

說明：

包括國際移動設備身份碼、國際移動用戶識別碼、設備的唯一標識等信息。
Android平臺調用此方法需要申請訪問設備標識（部分設備提示為撥打電話）權限，詳情參考獲取設備信息（imei、imsi、uuid）的調整使用plus.device.getInfo方法的說明 - DCloud問答。

參數：

options參數為json類型，包含以下屬性：

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

返回值：

void?: 無

示例：

<code> // 獲取設備信息 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注意事項

getOAID

獲取匿名設備標識符

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

說明：

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

參數：

options參數為json類型，包含以下屬性：

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

返回值：

void?: 無

平臺支持：

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

示例：

<code> // 獲取匿名設備標識符 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注意事項

getVAID

獲取開發者匿名設備標識符

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

說明：

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

參數：

options參數為json類型，包含以下屬性：

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

返回值：

void?: 無

平臺支持：

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

示例：

<code> // 獲取開發者匿名設備標識符 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注意事項

getAAID

獲取應用匿名設備標識符

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

說明：

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

參數：

options參數為json類型，包含以下屬性：

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

返回值：

void?: 無

平臺支持：

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

示例：

<code> // 獲取應用匿名設備標識符 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注意事項

getVolume

獲取設備的系統音量

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

說明：

系統音量值范圍為0到1，0表示靜音，1表示最大音量值。

參數：

無

返回值：

Number?: 系統的音量值

平臺支持：

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

isWakelock

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

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

說明：

調用此方法獲取程序是否一致保持喚醒狀態。

參數：

無

返回值：

Boolean?: 返回ture表示程序已設置為一直保持喚醒狀態，返回false表示程序未設置為一直保持喚醒狀態。

setWakelock

設置應用是否保持喚醒（屏幕常亮）狀態

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

說明：

調用此方法設置應用是否一直保持喚醒狀態，保持喚醒狀態將會導致程序屏幕常亮、系統不會自動鎖屏，從而導致消耗更多的電量。若未設置一直保持喚醒狀態則會根據系統設置自動鎖定屏幕。

參數：

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

返回值：

void?: 無

示例：

<code> // 設置應用保持喚醒（屏幕常亮）狀態 function setWakelock(){plus.device.setWakelock(true); }</code>

uni-app使用plus注意事項

setVolume

設置設備的系統音量

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

說明：

調用此方法調節設備的系統音量。

參數：

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

返回值：

void?: 無

平臺支持：

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

示例：

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

uni-app使用plus注意事項

vibrate

設備振動

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

說明：

調用此方法使得設備振動。

參數：

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

返回值：

void?: 無

平臺支持：

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

示例：

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

uni-app使用plus注意事項

DeviceInfo

設備信息對象

屬性：

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

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

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

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

screen

Screen模塊管理設備屏幕信息

<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: 設備屏幕水平方向的密度
dpiY: 設備屏幕垂直方向的密度
height: 屏幕高度物理分辨率
width: 屏幕寬度物理分辨率
resolutionHeight: 屏幕高度邏輯分辨率
resolutionWidth: 屏幕寬度邏輯分辨率
scale: 邏輯分辨率與物理分辨率的縮放比例

方法：

setBrightness: 設置屏幕亮度
getBrightness: 獲取屏幕亮度值
getCurrentSize: 獲取當前屏幕信息
lockOrientation: 鎖定屏幕方向
unlockOrientation: 解除鎖定屏幕方向

dpiX

設備屏幕水平方向的密度

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

說明：

Number?類型只讀屬性

設備屏幕的密度為每英寸所顯示的像素點數，密度越高顯示清晰度越高，單位為dpi。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

dpiY

設備屏幕垂直方向的密度

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

說明：

Number?類型只讀屬性

設備屏幕的密度為每英寸所顯示的像素點數，密度越高顯示清晰度越高，單位為dpi。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

height

屏幕高度物理分辨率

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

說明：

Number?類型只讀屬性

單位為px，設備屏幕的實際物理分辨率。物理分辨率跟屏幕密度相關，通常建議使用邏輯分辨率。

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

示例：

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

uni-app使用plus注意事項

setBrightness

設置屏幕亮度

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

說明：

調用此方法調節設備屏幕亮度。

參數：

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

返回值：

void?: 無

平臺支持：

Android - 5.0+ (支持) :
應用有獨立的亮度，設置應用的屏幕亮度不會修改系統屏幕亮度，僅對當前應用在前臺運行時有效，退出應用后屏幕亮度切換回系統屏幕亮度。如果要保證應用的屏幕亮度與系統屏幕亮度一致，可以設置值為 -1。
iOS - 9.0+ (支持) :
應用沒有獨立的亮度，設置時會修改系統屏幕亮度。不支持設置值為 -1。

示例：

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

uni-app使用plus注意事項

getBrightness

獲取屏幕亮度值

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

說明：

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

參數：

無

返回值：

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

示例：

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

uni-app使用plus注意事項

getCurrentSize

獲取當前屏幕信息

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

說明：

當前屏幕的寬、高信息，返回數據包括以下屬性：

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

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

參數：

無

返回值：

JSON?: 屏幕的寬、高信息

示例：

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

uni-app使用plus注意事項

lockOrientation

鎖定屏幕方向

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

說明：

鎖定屏幕方向后屏幕只能按鎖定的屏幕方向顯示，關閉當前頁面后仍然有效。可再次調用此方法修改屏幕鎖定方向或調用unlockOrientation()方法恢復到應用的默認值。

參數：

orientation:?(?String?) 必選?要鎖定的屏幕方向值
鎖定屏幕方向可取以下值： "portrait-primary": 豎屏正方向； "portrait-secondary": 豎屏反方向，屏幕正方向按順時針旋轉180°； "landscape-primary": 橫屏正方向，屏幕正方向按順時針旋轉90°； "landscape-secondary": 橫屏方向，屏幕正方向按順時針旋轉270°； "portrait": 豎屏正方向或反方向，根據設備重力感應器自動調整； "landscape": 橫屏正方向或反方向，根據設備重力感應器自動調整；

返回值：

void?: 無

示例：

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

uni-app使用plus注意事項

unlockOrientation

解除鎖定屏幕方向

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

說明：

解除鎖定屏幕方向后將恢復應用默認的屏幕顯示方向（通常為應用打包發布時設置的方向）。

參數：

無

返回值：

void?: 無

示例：

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

uni-app使用plus注意事項

display

Display模塊管理應用可使用的顯示區域信息

屬性：

resolutionHeight: 應用可使用的屏幕高度邏輯分辨率
resolutionWidth: 應用可使用的屏幕寬度邏輯分辨率

resolutionHeight

應用可使用的屏幕高度邏輯分辨率

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

說明：

Number?類型只讀屬性

設備屏幕區域包括系統狀態欄顯示區域和應用顯示區域，display獲取的是應用顯示區域的邏輯分辨率，單位為px。如果需要獲取實際分辨率則需要乘以比例值scale。

平臺支持：

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

resolutionWidth

應用可使用的屏幕寬度邏輯分辨率

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

說明：

Number?類型只讀屬性

networkinfo

networkinfo模塊用于獲取網絡信息

<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: 網絡連接狀態未知
CONNECTION_NONE: 未連接網絡
CONNECTION_ETHERNET: 有線網絡
CONNECTION_WIFI: 無線WIFI網絡
CONNECTION_CELL2G: 蜂窩移動2G網絡
CONNECTION_CELL3G: 蜂窩移動3G網絡
CONNECTION_CELL4G: 蜂窩移動4G網絡
CONNECTION_CELL5G: 蜂窩移動5G網絡

方法：

getCurrentType: 獲取設備當前連接的網絡類型
isSetProxy: 獲取當前網絡是否設置代理

平臺支持

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

CONNECTION_CELL4G

蜂窩移動4G網絡

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

說明：

Number?類型

網絡狀態常量，當前設備連接到蜂窩移動4G網絡，固定值為6。

平臺支持

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

CONNECTION_CELL5G

蜂窩移動5G網絡

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

說明：

Number?類型

網絡狀態常量，當前設備連接到蜂窩移動5G網絡，固定值為7。

平臺支持

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

getCurrentType

獲取設備當前連接的網絡類型

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

說明：

獲取當前設備連接的網絡類型，返回值為網絡類型常量，可取值CONNECTION_*常量。

參數：

無

返回值：

Number?: 設備當前網絡類型

平臺支持：

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

示例：

<code> // 獲取設備當前連接的網絡類型 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注意事項

isSetProxy

獲取當前網絡是否設置代理

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

說明：

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

參數：

無

返回值：

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

平臺支持：

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

os

OS模塊管理操作系統信息

屬性：

language: 系統語言信息
name: 系統的名稱
vendor: 系統的供應商信息
version: 系統版本信息

language

系統語言信息

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

說明：

String?類型只讀屬性

獲取當前操作系統設置的系統語言，字符串類型數據，格式為"語言-地區"，如"zh-CN"表示語言為簡體中文、地區為中國大陸。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

name

系統的名稱

說明：

String?類型只讀屬性

獲取當前操作系統的名稱，字符串類型數據。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

vendor

系統的供應商信息

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

說明：

String?類型只讀屬性

獲取當前操作系統的供應商名稱，字符串類型數據。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

version

系統版本信息

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

說明：

String?類型只讀屬性

獲取當前操作系統的版本信息，字符串類型數據。

平臺支持：

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

示例：

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

uni-app使用plus注意事項

DeviceSuccessCallback

成功回調函數

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

說明：

不同接口觸發的成功回調參數event包含的屬性存在差異，具體參考對應的接口描述說明。

參數：

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

返回值：

void?: 無

DeviceFailCallback

失敗回調函數

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

參數：

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

返回值：

void?: 無

DeviceCompleteCallback

操作完成回調函數

說明：

調用成功或失敗都會觸發此回調。

參數：

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

返回值：

void?: 無

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

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