Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。
属性：
方法：
对象：
回调方法：
权限：
5+功能模块（permissions）
imei
设备的国际移动设备身份码
说明：
String 类型 只读属性
此API将废弃，HBuilderX2.0.0以后版本使用plus.device.getInfo。
调用此属性获取设备的国际移动设备身份码。 如果设备不支持则返回空字符串。 如果设备存在多个身份码，则以“,”字符分割拼接，如“862470039452950,862470039452943”。
平台支持：
- Android - 2.2+ (支持) :
如果应用无法获取（如未获授权）则返回空字符串。
- iOS - 4.5+ (不支持) :
iOS设备不支持获取imei值，返回空字符串。
示例：
uni-app使用plus注意事项
imsi
设备的国际移动用户识别码
说明：
Array[String] 类型 只读属性
此API将废弃，HBuilderX2.0.0以后版本使用plus.device.getInfo。
字符串数组类型，获取设备上插入SIM的国际移动设备身份码。 如果设备支持多卡模式则返回所有SIM身份码。 如果设备不支持或没有插入SIM卡则返回空数组。
平台支持：
- Android - 2.2+ (支持) :
如果设备没有插入SIM卡，则返回空数组。
- iOS - 4.5+ (不支持) :
iOS设备不支持获取SIM卡信息，返回空数组。
示例：
uni-app使用plus注意事项
model
设备的型号
说明：
String 类型 只读属性
调用此属性获取设备的型号信息。 如果设备不支持则返回空字符串。
示例：
uni-app使用plus注意事项
vendor
设备的生产厂商
说明：
String 类型 只读属性
调用此属性获取设备的生产厂商信息。 如果设备不支持则返回空字符串。
平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例：
uni-app使用plus注意事项
uuid
设备的唯一标识
说明：
String 类型 只读属性
此API将废弃，HBuilderX2.0.0以后版本使用plus.device.getInfo。
调用此属性获取设备的唯一标识号。
平台支持：
示例：
uni-app使用plus注意事项
beep
发出蜂鸣声
说明：
调用此方法使得设备发出蜂鸣声。
参数：
- times: ( Number ) 可选 蜂鸣声重复的次数，默认发出一次蜂鸣声
返回值：
void : 无
平台支持：
- Android - 2.2+ (支持) :
播放系统设置中指定的默认通知铃声
- iOS - 4.3+ (支持) :
忽略times参数，播放系统的通知铃声
示例：
uni-app使用plus注意事项
dial
拨打电话
说明：
调用系统程序拨打电话。
参数：
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
getInfo
获取设备信息
说明：
包括国际移动设备身份码、国际移动用户识别码、设备的唯一标识等信息。
Android平台调用此方法需要申请访问设备标识（部分设备提示为拨打电话）权限，详情参考获取设备信息（imei、imsi、uuid）的调整使用plus.device.getInfo方法的说明 - DCloud问答。
参数：
options参数为json类型，包含以下属性：
返回值：
void : 无
示例：
uni-app使用plus注意事项
getOAID
获取匿名设备标识符
说明：
HBuilderX2.4.0+版本新增支持。
Android10以前获取设备标识（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用户隐私且需用户授权，Android10+系统不再支持获取设备标识信息。为解决此问题移动安全联盟联合各手机厂商推出移动智能设备标识公共服务平台提供补充设备标识体系，包括匿名设备标识符（OAID）、开发者匿名设备标识符（VAID）和应用匿名设备标识符（AAID）。
匿名设备标识符（OAID）最长为64位字符串，所有应用获取的值相同，可用于个性化推荐、广告等业务。 系统首次启动后生成，用户手动重置、恢复出厂设置、设备商重置、被刷机等操作会重置此标识。
参数：
options参数为json类型，包含以下属性：
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
getVAID
获取开发者匿名设备标识符
说明：
HBuilderX2.4.0+版本新增支持。
Android10以前获取设备标识（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用户隐私且需用户授权，Android10+系统不再支持获取设备标识信息。为解决此问题移动安全联盟联合各手机厂商推出移动智能设备标识公共服务平台提供补充设备标识体系，包括匿名设备标识符（OAID）、开发者匿名设备标识符（VAID）和应用匿名设备标识符（AAID）。
开发者匿名设备标识符（VAID）最长为64位字符串，同一开发者不同应用获取的值相同，可用于同一开发者不同应用之间的推荐等。 在应用安装时生成，用户恢复出厂设置、卸载所有开发商应用、设备商重置、被刷机等操作会重置此标识。
参数：
options参数为json类型，包含以下属性：
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
getAAID
获取应用匿名设备标识符
说明：
HBuilderX2.4.0+版本新增支持。
Android10以前获取设备标识（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用户隐私且需用户授权，Android10+系统不再支持获取设备标识信息。为解决此问题移动安全联盟联合各手机厂商推出移动智能设备标识公共服务平台提供补充设备标识体系，包括匿名设备标识符（OAID）、开发者匿名设备标识符（VAID）和应用匿名设备标识符（AAID）。
应用匿名设备标识符（AAID）最长为64位字符串，每个应用获取的值都不相同，可用于用户统计等。 在应用安装时生成，用户恢复出厂设置、卸载应用、清空应用数据、设备商重置等操作会重置此标识。
参数：
options参数为json类型，包含以下属性：
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
getVolume
获取设备的系统音量
说明：
系统音量值范围为0到1，0表示静音，1表示最大音量值。
参数：
无
返回值：
Number : 系统的音量值
平台支持：
- Android - ALL (支持) :
Android平台获取的是系统多媒体音量。
- iOS - ALL (支持)
isWakelock
获取程序是否一直保持唤醒（屏幕常亮）状态
说明：
调用此方法获取程序是否一致保持唤醒状态。
参数：
无
返回值：
Boolean : 返回ture表示程序已设置为一直保持唤醒状态，返回false表示程序未设置为一直保持唤醒状态。
setWakelock
设置应用是否保持唤醒（屏幕常亮）状态
说明：
调用此方法设置应用是否一直保持唤醒状态，保持唤醒状态将会导致程序屏幕常亮、系统不会自动锁屏，从而导致消耗更多的电量。若未设置一直保持唤醒状态则会根据系统设置自动锁定屏幕。
参数：
返回值：
void : 无
示例：
uni-app使用plus注意事项
setVolume
设置设备的系统音量
说明：
调用此方法调节设备的系统音量。
参数：
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
vibrate
设备振动
说明：
调用此方法使得设备振动。
参数：
- milliseconds: ( Number ) 必选 设备振动持续的时间
数值类型，单位为ms，默认为500ms。
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
DeviceInfo
设备信息对象
属性：
- imei: (String 类型 )设备的国际移动设备身份码
如果设备不支持或无法获取（如用户未授权）则返回空字符串。 如果设备存在多个身份码，则以“,”字符分割拼接，如“862470039452950,862470039452943”。
平台支持
- Android - ALL (支持) :
- iOS - ALL (不支持) :
无法获取设备身份码，返回空字符串。
- imsi: (Array[String] 类型 )设备的国际移动用户识别码
字符串数组类型，获取设备上插入SIM的国际移动设备身份码。 如果设备支持多卡模式则返回所有SIM身份码。 如果设备不支持或没有插入SIM卡则返回空数组。
平台支持
- uuid: (String 类型 )设备标识
设备的唯一标识号。
平台支持
screen
Screen模块管理设备屏幕信息
属性：
方法：
dpiX
设备屏幕水平方向的密度
说明：
Number 类型 只读属性
设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例：
uni-app使用plus注意事项
dpiY
设备屏幕垂直方向的密度
说明：
Number 类型 只读属性
设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例：
uni-app使用plus注意事项
height
屏幕高度物理分辨率
说明：
Number 类型 只读属性
单位为px，设备屏幕的实际物理分辨率。 物理分辨率跟屏幕密度相关，通常建议使用逻辑分辨率。
示例：
uni-app使用plus注意事项
width
屏幕宽度物理分辨率
说明：
Number 类型 只读属性
单位为px，设备屏幕的实际物理分辨率。 物理分辨率跟屏幕密度相关，通常建议使用逻辑分辨率。
示例：
uni-app使用plus注意事项
resolutionHeight
屏幕高度逻辑分辨率
说明：
Number 类型 只读属性
单位为px, 逻辑分辨率为物理分辨率除以缩放比例scale取整。 取整操作可能出现精度丢失，对精度要求高时可使用物理分辨率和scal计算。
示例：
uni-app使用plus注意事项
resolutionWidth
屏幕宽度逻辑分辨率
说明：
Number 类型 只读属性
单位为px，逻辑分辨率为物理分辨率除以缩放比例scale取整。 取整操作可能出现精度丢失，对精度要求高时可使用物理分辨率和scal计算。
示例：
uni-app使用plus注意事项
scale
逻辑分辨率与物理分辨率的缩放比例
说明：
Number 类型 只读属性
由于设备屏幕密度不同，在html页面中使用的像素值都是使用逻辑分辨率。 而逻辑分辨率与设备的实际物理分辨率存在一定的比例关系，实际物理分辨率=逻辑分辨率*比例。
平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例：
uni-app使用plus注意事项
setBrightness
设置屏幕亮度
说明：
调用此方法调节设备屏幕亮度。
参数：
返回值：
void : 无
平台支持：
示例：
uni-app使用plus注意事项
getBrightness
获取屏幕亮度值
说明：
屏幕亮度值范围为0到1，0表示最低亮度值，1表示最高亮度值。
参数：
无
返回值：
Number : 返回程序的屏幕亮度值
示例：
uni-app使用plus注意事项
getCurrentSize
获取当前屏幕信息
说明：
当前屏幕的宽、高信息，返回数据包括以下属性：
- "height" - 屏幕物理分辨率高度，单位为px
- "width" - 屏幕物理分辨率宽度，单位为px
- "resolutionHeight" - 屏幕逻辑分辨率高度，单位为px
- "resolutionWidth" - 屏幕逻辑分辨率宽度，单位为px
注意：HBuilderX2.6.9+版本支持。
参数：
无
返回值：
JSON : 屏幕的宽、高信息
示例：
uni-app使用plus注意事项
lockOrientation
锁定屏幕方向
说明：
锁定屏幕方向后屏幕只能按锁定的屏幕方向显示，关闭当前页面后仍然有效。 可再次调用此方法修改屏幕锁定方向或调用unlockOrientation()方法恢复到应用的默认值。
参数：
返回值：
void : 无
示例：
uni-app使用plus注意事项
unlockOrientation
解除锁定屏幕方向
说明：
解除锁定屏幕方向后将恢复应用默认的屏幕显示方向（通常为应用打包发布时设置的方向）。
参数：
无
返回值：
void : 无
示例：
uni-app使用plus注意事项
display
Display模块管理应用可使用的显示区域信息
属性：
resolutionHeight
应用可使用的屏幕高度逻辑分辨率
说明：
Number 类型 只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。
平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
resolutionWidth
应用可使用的屏幕宽度逻辑分辨率
说明：
Number 类型 只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。
networkinfo
networkinfo模块用于获取网络信息
常量：
方法：
CONNECTION_UNKNOW
网络连接状态未知
说明：
Number 类型
网络状态常量，表示当前设备网络状态未知，固定值为0。
CONNECTION_NONE
未连接网络
说明：
Number 类型
网络状态常量，当前设备网络未连接网络，固定值为1。
CONNECTION_ETHERNET
有线网络
说明：
Number 类型
网络状态常量，当前设备连接到有线网络，固定值为2。
CONNECTION_WIFI
无线WIFI网络
说明：
Number 类型
网络状态常量，当前设备连接到无线WIFI网络，固定值为3。
CONNECTION_CELL2G
蜂窝移动2G网络
说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动2G网络，固定值为4。
CONNECTION_CELL3G
蜂窝移动3G网络
说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动3G网络，固定值为5。
平台支持
- Android - 2.2+ (支持)
- iOS - 7.0+ (支持)
CONNECTION_CELL4G
蜂窝移动4G网络
说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动4G网络，固定值为6。
平台支持
- Android - 2.2+ (支持)
- iOS - 7.0+ (支持)
CONNECTION_CELL5G
蜂窝移动5G网络
说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动5G网络，固定值为7。
平台支持
- Android - 2.2+ (支持)
- iOS - 14.0+ (支持)
getCurrentType
获取设备当前连接的网络类型
说明：
获取当前设备连接的网络类型，返回值为网络类型常量，可取值CONNECTION_*常量。
参数：
无
返回值：
Number : 设备当前网络类型
平台支持：
- Android - 2.3+ (支持)
- iOS - 7.0+ (支持)
示例：
uni-app使用plus注意事项
isSetProxy
获取当前网络是否设置代理
说明：
注意：HBuilderX3.0.0及以上版本支持。
参数：
无
返回值：
Boolean : 如果设置了代理则返回true，否则返回false。
平台支持：
os
OS模块管理操作系统信息
属性：
language
系统语言信息
说明：
String 类型 只读属性
获取当前操作系统设置的系统语言，字符串类型数据，格式为"语言-地区"，如"zh-CN"表示语言为简体中文、地区为中国大陆。
平台支持：
示例：
uni-app使用plus注意事项
name
系统的名称
说明：
String 类型 只读属性
获取当前操作系统的名称，字符串类型数据。
平台支持：
- Android - 2.2+ (支持) :
返回字符串“Android”
- iOS - 4.3+ (支持) :
返回字符串“iOS”
示例：
uni-app使用plus注意事项
vendor
系统的供应商信息
说明：
String 类型 只读属性
获取当前操作系统的供应商名称，字符串类型数据。
平台支持：
- Android - 2.2+ (支持) :
返回字符串“Google”
- iOS - 4.3+ (支持) :
返回字符串“Apple”
示例：
uni-app使用plus注意事项
version
系统版本信息
说明：
String 类型 只读属性
获取当前操作系统的版本信息，字符串类型数据。
平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
示例：
uni-app使用plus注意事项
DeviceSuccessCallback
成功回调函数
说明：
不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。
参数：
返回值：
void : 无
DeviceFailCallback
失败回调函数
参数：
返回值：
void : 无
DeviceCompleteCallback
操作完成回调函数
说明：
调用成功或失败都会触发此回调。
参数：
返回值：
void : 无
发表于 2023-2-16 18:54:54
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
照妖镜
