宜信同城网交流论坛技术专版技术专区accelerometer 模块传感器Accelerometer模块管理设备加速度传感器，用于获取设备加速度信息，包括x（屏幕水平方向 ...

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

accelerometer 模块传感器

<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">
 Accelerometer模块管理设备加速度传感器，用于获取设备加速度信息，包括x（屏幕水平方向）、y（垂直屏幕水平方向）、z（垂直屏幕平面方向）三个方向的加速度信息。通过plus.accelerometer获取设备加速度传感器管理对象。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.getCurrentAcceleration">getCurrentAcceleration</a>: 获取当前设备的加速度信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.watchAcceleration">watchAcceleration</a>: 监听设备加速度变化信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.clearWatch">clearWatch</a>: 关闭监听设备加速度信息</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.Acceleration">Acceleration</a>: 设备加速度信息对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/accelerometer.html#plus.accelerometer.AccelerometerOption">AccelerometerOption</a>: 监听设备加速度感应器参数</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/accelerometer.html#plus.accelerometer.AccelerometerSuccessCallback">AccelerometerSuccessCallback</a>: 获取设备加速度信息成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/accelerometer.html#plus.accelerometer.AccelerometerErrorCallback">AccelerometerErrorCallback</a>: 获取设备加速度信息失败的回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Accelerometer": {
"description": "加速度传感器"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">getCurrentAcceleration</h1>
获取当前设备的加速度信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.accelerometer.getCurrentAcceleration( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
加速度是设备在当前方向上所做相对运动变化（增、减量）的运动传感器。加速度信息包括x、y、z三个方向的信息。加速度信息可通过successCB回调函数返回。加速度信息获取失败则调用回调函数errorCB。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/accelerometer.html#plus.accelerometer.AccelerometerSuccessCallback">AccelerometerSuccessCallback</a> ) 必选 获取设备加速度信息成功回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/accelerometer.html#plus.accelerometer.AccelerometerErrorCallback">AccelerometerErrorCallback</a> ) 可选 获取设备加速度信息失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取加速度信息
function getCurrentAcceleration(){
plus.accelerometer.getCurrentAcceleration( function( a ) {
plus.nativeUI.alert( "Acceleration\nx:" + a.xAxis + "\ny:" + a.yAxis + "\nz:" + a.zAxis );
} );
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">watchAcceleration</h1>
监听设备加速度变化信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.accelerometer.watchAcceleration( successCB, errorCB, option );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
加速度是设备在当前方向上所做相对运动变化（增、减量）的运动传感器。加速度信息包括x、y、z三个方向的信息。 watchAcceleration每隔固定时间就获取一次设备的加速度信息，通过successCB回调函数返回。可通过option的frequency参数设定获取设备加速度信息的时间间隔。加速度信息获取失败则调用回调函数errorCB。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.AccelerometerSuccessCallback">AccelerometerSuccessCallback</a> ) 必选 成功回调函数 当获取设备的加速度信息成功时回调，并返回加速度信息。 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.AccelerometerErrorCallback">AccelerometerErrorCallback</a> ) 可选 失败回调函数 当获取设备加速度信息失败回调函数，并返回错误信息。 </li><li>options: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122578037#plus.accelerometer.AccelerometerOption">AccelerometerOption</a> ) 可选 加速度信息参数 监听设备加速度信息的参数，如更新数据的频率等。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 用于标识加速度信息监听器，可通过clearWatch方法取消监听。
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
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));
} );
}
</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.accelerometer.clearWatch( watchId );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭监听设备加速度信息，应用关闭调用watchAcceleration方法的开启的监听操作。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>watchId: ( Number ) 必选 需要取消的加速度监听器标识，调用watchAcceleration方法的返回值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var wid = null;
// wid = plus.accelerometer.watchAcceleration(...);
// 关闭监听设备加速度
function clearWatch(){
plus.accelerometer.clearWatch(wid);
wid = null;
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">Acceleration</h1>
设备加速度信息对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Acceleration {
readonly attribute Number xAxis;
readonly attribute Number yAxis;
readonly attribute Number zAxis;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
JSON对象，保存获取设备的加速度信息，包括x、y、z三个方向的加速度信息。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>xAxis: (Number 类型 )x轴方向的加速度 获取当前设备x轴方向的加速度，浮点型数据，与物理学中的加速度值一致。 </li><li>yAxis: (Number 类型 )y轴方向的加速度 获取当前设备y轴方向的加速度，浮点型数据，与物理学中的加速度值一致。 </li><li>zAxis: (Number 类型 )z轴方向的加速度 获取当前设备z轴方向的加速度，浮点型数据，与物理学中的加速度值一致。 </li></ul>
<h1 style="margin-left:0;">AccelerometerOption</h1>
监听设备加速度感应器参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Acceleration {
readonly attribute DOMString frequency;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
JSON对象，用于设置获取设备加速度信息的参数。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>frequency: (Number 类型 )更新加速度信息间隔时间 监听器获取加速度信息的时间间隔，单位为ms，默认值为500ms </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
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
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AccelerometerSuccessCallback</h1>
获取设备加速度信息成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( acceleration ) {
// Get acceleration code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>acceleration: ( <ahref="https://www.html5plus.org/doc/zh_cn/accelerometer.html#plus.accelerometer.Acceleration">Acceleration</a> ) 必选 设备的加速度信息 Acceleration类型对象，用于获取各方向的详细加速度值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">AccelerometerErrorCallback</h1>
获取设备加速度信息失败的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onAccelerometerError(Exception error) {
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 获取加速度操作的错误信息 可通过error.code（Number类型）获取错误编码； 可通过error.message（String类型）获取错误描述信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

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

accelerometer 模块传感器