调用此属性获取设备的国际移动设备身份码。
如果设备不支持则返回空字符串。
如果设备存在多个身份码,则以“,”字符分割拼接,如“862470039452950,862470039452943”。
平台支持:
Android
- 2.2+
如果应用无法获取(如未获授权)则返回空字符串。
- 4.5+
(不支持)
iOS设备不支持获取imei值,返回空字符串。
//获取设备的国际移动设备身份码
function getIMEI(){
console.log("IMEI: "+plus.device.imei);
uni-app使用plus注意事项
设备的国际移动用户识别码
plus.device.imsi;
Array
[
String
]
此API将废弃,HBuilderX2.0.0以后版本使用
plus.device.getInfo
。
字符串数组类型,获取设备上插入SIM的国际移动设备身份码。
如果设备支持多卡模式则返回所有SIM身份码。
如果设备不支持或没有插入SIM卡则返回空数组。
平台支持:
Android
- 2.2+
如果设备没有插入SIM卡,则返回空数组。
- 4.5+
(不支持)
iOS设备不支持获取SIM卡信息,返回空数组。
//获取设备的国际移动用户识别码
function getIMSI(){
console.log("IMSI: " + plus.device.imsi);
uni-app使用plus注意事项
设备的型号
plus.device.model;
String
调用此属性获取设备的型号信息。
如果设备不支持则返回空字符串。
//获取设备的型号
function getModel(){
console.log("Model: " + plus.device.model);
uni-app使用plus注意事项
设备的生产厂商
plus.device.vendor;
String
调用此属性获取设备的生产厂商信息。
如果设备不支持则返回空字符串。
平台支持:
Android - 2.2+ (支持)
iOS - 4.3+ (支持)
//获取设备的生产厂商
function getVendor(){
console.log("Vendor: " + plus.device.vendor);
uni-app使用plus注意事项
设备的唯一标识
plus.device.uuid;
String
此API将废弃,HBuilderX2.0.0以后版本使用
plus.device.getInfo
。
调用此属性获取设备的唯一标识号。
平台支持:
Android
- 2.2+
与设备的imei号一致。
注意:如果无法获取设备imei则使用设备wifi的mac地址,如果无法获取设备mac地址则随机生成设备标识号(不同App在同一台设备上获取的值一致)。
- 4.5+
根据包名随机生成的设备标识号。注意:在设备重置后会重新生成。
//获取设备的唯一标识号
function getUUID(){
console.log("UUID: "+plus.device.uuid);
uni-app使用plus注意事项
发出蜂鸣声
void plus.device.beep(times);
调用此方法使得设备发出蜂鸣声。
-
times:
Number
可选 蜂鸣声重复的次数,默认发出一次蜂鸣声
: 无
平台支持:
-
Android
- 2.2+
播放系统设置中指定的默认通知铃声
- 4.3+
忽略times参数,播放系统的通知铃声
//发出蜂鸣声
function beep(){
plus.device.beep( 3 );
uni-app使用plus注意事项
void plus.device.dial(number, confirm);
调用系统程序拨打电话。
-
number:
String
必选 要拨打的电话号码
-
confirm:
Boolean
可选 是否需要用户确认后开始拨打电话
设置为true表示打开系统拨打电话界面,需用户点击拨号按钮后才开始拨打电话,false则无需确认直接拨打电话,默认值为true。
: 无
平台支持:
-
Android
- 2.2+
拨打电话需添加以下权限:
"<uses-permission android:name="android.permission.CALL_PHONE"/>"
更多权限相关说明请参考:
https://ask.dcloud.net.cn/article/36982
。
- 5.1+
忽略confirm参数,调用直接拨打电话。
//拨打电话
function dial() {
plus.device.dial("10086", false);
uni-app使用plus注意事项
获取设备信息
void plus.device.getInfo(options);
包括国际移动设备身份码、国际移动用户识别码、设备的唯一标识等信息。
Android平台调用此方法需要申请访问设备标识(部分设备提示为拨打电话)权限,详情参考
https://ask.dcloud.net.cn/article/36075
。
options参数为json类型,包含以下属性:
-
success:
DeviceSuccessCallback
可选 获取设备信息成功回调函数
回调函数参数event对象类型为
DeviceInfo
。
-
fail:
DeviceFailCallback
可选 获取设备信息失败回调函数
-
complete:
DeviceCompleteCallback
可选 获取设备信息操作完成回调函数
调用成功或失败都会触发此回调。
: 无
示例:
// 获取设备信息
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));
uni-app使用plus注意事项
获取匿名设备标识符
void plus.device.getOAID(options);
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一致。
: 无
平台支持: