- getCurrentProximity: 获取当前设备的近距离信息
- watchProximity: 监控设备近距离变化
- clearWatch: 关闭监听设备近距离变化
- ProximitySuccessCallback: 成功获取设备近距离信息的回调函数
- ProximityErrorCallback: 获取设备接近距离信息失败的回调函数
5 功能模块（permissions）
<span style="background-color:#333333"><span style="color:#474747"><code> <span style="color:#ffffff">{</span> <span style="color:#87ceeb">// ...</span> <span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span> <span style="color:#87ceeb">// ...</span> <span style="color:#ffa0a0">"Proximity"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span> <span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"距离感应器"</span> <span style="color:#ffffff">}</span> <span style="color:#ffffff">}</span> <span style="color:#ffffff">}</span> </code></span></span>getCurrentProximity
获取当前设备的近距离信息
<span style="background-color:#333333"><span style="color:#474747"><code> <span style="color:#f0e68c"><label>void</label></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">proximity</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getCurrentProximity</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> successCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB </span><span style="color:#ffffff">);</span> </code></span></span>获取当前接近设备的距离信息，距离值为cm。如果传感器无法获得准确的距离值，则在接近设备时返回0，否则返回Infinity。 获得成功则调用successCB回调函数返回近距离值。如果获得失败，则调用errorCB回调函数错误信息。
- successCB:(ProximitySuccessCallback) 必选获取距离信息成功回调函数
- errorCB:(ProximityErrorCallback) 可选获取距离信息失败回调函数
void: 无
- Android - 2.2 (支持) :
支持
- iOS - 4.3 (支持) :
支持
<span style="background-color:#333333"><span style="color:#474747"><code> <span style="color:#cccccc"><!DOCTYPE html></span> <span style="color:#f0e68c"><label><html></label></span> <span style="color:#f0e68c"><label><head></stong></span>
<span style="color:#f0e68c"><label><meta</label></span> <span style="color:#bdb76b"><label>charset</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><label>></label></span>
<span style="color:#f0e68c"><label><title></label></span><span style="color:#ffffff">Proximity Example</span><span style="color:#f0e68c"><label></title></label></span>
<span style="color:#f0e68c"><label><script</label></span> <span style="color:#bdb76b"><label>type</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span> <span style="color:#f0e68c"><label>></label></span>
<span style="color:#87ceeb">// 扩展API加载完毕后调用onPlusReady回调函数 </span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"plusready"</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><label>false</label></span> <span style="color:#ffffff">);</span>
<span style="color:#87ceeb">// 扩展API加载完毕，现在可以正常调用扩展API</span>
<span style="color:#f0e68c"><label>function</label></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span>
<span style="color:#ffffff">}</span>
<span style="color:#f0e68c"><label>function</label></span><span style="color:#ffffff"> getProximity</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">proximity</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getCurrentProximity</span><span style="color:#ffffff">(</span> <span style="color:#f0e68c"><label>function</label></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> d </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"Get distance success: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">d </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">},</span> <span style="color:#f0e68c"><label>function</label></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> e </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"Error: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">message </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#f0e68c"><label></script></label></span>
<span style="color:#f0e68c"><label></head></label></span>
<span style="color:#f0e68c"><label><body</label></span> <span style="color:#f0e68c"><label>></label></span>
<span style="color:#f0e68c"><label><input</label></span> <span style="color:#bdb76b"><label>type</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">'button'</span> <span style="color:#bdb76b"><label>onclick</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">'</span><span style="color:#ffffff">getProximity</span><span style="color:#ffffff">();</span><span style="color:#ffa0a0">'</span> <span style="color:#bdb76b"><label>value</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">'Proximity'</span><span style="color:#f0e68c"><label>/></label></span>
<span style="color:#f0e68c"><label></body></label></span>
<span style="color:#f0e68c"><label></html></label></span>
</code></span></span>uni-app使用plus注意事项
watchProximity
监听设备接近距离的变化
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">Number</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">proximity</span><span style="color:#ffffff">.</span><span style="color:#ffffff">watchProximity</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> changeCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB </span><span style="color:#ffffff">);</span>
</code></span></span>watchProximity将监听设备的接近距离信息变化事件，当接近距离发生变化时通过changeCB回调函数返回距离值。监听距离变化事件失败则通过errorCB回调函数返回错误信息。
- changeCB: ( ProximitySuccessCallback ) 必选 设备接近距离变化时的回调函数
- errorCB: ( ProximityErrorCallback ) 可选
监听设备接近距离变化事件失败的回调函数
Number : 用于标识接近距离变化事件监听器，可通过clearWatch方法取消监听。
- Android - 2.2+ (支持) :
支持
- iOS - 4.3+ (支持) :
支持
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><label><html></label></span>
<span style="color:#f0e68c"><label><head></label></span>
<span style="color:#f0e68c"><label><meta</label></span> <span style="color:#bdb76b"><label>charset</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><label>></label></span>
<span style="color:#f0e68c"><label><title></label></span><span style="color:#ffffff">Proximity Example</span><span style="color:#f0e68c"><label></title></label></span>
<span style="color:#f0e68c"><label><script</label></span> <span style="color:#bdb76b"><label>type</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span> <span style="color:#f0e68c"><label>></label></span>
<span style="color:#87ceeb">// 扩展API加载完毕后调用onPlusReady回调函数 </span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"plusready"</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><label>false</label></span> <span style="color:#ffffff">);</span>
<span style="color:#87ceeb">// 扩展API加载完毕，现在可以正常调用扩展API</span>
<span style="color:#f0e68c"><label>function</label></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">proximity</span><span style="color:#ffffff">.</span><span style="color:#ffffff">watchProximity</span><span style="color:#ffffff">(</span> <span style="color:#f0e68c"><label>function</label></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> d </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getElementById</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"inf"</span><span style="color:#ffffff">).</span><span style="color:#ffffff">innerText</span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"Proximity: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">d</span><span style="color:#ffffff">;</span>
<span style="color:#ffffff">},</span> <span style="color:#f0e68c"><label>function</label></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> e </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"Error: "</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">message </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#f0e68c"><label></script></label></span>
<span style="color:#f0e68c"><label></head></label></span>
<span style="color:#f0e68c"><label><body</label></span> <span style="color:#f0e68c"><label>></label></span><span style="color:#ffffff">
Proximity watch</span><span style="color:#f0e68c"><label><br/></label></span>
<span style="color:#f0e68c"><label><span</label></span> <span style="color:#bdb76b"><label>id</label></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"inf"</span><span style="color:#f0e68c"><label>></span></label></span>
<span style="color:#f0e68c"><label></body></label></span>
<span style="color:#f0e68c"><label></html></label></span>
</code></span></span>uni-app使用plus注意事项
clearWatch
关闭监听设备接近距离变化
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><label>void</label></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">proximity</span><span style="color:#ffffff">.</span><span style="color:#ffffff">clearWatch</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> watchId </span><span style="color:#ffffff">);</span>
</code></span></span>- watchId: ( Number ) 必选
需要取消的距离监听器标识，调用watchProximity方法的返回值。
void : 无
- Android - 2.2+ (支持) :
支持
- iOS - 4.3+ (支持) :
支持
ProximitySuccessCallback
获取设备接近距离信息成功的回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><label>void</label></span><span style="color:#ffffff"> onSuccess</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> distance </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// Get distance success code.</span>
<span style="color:#ffffff">}</span>
</code></span></span>- distance: ( Number ) 必选 设备接近距离
设备接近距离传感器获取的距离值，单位为厘米。如果感应器无法获取准确的距离值，则在接近设备时返回0，否则返回Infinity。
void : 无
ProximityErrorCallback
获取设备接近距离信息失败的回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><label>void</label></span><span style="color:#ffffff"> onError</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> error </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// Get distance error code.</span>
<span style="color:#ffffff">}</span>
</code></span></span>- error: ( Exception ) 必选 失败信息
void : 无