方法：

• getCurrentProximity: 获取当前设备的近距离信息
• watchProximity: 监控设备近距离变化
• clearWatch: 关闭监听设备近距离变化

回调方法：

• ProximitySuccessCallback: 成功获取设备近距离信息的回调函数
• ProximityErrorCallback: 获取设备接近距离信息失败的回调函数

权限：

5 功能模块（permissions）

 { // ... "permissions":{  // ...  "Proximity": {   "description": "距离感应器"  } } }    

getCurrentProximity

 void plus.proximity.getCurrentProximity( successCB, errorCB );     

获取当前接近设备的距离信息，距离值为cm。如果传感器无法获得准确的距离值，则在接近设备时返回0，否则返回Infinity。 获得成功则调用successCB回调函数返回近距离值。如果获得失败，则调用errorCB回调函数错误信息。

参数：

• successCB:(ProximitySuccessCallback) 必选获取距离信息成功回调函数

• errorCB:(ProximityErrorCallback) 可选获取距离信息失败回调函数

返回值：

void: 无

平台支持：

• Android - 2.2 (支持) :

  支持

• iOS - 4.3 (支持) :

  支持

示例：

         
	 charset="utf-8">
	
	 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 );
		} );
}
	
	
	 >
		 type='button' onclick='getProximity();' value='Proximity'/>
	

				
				

Number plus.proximity.watchProximity( changeCB, errorCB );
				

	
	 charset="utf-8">
	
	 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 ); 
	} ); 
}
	
	
	 >
		Proximity watch

		 id="inf">
	

				

void plus.proximity.clearWatch( watchId );
				

void onSuccess( distance ) {
	// Get distance success code.
}
				

void onError( error ) {
	// Get distance error code.
}