accelerometer 模块传感器

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

方法:

对象:

回调方法:

权限:

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">"Accelerometer"</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>

getCurrentAcceleration

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

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">accelerometer</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getCurrentAcceleration</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>

说明:

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

参数:

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取加速度信息</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getCurrentAcceleration</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">accelerometer</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getCurrentAcceleration</span><span style="color:#ffffff">(</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff"> a </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">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"Acceleration\nx:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">xAxis </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">"\ny:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">yAxis </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">"\nz:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">zAxis </span><span style="color:#ffffff">);</span>
	<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

uni-app使用plus注意事项

watchAcceleration

监听设备加速度变化信息

<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">accelerometer</span><span style="color:#ffffff">.</span><span style="color:#ffffff">watchAcceleration</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><span style="color:#ffffff"> option </span><span style="color:#ffffff">);</span>
				</code></span></span>

说明:

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

参数:

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

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

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

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

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

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

返回值:

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

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> wid </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">// 监听设备加速度变化</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> watchAcceleration</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
	wid </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">accelerometer</span><span style="color:#ffffff">.</span><span style="color:#ffffff">watchAcceleration</span><span style="color:#ffffff">(</span> <span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> a </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
		console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"x:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">xAxis </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">"\ny:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">yAxis </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">"\nz:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">zAxis</span><span style="color:#ffffff">);</span>
	<span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></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">
		plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"watchAcceleration error: "</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> JSON</span><span style="color:#ffffff">.</span><span style="color:#ffffff">stringify</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">);</span> 
<span style="color:#ffffff">}</span>
				</code></span></span>

uni-app使用plus注意事项

clearWatch

关闭监听设备加速度信息

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">accelerometer</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>

说明:

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

参数:

  • watchId: ( Number ) 必选

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

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> wid </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">// wid = plus.accelerometer.watchAcceleration(...);</span>
<span style="color:#87ceeb">// 关闭监听设备加速度</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> clearWatch</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
	plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">accelerometer</span><span style="color:#ffffff">.</span><span style="color:#ffffff">clearWatch</span><span style="color:#ffffff">(</span><span style="color:#ffffff">wid</span><span style="color:#ffffff">);</span><span style="color:#ffffff">
	wid </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

uni-app使用plus注意事项

Acceleration

设备加速度信息对象

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>interface</strong></span> <span style="color:#98fb98">Acceleration</span> <span style="color:#ffffff">{</span>
	<span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">Number</span><span style="color:#ffffff"> xAxis</span><span style="color:#ffffff">;</span>
	<span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">Number</span><span style="color:#ffffff"> yAxis</span><span style="color:#ffffff">;</span>
	<span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">Number</span><span style="color:#ffffff"> zAxis</span><span style="color:#ffffff">;</span>  
<span style="color:#ffffff">}</span>
				</code></span></span>

说明:

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

属性:

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

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

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

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

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

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

AccelerometerOption

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

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>interface</strong></span> <span style="color:#98fb98">Acceleration</span> <span style="color:#ffffff">{</span>
	<span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">DOMString</span><span style="color:#ffffff"> frequency</span><span style="color:#ffffff">;</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

说明:

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

属性:

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

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

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> wid </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">// 监听设备加速度变化</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> watchAcceleration</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
	wid </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">accelerometer</span><span style="color:#ffffff">.</span><span style="color:#ffffff">watchAcceleration</span><span style="color:#ffffff">(</span> <span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> a </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
		console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"x:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">xAxis </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">"\ny:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">yAxis </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">"\nz:"</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> a</span><span style="color:#ffffff">.</span><span style="color:#ffffff">zAxis</span><span style="color:#ffffff">);</span>
	<span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></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">
		plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"watchAcceleration error: "</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> JSON</span><span style="color:#ffffff">.</span><span style="color:#ffffff">stringify</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">{</span><span style="color:#ffffff">frequency</span><span style="color:#ffffff">:</span><span style="color:#cd5c5c">1000</span><span style="color:#ffffff">});</span> <span style="color:#87ceeb">// 设置更新间隔时间为1s</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

uni-app使用plus注意事项

AccelerometerSuccessCallback

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

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onSuccess</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> acceleration </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span>
	<span style="color:#87ceeb">// Get acceleration code.</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

参数:

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

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

返回值:

void : 无

AccelerometerErrorCallback

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

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onAccelerometerError</span><span style="color:#ffffff">(</span><span style="color:#98fb98">Exception</span><span style="color:#ffffff"> error</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span>
	<span style="color:#87ceeb">// Handle error</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> code </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> error</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">;</span> <span style="color:#87ceeb">// 错误编码</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> message </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> error</span><span style="color:#ffffff">.</span><span style="color:#ffffff">message</span><span style="color:#ffffff">;</span> <span style="color:#87ceeb">// 错误描述信息</span>
<span style="color:#ffffff">}</span>
				</code></span></span>

参数:

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

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

返回值:

void : 无

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值