宜信同城网交流论坛技术专版技术专区Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等 ...Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等。通过plus.dev ...

admin 发表于 2023-2-16 18:54:54

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

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.imei">imei</a>: 设备的国际移动设备身份码</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.imsi">imsi</a>: 设备的国际移动用户识别码</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.model">model</a>: 设备的型号</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.vendor">vendor</a>: 设备的生产厂商</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.uuid">uuid</a>: 设备的唯一标识</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.beep">beep</a>: 发出蜂鸣声</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.dial">dial</a>: 拨打电话</li><li><ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.getInfo">getInfo</a>: 获取设备信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.getOAID">getOAID</a>: 获取匿名设备标识符</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.getVAID">getVAID</a>: 获取开发者匿名设备标识符</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.getAAID">getAAID</a>: 获取应用匿名设备标识符</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.getVolume">getVolume</a>: 获取设备的系统音量</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.isWakelock">isWakelock</a>: 获取程序是否一直保持唤醒（屏幕常亮）状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.setWakelock">setWakelock</a>: 设置应用是否保持唤醒（屏幕常亮）状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.setVolume">setVolume</a>: 设置设备的系统音量</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.vibrate">vibrate</a>: 设备振动</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceInfo">DeviceInfo</a>: 设备信息对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen">screen</a>: Screen模块管理设备屏幕信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.display">display</a>: Display模块管理应用可使用的显示区域信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo">networkinfo</a>: networkinfo模块用于获取网络信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.os">os</a>: OS模块管理操作系统信息</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceSuccessCallback">DeviceSuccessCallback</a>: 成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceFailCallback">DeviceFailCallback</a>: 失败回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceCompleteCallback">DeviceCompleteCallback</a>: 操作完成回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Device": {
"description": "设备信息"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">imei</h1>
设备的国际移动设备身份码
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.imei;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
此API将废弃，HBuilderX2.0.0以后版本使用<ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.getInfo">plus.device.getInfo</a>。 调用此属性获取设备的国际移动设备身份码。如果设备不支持则返回空字符串。如果设备存在多个身份码，则以“,”字符分割拼接，如“862470039452950,862470039452943”。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 如果应用无法获取（如未获授权）则返回空字符串。 </li><li>iOS - 4.5+ (不支持) : iOS设备不支持获取imei值，返回空字符串。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//获取设备的国际移动设备身份码
function getIMEI(){
console.log("IMEI: "+plus.device.imei);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">imsi</h1>
设备的国际移动用户识别码
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.imsi;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Array 类型只读属性
此API将废弃，HBuilderX2.0.0以后版本使用<ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.getInfo">plus.device.getInfo</a>。 字符串数组类型，获取设备上插入SIM的国际移动设备身份码。如果设备支持多卡模式则返回所有SIM身份码。如果设备不支持或没有插入SIM卡则返回空数组。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 如果设备没有插入SIM卡，则返回空数组。 </li><li>iOS - 4.5+ (不支持) : iOS设备不支持获取SIM卡信息，返回空数组。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//获取设备的国际移动用户识别码
function getIMSI(){
console.log("IMSI: " + plus.device.imsi);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">model</h1>
设备的型号
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.model;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
调用此属性获取设备的型号信息。如果设备不支持则返回空字符串。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//获取设备的型号
function getModel(){
console.log("Model: " + plus.device.model);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">vendor</h1>
设备的生产厂商
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.vendor;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
调用此属性获取设备的生产厂商信息。如果设备不支持则返回空字符串。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//获取设备的生产厂商
function getVendor(){
console.log("Vendor: " + plus.device.vendor);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">uuid</h1>
设备的唯一标识
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.uuid;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
此API将废弃，HBuilderX2.0.0以后版本使用<ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.getInfo">plus.device.getInfo</a>。 调用此属性获取设备的唯一标识号。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 与设备的imei号一致。注意：如果无法获取设备imei则使用设备wifi的mac地址，如果无法获取设备mac地址则随机生成设备标识号（不同App在同一台设备上获取的值一致）。 </li><li>iOS - 4.5+ (支持) : 根据包名随机生成的设备标识号。注意：在设备重置后会重新生成。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//获取设备的唯一标识号
function getUUID(){
console.log("UUID: "+plus.device.uuid);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">beep</h1>
发出蜂鸣声
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.device.beep(times);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法使得设备发出蜂鸣声。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>times: ( Number ) 可选 蜂鸣声重复的次数，默认发出一次蜂鸣声 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 播放系统设置中指定的默认通知铃声 </li><li>iOS - 4.3+ (支持) : 忽略times参数，播放系统的通知铃声 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//发出蜂鸣声
function beep(){
plus.device.beep( 3 );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">dial</h1>
拨打电话
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.device.dial(number, confirm);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用系统程序拨打电话。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>number: ( String ) 必选 要拨打的电话号码 </li><li>confirm: ( Boolean ) 可选 是否需要用户确认后开始拨打电话 设置为true表示打开系统拨打电话界面，需用户点击拨号按钮后才开始拨打电话，false则无需确认直接拨打电话，默认值为true。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 拨打电话需添加以下权限：
<ul style="margin-left:2em;"><li>"<uses-permission android:name="android.permission.CALL_PHONE"/>"</li></ul> 更多权限相关说明请参考：<ahref="https://ask.dcloud.net.cn/article/36982">Android平台云端打包权限配置 - DCloud问答</a>。 </li><li>iOS - 5.1+ (支持) : 忽略confirm参数，调用直接拨打电话。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
//拨打电话
function dial() {
plus.device.dial("10086", false);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getInfo</h1>
获取设备信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.device.getInfo(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
包括国际移动设备身份码、国际移动用户识别码、设备的唯一标识等信息。 Android平台调用此方法需要申请访问设备标识（部分设备提示为拨打电话）权限，详情参考<ahref="https://ask.dcloud.net.cn/article/36075">获取设备信息（imei、imsi、uuid）的调整使用plus.device.getInfo方法的说明 - DCloud问答</a>。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceSuccessCallback">DeviceSuccessCallback</a> ) 可选 获取设备信息成功回调函数 回调函数参数event对象类型为<ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.DeviceInfo">DeviceInfo</a>。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceFailCallback">DeviceFailCallback</a> ) 可选 获取设备信息失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceCompleteCallback">DeviceCompleteCallback</a> ) 可选 获取设备信息操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getOAID</h1>
获取匿名设备标识符
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.device.getOAID(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
HBuilderX2.4.0+版本新增支持。 Android10以前获取设备标识（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用户隐私且需用户授权，Android10+系统不再支持获取设备标识信息。为解决此问题移动安全联盟联合各手机厂商推出<ahref="http://www.msa-alliance.cn/col.jsp?id=120">移动智能设备标识公共服务平台</a>提供补充设备标识体系，包括匿名设备标识符（OAID）、开发者匿名设备标识符（VAID）和应用匿名设备标识符（AAID）。 匿名设备标识符（OAID）最长为64位字符串，所有应用获取的值相同，可用于个性化推荐、广告等业务。系统首次启动后生成，用户手动重置、恢复出厂设置、设备商重置、被刷机等操作会重置此标识。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceSuccessCallback">DeviceSuccessCallback</a> ) 可选 获取匿名设备标识成功回调函数 回调函数参数event对象类型为json，包含oaid属性保存获取的匿名设备标识符。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceFailCallback">DeviceFailCallback</a> ) 可选 获取匿名设备标识失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceCompleteCallback">DeviceCompleteCallback</a> ) 可选 获取匿名设备标识操作完成回调函数 调用成功或失败都会触发此回调，成功时回调参数与DeviceSuccessCallback一致，失败时回调参数与DeviceCompleteCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 10+ (支持) : 仅在华为、OPPO、VIVO、小米、联想等设备支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getVAID</h1>
获取开发者匿名设备标识符
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.device.getVAID(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
HBuilderX2.4.0+版本新增支持。 Android10以前获取设备标识（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用户隐私且需用户授权，Android10+系统不再支持获取设备标识信息。为解决此问题移动安全联盟联合各手机厂商推出<ahref="http://www.msa-alliance.cn/col.jsp?id=120">移动智能设备标识公共服务平台</a>提供补充设备标识体系，包括匿名设备标识符（OAID）、开发者匿名设备标识符（VAID）和应用匿名设备标识符（AAID）。 开发者匿名设备标识符（VAID）最长为64位字符串，同一开发者不同应用获取的值相同，可用于同一开发者不同应用之间的推荐等。在应用安装时生成，用户恢复出厂设置、卸载所有开发商应用、设备商重置、被刷机等操作会重置此标识。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceSuccessCallback">DeviceSuccessCallback</a> ) 可选 获取开发者匿名设备标识成功回调函数 回调函数参数event对象类型为json，包含vaid属性保存获取的开发者匿名设备标识符。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceFailCallback">DeviceFailCallback</a> ) 可选 获取开发者匿名设备标识失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/device.html#plus.device.DeviceCompleteCallback">DeviceCompleteCallback</a> ) 可选 获取开发者匿名设备标识操作完成回调函数 调用成功或失败都会触发此回调，成功时回调参数与DeviceSuccessCallback一致，失败时回调参数与DeviceCompleteCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 10+ (支持) : 仅在华为、OPPO、VIVO、小米、联想等设备支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getAAID</h1>
获取应用匿名设备标识符
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.device.getAAID(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
HBuilderX2.4.0+版本新增支持。 Android10以前获取设备标识（如IMEI、IMSI、Wi-Fi MAC地址等）涉及用户隐私且需用户授权，Android10+系统不再支持获取设备标识信息。为解决此问题移动安全联盟联合各手机厂商推出<ahref="http://www.msa-alliance.cn/col.jsp?id=120">移动智能设备标识公共服务平台</a>提供补充设备标识体系，包括匿名设备标识符（OAID）、开发者匿名设备标识符（VAID）和应用匿名设备标识符（AAID）。 应用匿名设备标识符（AAID）最长为64位字符串，每个应用获取的值都不相同，可用于用户统计等。在应用安装时生成，用户恢复出厂设置、卸载应用、清空应用数据、设备商重置等操作会重置此标识。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.DeviceSuccessCallback">DeviceSuccessCallback</a> ) 可选 获取应用匿名设备标识成功回调函数 回调函数参数event对象类型为json，包含aaid属性保存获取的应用匿名设备标识符。 </li><li>fail: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.DeviceFailCallback">DeviceFailCallback</a> ) 可选 获取应用匿名设备标识失败回调函数 </li><li>complete: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.device.DeviceCompleteCallback">DeviceCompleteCallback</a> ) 可选 获取应用匿名设备标识操作完成回调函数 调用成功或失败都会触发此回调，成功时回调参数与DeviceSuccessCallback一致，失败时回调参数与DeviceCompleteCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 10+ (支持) : 仅在华为、OPPO、VIVO、小米、联想等设备支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getVolume</h1>
获取设备的系统音量
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.device.getVolume();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
系统音量值范围为0到1，0表示静音，1表示最大音量值。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 系统的音量值
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - ALL (支持) : Android平台获取的是系统多媒体音量。 </li><li>iOS - ALL (支持)</li></ul>
<h1 style="margin-left:0;">isWakelock</h1>
获取程序是否一直保持唤醒（屏幕常亮）状态
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Boolean plus.device.isWakelock();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法获取程序是否一致保持唤醒状态。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Boolean : 返回ture表示程序已设置为一直保持唤醒状态，返回false表示程序未设置为一直保持唤醒状态。
<h1 style="margin-left:0;">setWakelock</h1>
设置应用是否保持唤醒（屏幕常亮）状态
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.setWakelock(lock);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法设置应用是否一直保持唤醒状态，保持唤醒状态将会导致程序屏幕常亮、系统不会自动锁屏，从而导致消耗更多的电量。若未设置一直保持唤醒状态则会根据系统设置自动锁定屏幕。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>lock: ( Boolean ) 必选 是否设置程序一直保持唤醒状态 可取值true或false，true表示设定程序一直保持唤醒状态，false表示关闭程序一直保持唤醒状态。程序退出后将恢复默认状态，默认为关闭程序保持唤醒状态。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设置应用保持唤醒（屏幕常亮）状态
function setWakelock(){
plus.device.setWakelock(true);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setVolume</h1>
设置设备的系统音量
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.setVolume(volume);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法调节设备的系统音量。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>volume: ( Number ) 必选 设备的系统音量值 取值范围为0到1，0表示静音，1表示最大音量值。设置设备音量后对所有程序生效，退出程序系统仍然保持最后设定的音量值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>iOS - 4.3+ (支持)</li><li>Android - 2.2+ (支持) : 设置音量后对所有项的音量生效，如通话音量、系统音量、铃声音量、音乐音量、提示声音音量。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设备的系统音量值
function setVolume(){
plus.device.setVolume(0.5);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">vibrate</h1>
设备振动
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.device.vibrate(milliseconds);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法使得设备振动。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>milliseconds: ( Number ) 必选 设备振动持续的时间 数值类型，单位为ms，默认为500ms。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持振动指定的时长，需添加以下权限： "<uses-permission android:name="android.permission.VIBRATE"/>" 更多权限相关说明请参考：https://ask.dcloud.net.cn/article/36982。 </li><li>iOS - 4.3+ (支持) : 不支持milliseconds参数，使用系统默认振动时长，仅iPhone设备支持，iPad和iTouch设备不支持，调用此接口无任何效果。注意：如果在系统设置中关闭振动功能则无法调用设备振动（设置->声音->振动）。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设备振动
function vibrate(){
plus.device.vibrate(2000);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">DeviceInfo</h1>
设备信息对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.device.DeviceInfo {
attribute String imei;
attribute String imsi;
attribute String uuid;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>imei: (String 类型 )设备的国际移动设备身份码 如果设备不支持或无法获取（如用户未授权）则返回空字符串。如果设备存在多个身份码，则以“,”字符分割拼接，如“862470039452950,862470039452943”。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - ALL (支持) :</li><li>iOS - ALL (不支持) : 无法获取设备身份码，返回空字符串。 </li></ul></li><li>imsi: (Array 类型 )设备的国际移动用户识别码 字符串数组类型，获取设备上插入SIM的国际移动设备身份码。如果设备支持多卡模式则返回所有SIM身份码。如果设备不支持或没有插入SIM卡则返回空数组。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - ALL (支持) : 如果无法获取国际移动用户标识（如用户未授权）则返回空数组。 </li><li>iOS - ALL (不支持) : 无法获取设备移动用户识别码，返回空数组。 </li></ul></li><li>uuid: (String 类型 )设备标识 设备的唯一标识号。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - ALL (支持) : 与设备的imei号一致。注意：如果无法获取设备imei则使用设备wifi的mac地址，如果无法获取设备mac地址则随机生成设备标识号（不同App在同一台设备上获取的值一致）。 </li><li>iOS - ALL (支持) : 根据包名随机生成的设备标识号。注意：设备重置（刷机）后会重新生成。 </li></ul></li></ul>
<h1 style="margin-left:0;">screen</h1>
Screen模块管理设备屏幕信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.dpiX">dpiX</a>: 设备屏幕水平方向的密度</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.dpiY">dpiY</a>: 设备屏幕垂直方向的密度</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.height">height</a>: 屏幕高度物理分辨率</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.width">width</a>: 屏幕宽度物理分辨率</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.resolutionHeight">resolutionHeight</a>: 屏幕高度逻辑分辨率</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.resolutionWidth">resolutionWidth</a>: 屏幕宽度逻辑分辨率</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.scale">scale</a>: 逻辑分辨率与物理分辨率的缩放比例</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.setBrightness">setBrightness</a>: 设置屏幕亮度</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.getBrightness">getBrightness</a>: 获取屏幕亮度值</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.getCurrentSize">getCurrentSize</a>: 获取当前屏幕信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.lockOrientation">lockOrientation</a>: 锁定屏幕方向</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.screen.unlockOrientation">unlockOrientation</a>: 解除锁定屏幕方向</li></ul>
<h1 style="margin-left:0;">dpiX</h1>
设备屏幕水平方向的密度
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.dpiX;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取水平方向密度
function getDPI(){
plus.nativeUI.alert("DPI X: " + plus.screen.dpiX);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">dpiY</h1>
设备屏幕垂直方向的密度
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.dpiY;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取垂直方向密度
function getDPI(){
plus.nativeUI.alert("DPI Y: " + plus.screen.dpiY);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">height</h1>
屏幕高度物理分辨率
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取物理高度
plus.screen.height;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
单位为px，设备屏幕的实际物理分辨率。物理分辨率跟屏幕密度相关，通常建议使用逻辑分辨率。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function getHeight(){
plus.nativeUI.alert("Height: " + plus.screen.height);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">width</h1>
屏幕宽度物理分辨率
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.width;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
单位为px，设备屏幕的实际物理分辨率。物理分辨率跟屏幕密度相关，通常建议使用逻辑分辨率。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取物理宽度
function getWidth(){
plus.nativeUI.alert("Width: " + plus.screen.width);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">resolutionHeight</h1>
屏幕高度逻辑分辨率
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.resolutionHeight;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
单位为px, 逻辑分辨率为物理分辨率除以缩放比例scale取整。取整操作可能出现精度丢失，对精度要求高时可使用物理分辨率和scal计算。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取逻辑高度
function getResolutionHeight(){
plus.nativeUI.alert("Resolution Height: " + plus.screen.resolutionHeight);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">resolutionWidth</h1>
屏幕宽度逻辑分辨率
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.resolutionWidth;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
单位为px，逻辑分辨率为物理分辨率除以缩放比例scale取整。取整操作可能出现精度丢失，对精度要求高时可使用物理分辨率和scal计算。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取逻辑宽度
function getResolutionWidth(){
plus.nativeUI.alert("Resolution Width: " + plus.screen.resolutionWidth);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">scale</h1>
逻辑分辨率与物理分辨率的缩放比例
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.scale;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
由于设备屏幕密度不同，在html页面中使用的像素值都是使用逻辑分辨率。而逻辑分辨率与设备的实际物理分辨率存在一定的比例关系，实际物理分辨率=逻辑分辨率*比例。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取逻辑分辨率与物理分辨率的缩放比例
function getScale(){
plus.nativeUI.alert("Scale: " + plus.screen.scale);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setBrightness</h1>
设置屏幕亮度
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.screen.setBrightness(brightness);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法调节设备屏幕亮度。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>brightness: ( Number ) 必选 屏幕的亮度值 取值范围为0到1，0表示最低亮度值，1表示最高亮度值。 HBuilderX3.2.11+版本新增支持取值-1，仅Android平台支持，表示设置应用的屏幕亮度与系统屏幕亮度保持一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 5.0+ (支持) : 应用有独立的亮度，设置应用的屏幕亮度不会修改系统屏幕亮度，仅对当前应用在前台运行时有效，退出应用后屏幕亮度切换回系统屏幕亮度。如果要保证应用的屏幕亮度与系统屏幕亮度一致，可以设置值为 -1。 </li><li>iOS - 9.0+ (支持) : 应用没有独立的亮度，设置时会修改系统屏幕亮度。不支持设置值为 -1。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设置屏幕亮度
function setBrightness(){
plus.screen.setBrightness( 0.5 );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBrightness</h1>
获取屏幕亮度值
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.screen.getBrightness();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
屏幕亮度值范围为0到1，0表示最低亮度值，1表示最高亮度值。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 返回程序的屏幕亮度值
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取屏幕亮度
function getBrightness(){
plus.nativeUI.alert("Brightness: " + plus.screen.getBrightness());
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getCurrentSize</h1>
获取当前屏幕信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
JSON plus.screen.getCurrentSize();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当前屏幕的宽、高信息，返回数据包括以下属性：
<ul><li>"height" - 屏幕物理分辨率高度，单位为px</li><li>"width" - 屏幕物理分辨率宽度，单位为px</li><li>"resolutionHeight" - 屏幕逻辑分辨率高度，单位为px</li><li>"resolutionWidth" - 屏幕逻辑分辨率宽度，单位为px</li></ul>
注意：HBuilderX2.6.9+版本支持。

<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
JSON : 屏幕的宽、高信息
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取当前屏幕信息
function getScreenInfo(){
var info = plus.screen.getCurrentSize();
console.log('ScreenInfo: "+JSON.stringify(info));
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">lockOrientation</h1>
锁定屏幕方向
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.screen.lockOrientation(orientation);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
锁定屏幕方向后屏幕只能按锁定的屏幕方向显示，关闭当前页面后仍然有效。可再次调用此方法修改屏幕锁定方向或调用unlockOrientation()方法恢复到应用的默认值。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>orientation: ( String ) 必选 要锁定的屏幕方向值 锁定屏幕方向可取以下值： "portrait-primary": 竖屏正方向； "portrait-secondary": 竖屏反方向，屏幕正方向按顺时针旋转180°； "landscape-primary": 横屏正方向，屏幕正方向按顺时针旋转90°； "landscape-secondary": 横屏方向，屏幕正方向按顺时针旋转270°； "portrait": 竖屏正方向或反方向，根据设备重力感应器自动调整； "landscape": 横屏正方向或反方向，根据设备重力感应器自动调整； </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 锁定屏幕方向
function lockOrientation(){
plus.screen.lockOrientation("landscape-primary");
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">unlockOrientation</h1>
解除锁定屏幕方向
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.screen.unlockOrientation();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
解除锁定屏幕方向后将恢复应用默认的屏幕显示方向（通常为应用打包发布时设置的方向）。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 解除锁定屏幕方向
function unlockOrientation(){
plus.screen.unlockOrientation();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">display</h1>
Display模块管理应用可使用的显示区域信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.display {
attribute Number resolutionHeight;
attribute Number resolutionWidth;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.display.resolutionHeight">resolutionHeight</a>: 应用可使用的屏幕高度逻辑分辨率</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.display.resolutionWidth">resolutionWidth</a>: 应用可使用的屏幕宽度逻辑分辨率</li></ul>
<h1 style="margin-left:0;">resolutionHeight</h1>
应用可使用的屏幕高度逻辑分辨率
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.display.resolutionHeight;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。如果需要获取实际分辨率则需要乘以比例值scale。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h1 style="margin-left:0;">resolutionWidth</h1>
应用可使用的屏幕宽度逻辑分辨率
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.display.resolutionWidth;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。如果需要获取实际分辨率则需要乘以比例值scale。
<h1 style="margin-left:0;">networkinfo</h1>
networkinfo模块用于获取网络信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_UNKNOW">CONNECTION_UNKNOW</a>: 网络连接状态未知</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_NONE">CONNECTION_NONE</a>: 未连接网络</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_ETHERNET">CONNECTION_ETHERNET</a>: 有线网络</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_WIFI">CONNECTION_WIFI</a>: 无线WIFI网络</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_CELL2G">CONNECTION_CELL2G</a>: 蜂窝移动2G网络</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_CELL3G">CONNECTION_CELL3G</a>: 蜂窝移动3G网络</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_CELL4G">CONNECTION_CELL4G</a>: 蜂窝移动4G网络</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.CONNECTION_CELL5G">CONNECTION_CELL5G</a>: 蜂窝移动5G网络</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.getCurrentType">getCurrentType</a>: 获取设备当前连接的网络类型</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.networkinfo.isSetProxy">isSetProxy</a>: 获取当前网络是否设置代理</li></ul>
<h1 style="margin-left:0;">CONNECTION_UNKNOW</h1>
网络连接状态未知
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_UNKNOW;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，表示当前设备网络状态未知，固定值为0。
<h1 style="margin-left:0;">CONNECTION_NONE</h1>
未连接网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_NONE;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备网络未连接网络，固定值为1。
<h1 style="margin-left:0;">CONNECTION_ETHERNET</h1>
有线网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_ETHERNET;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备连接到有线网络，固定值为2。
<h1 style="margin-left:0;">CONNECTION_WIFI</h1>
无线WIFI网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_WIFI;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备连接到无线WIFI网络，固定值为3。
<h1 style="margin-left:0;">CONNECTION_CELL2G</h1>
蜂窝移动2G网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_CELL2G;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备连接到蜂窝移动2G网络，固定值为4。
<h1 style="margin-left:0;">CONNECTION_CELL3G</h1>
蜂窝移动3G网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_CELL3G;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备连接到蜂窝移动3G网络，固定值为5。
<h3>平台支持</h3>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 7.0+ (支持)</li></ul>
<h1 style="margin-left:0;">CONNECTION_CELL4G</h1>
蜂窝移动4G网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_CELL4G;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备连接到蜂窝移动4G网络，固定值为6。
<h3>平台支持</h3>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 7.0+ (支持)</li></ul>
<h1 style="margin-left:0;">CONNECTION_CELL5G</h1>
蜂窝移动5G网络
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.networkinfo.CONNECTION_CELL5G;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
Number 类型
网络状态常量，当前设备连接到蜂窝移动5G网络，固定值为7。
<h3>平台支持</h3>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 14.0+ (支持)</li></ul>
<h1 style="margin-left:0;">getCurrentType</h1>
获取设备当前连接的网络类型
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.networkinfo.getCurrentType();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取当前设备连接的网络类型，返回值为网络类型常量，可取值CONNECTION_*常量。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 设备当前网络类型
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.3+ (支持)</li><li>iOS - 7.0+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">isSetProxy</h1>
获取当前网络是否设置代理
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Boolean plus.networkinfo.isSetProxy();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
注意：HBuilderX3.0.0及以上版本支持。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
Boolean : 如果设置了代理则返回true，否则返回false。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 4.4+ (支持) : 仅支持判断WiFi情况下是否设置代理，无法判断移动网络设置代理的情况 </li><li>iOS - 9.0+ (支持)</li></ul>
<h1 style="margin-left:0;">os</h1>
OS模块管理操作系统信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.os {
attribute String language;
attribute String name;
attribute String vendor;
attribute String version;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.os.language">language</a>: 系统语言信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.os.name">name</a>: 系统的名称</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.os.vendor">vendor</a>: 系统的供应商信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122685939#plus.os.version">version</a>: 系统版本信息</li></ul>
<h1 style="margin-left:0;">language</h1>
系统语言信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.os.language;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
获取当前操作系统设置的系统语言，字符串类型数据，格式为"语言-地区"，如"zh-CN"表示语言为简体中文、地区为中国大陆。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持) : iOS系统支持跟多的语言选择，会包含更丰富的语言信息，如"zh-Hans-CN“，其中"zh-Hans"表示语言为简体中文，对应繁体中文为"zh-Hant”，最后的"CN“表示地区为中国大陆。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取系统语言信息
function getLanguage(){
console.log("OS language: " + plus.os.language);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">name</h1>
系统的名称
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.os.name;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
获取当前操作系统的名称，字符串类型数据。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 返回字符串“Android” </li><li>iOS - 4.3+ (支持) : 返回字符串“iOS” </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取系统的名称
function plusReady(){
console.log("OS name: " + plus.os.name);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">vendor</h1>
系统的供应商信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.os.vendor;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
获取当前操作系统的供应商名称，字符串类型数据。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 返回字符串“Google” </li><li>iOS - 4.3+ (支持) : 返回字符串“Apple” </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取系统的供应商信息
function getVendor(){
console.log("OS name: " + plus.os.vendor );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">version</h1>
系统版本信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
plus.os.version;
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
获取当前操作系统的版本信息，字符串类型数据。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取系统版本信息
function getVersion(){
console.log("OS version: " + plus.os.version);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">DeviceSuccessCallback</h1>
成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(Object event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 回调参数 回调参数包含的属性由调用接口决定，具体参考对应的接口描述说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">DeviceFailCallback</h1>
失败回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onFail(Exception error){
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 回调参数，错误信息 可通过error.code（Number类型）获取错误编码； 可通过error.message（String类型）获取错误描述信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">DeviceCompleteCallback</h1>
操作完成回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onComplete(Object event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用成功或失败都会触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 回调参数 调用成功时回调参数与DeviceSuccessCallback一致，调用失败时回调参数与DeviceFailCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

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