宜信同城网交流论坛技术专版技术专区Proximity模块管理设备距离传感器，可获取当前设备的接近距离信息，通过plus.proximit ...方法： getCurrentProximity: 获取当前设备的接近距离信息watchProximity: 监听设备接近距离的变化clear ...

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

Proximity模块管理设备距离传感器，可获取当前设备的接近距离信息，通过plus.proximit ...

<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">
 <h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122837161#plus.proximity.getCurrentProximity">getCurrentProximity</a>: 获取当前设备的接近距离信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122837161#plus.proximity.watchProximity">watchProximity</a>: 监听设备接近距离的变化</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122837161#plus.proximity.clearWatch">clearWatch</a>: 关闭监听设备接近距离变化</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/proximity.html#plus.proximity.ProximitySuccessCallback">ProximitySuccessCallback</a>: 获取设备接近距离信息成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/proximity.html#plus.proximity.ProximityErrorCallback">ProximityErrorCallback</a>: 获取设备接近距离信息失败的回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Proximity": {
"description": "距离感应器"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">getCurrentProximity</h1>
获取当前设备的接近距离信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.proximity.getCurrentProximity( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取当前接近设备的距离信息，距离值单位为厘米。如果感应器无法获取准确的距离值，则在接近设备时返回0，否则返回Infinity。获取成功则调用successCB回调函数返接近回距离值。获取失败则调用errorCB回调函数错误信息。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/proximity.html#plus.proximity.ProximitySuccessCallback">ProximitySuccessCallback</a> ) 必选 获取距离信息成功回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/proximity.html#plus.proximity.ProximityErrorCallback">ProximityErrorCallback</a> ) 可选 获取距离信息失败回调函数 </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+ (支持) : 支持 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Proximity Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
}
function getProximity() {
plus.proximity.getCurrentProximity( function ( d ) {
alert( "Get distance success: "+d );
}, function ( e ) {
alert( "Error: "+e.message );
} );
}
</script>
</head>
<body >
<input type='button' onclick='getProximity();' value='Proximity'/>
</body>
</html>

</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">watchProximity</h1>
监听设备接近距离的变化
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.proximity.watchProximity( changeCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
watchProximity将监听设备的接近距离信息变化事件，当接近距离发生变化时通过changeCB回调函数返回距离值。监听距离变化事件失败则通过errorCB回调函数返回错误信息。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>changeCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122837161#plus.proximity.ProximitySuccessCallback">ProximitySuccessCallback</a> ) 必选 设备接近距离变化时的回调函数 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122837161#plus.proximity.ProximityErrorCallback">ProximityErrorCallback</a> ) 可选 监听设备接近距离变化事件失败的回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 用于标识接近距离变化事件监听器，可通过clearWatch方法取消监听。
<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>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Proximity Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.proximity.watchProximity( function ( d ) {
document.getElementById("inf").innerText="Proximity: "+d;
}, function ( e ) {
alert( "Error: " + e.message );
} );
}
</script>
</head>
<body >
Proximity watch 
<span id="inf">
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">clearWatch</h1>
关闭监听设备接近距离变化
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.proximity.clearWatch( watchId );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>watchId: ( Number ) 必选 需要取消的距离监听器标识，调用watchProximity方法的返回值。 </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+ (支持) : 支持 </li></ul>
<h1 style="margin-left:0;">ProximitySuccessCallback</h1>
获取设备接近距离信息成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( distance ) {
// Get distance success code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>distance: ( Number ) 必选 设备接近距离 设备接近距离传感器获取的距离值，单位为厘米。如果感应器无法获取准确的距离值，则在接近设备时返回0，否则返回Infinity。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">ProximityErrorCallback</h1>
获取设备接近距离信息失败的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onError( error ) {
// Get distance error code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 失败信息 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

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

Proximity模块管理设备距离传感器，可获取当前设备的接近距离信息，通过plus.proximit ...