返回介绍

accelerometer

发布于 2021-10-21 18:08:10 字数 6688 浏览 951 评论 0 收藏 0

Accelerometer模块管理设备加速度传感器,用于获取设备加速度信息,包括x(屏幕水平方向)、y(垂直屏幕水平方向)、z(垂直屏幕平面方向)三个方向的加速度信息。通过plus.accelerometer获取设备加速度传感器管理对象。

方法:

对象:

回调方法:

权限:

5+功能模块(permissions)


{
// ...
"permissions":{
	// ...
	"Accelerometer": {
		"description": "加速度传感器"
	}
}
}
			

getCurrentAcceleration

获取当前设备的加速度信息


void plus.accelerometer.getCurrentAcceleration( successCB, errorCB );
				

说明:

加速度是设备在当前方向上所做相对运动变化(增、减量)的运动传感器。加速度信息包括x、y、z三个方向的信息。 加速度信息可通过successCB回调函数返回。加速度信息获取失败则调用回调函数errorCB。

参数:

返回值:

void : 无

示例:


// 获取加速度信息
function getCurrentAcceleration(){
	plus.accelerometer.getCurrentAcceleration( function( a ) {
		plus.nativeUI.alert( "Acceleration\nx:" + a.xAxis + "\ny:" + a.yAxis + "\nz:" + a.zAxis );
	} );
}
				

uni-app使用plus注意事项

watchAcceleration

监听设备加速度变化信息


Number plus.accelerometer.watchAcceleration( successCB, errorCB, option );
				

说明:

加速度是设备在当前方向上所做相对运动变化(增、减量)的运动传感器。加速度信息包括x、y、z三个方向的信息。 watchAcceleration每隔固定时间就获取一次设备的加速度信息,通过successCB回调函数返回。可通过option的frequency参数设定获取设备加速度信息的时间间隔。 加速度信息获取失败则调用回调函数errorCB。

参数:

  • successCB: ( AccelerometerSuccessCallback ) 必选 成功回调函数

    当获取设备的加速度信息成功时回调,并返回加速度信息。

  • errorCB: ( AccelerometerErrorCallback ) 可选 失败回调函数

    当获取设备加速度信息失败回调函数,并返回错误信息。

  • options: ( AccelerometerOption ) 可选 加速度信息参数

    监听设备加速度信息的参数,如更新数据的频率等。

返回值:

Number : 用于标识加速度信息监听器,可通过clearWatch方法取消监听。

示例:


var wid = null;
// 监听设备加速度变化
function watchAcceleration(){
	wid = plus.accelerometer.watchAcceleration( function ( a ) {
		console.log( "x:" + a.xAxis + "\ny:" + a.yAxis + "\nz:" + a.zAxis);
	}, function ( e ) {
		plus.nativeUI.alert("watchAcceleration error: " + JSON.stringify(e)); 
	} ); 
}
				

uni-app使用plus注意事项

clearWatch

关闭监听设备加速度信息


void plus.accelerometer.clearWatch( watchId );
				

说明:

关闭监听设备加速度信息,应用关闭调用watchAcceleration方法的开启的监听操作。

参数:

  • watchId: ( Number ) 必选

    需要取消的加速度监听器标识,调用watchAcceleration方法的返回值。

返回值:

void : 无

示例:


var wid = null;
// wid = plus.accelerometer.watchAcceleration(...);
// 关闭监听设备加速度
function clearWatch(){
	plus.accelerometer.clearWatch(wid);
	wid = null;
}
				

uni-app使用plus注意事项

Acceleration

设备加速度信息对象


interface Acceleration {
	readonly attribute Number xAxis;
	readonly attribute Number yAxis;
	readonly attribute Number zAxis;  
}
				

说明:

JSON对象,保存获取设备的加速度信息,包括x、y、z三个方向的加速度信息。

属性:

  • xAxis: (Number 类型 )x轴方向的加速度

    获取当前设备x轴方向的加速度,浮点型数据,与物理学中的加速度值一致。

  • yAxis: (Number 类型 )y轴方向的加速度

    获取当前设备y轴方向的加速度,浮点型数据,与物理学中的加速度值一致。

  • zAxis: (Number 类型 )z轴方向的加速度

    获取当前设备z轴方向的加速度,浮点型数据,与物理学中的加速度值一致。

AccelerometerOption

监听设备加速度感应器参数


interface Acceleration {
	readonly attribute DOMString frequency;
}
				

说明:

JSON对象,用于设置获取设备加速度信息的参数。

属性:

  • frequency: (Number 类型 )更新加速度信息间隔时间

    监听器获取加速度信息的时间间隔,单位为ms,默认值为500ms

示例:


var wid = null;
// 监听设备加速度变化
function watchAcceleration(){
	wid = plus.accelerometer.watchAcceleration( function ( a ) {
		console.log( "x:" + a.xAxis + "\ny:" + a.yAxis + "\nz:" + a.zAxis);
	}, function ( e ) {
		plus.nativeUI.alert("watchAcceleration error: " + JSON.stringify(e)); 
	}, {frequency:1000}); // 设置更新间隔时间为1s
}
				

uni-app使用plus注意事项

AccelerometerSuccessCallback

获取设备加速度信息成功的回调函数


void onSuccess( acceleration ) {
	// Get acceleration code.
}
				

参数:

  • acceleration: ( Acceleration ) 必选 设备的加速度信息

    Acceleration类型对象,用于获取各方向的详细加速度值。

返回值:

void : 无

AccelerometerErrorCallback

获取设备加速度信息失败的回调函数


function void onAccelerometerError(Exception error) {
	// Handle error
	var code = error.code; // 错误编码
	var message = error.message; // 错误描述信息
}
				

参数:

  • error: ( Exception ) 必选 获取加速度操作的错误信息

    可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。

返回值:

void : 无

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击“接受”或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。