宜信同城网交流论坛技术专版技术专区Orientation模块管理设备的方向信息，包括alpha、beta、gamma三个方向信息，通过plus. ...Orientation模块管理设备的方向信息，包括alpha、beta、gamma三个方向信息，通过plus.orientation ...

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

Orientation模块管理设备的方向信息，包括alpha、beta、gamma三个方向信息，通过plus. ...

<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">
 Orientation模块管理设备的方向信息，包括alpha、beta、gamma三个方向信息，通过plus.orientation可获取设备方向管理对象。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.getCurrentOrientation">getCurrentOrientation</a>: 获取当前设备的方向信息，包括alpha、beta、gamma三个方向信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.watchOrientation">watchOrientation</a>: 监听设备方向信息的变化</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.clearWatch">clearWatch</a>: 关闭监听设备方向信息</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/orientation.html#plus.orientation.OrientationOption">OrientationOption</a>: JSON对象，监听设备方向感应器参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.Rotation">Rotation</a>: JSON对象，设备方向信息数据</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/orientation.html#plus.orientation.OrientationSuccessCallback">OrientationSuccessCallback</a>: 获取设备方向信息成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/orientation.html#plus.orientation.OrientationErrorCallback">OrientationErrorCallback</a>: 获取设备方向信息失败的回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Orientation": {
"description": "方向传感器"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">getCurrentOrientation</h1>
获取当前设备的方向信息，包括alpha、beta、gamma三个方向信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.orientation.getCurrentOrientation( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
方向信息是设备相对于水平初始方向分别以z、x、y轴为轴心旋转的角度，对应值为alpha、beta、gamma三个方向的信息。方向信息可通过successCB回调函数返回。方向信息获取失败则调用回调函数errorCB
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/orientation.html#plus.orientation.OrientationSuccessCallback">OrientationSuccessCallback</a> ) 必选 获取设备方向信息成功回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/orientation.html#plus.orientation.OrientationErrorCallback">OrientationErrorCallback</a> ) 可选 获取设备方向信息失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持 </li><li>iOS - 4.3+ (支持) : 支持 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Orientation Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.orientation.getCurrentOrientation( function ( o ) {
alert( "Orientation\nAlpha:" + o.alpha + "\nBeta:" + o.beta + "\nGamma:" + o.gamma );
} );
}
</script>
</head>
<body>
Orientation
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">watchOrientation</h1>
监听设备方向信息的变化
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.orientation.watchOrientation( successCB, errorCB, option );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
方向信息是设备相对于水平初始方向分别以z、x、y轴为轴心旋转的角度，对应值为alpha、beta、gamma三个方向的信息。watchOrientation每隔固定时间就获取一次设备的方向信息，通过successCB回调函数返回。可通过option的frequency参数设定获取设备方向信息的时间间隔。方向信息获取失败则调用回调函数errorCB。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.OrientationSuccessCallback">OrientationSuccessCallback</a> ) 必选 获取设备方向信息成功回调函数 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.OrientationErrorCallback">OrientationErrorCallback</a> ) 可选 获取设备方向信息失败回调函数 </li><li>option: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836962#plus.orientation.OrientationOption">OrientationOption</a> ) 可选 监听设备方向信息的参数，如更新数据的频率等 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 用于标识方向信息监听器，可通过clearWatch方法取消监听。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持 </li><li>iOS - 4.3+ (支持) : 支持 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Orientation Example</title>
<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
plus.orientation.watchOrientation( function ( o ) {
alert( "Orientation\nAlpha:" + o.alpha + "\nBeta:" + o.beta + "\nGamma:" + o.gamma );
}, function ( e ) {
alert( "Orientation error: " + e.message );
} );
}
</script>
</head>
<body>
Orientation watch
</body>
</html>
</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.orientation.clearWatch( watchId );
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>watchId: ( Number ) 必选 需要取消的方向监听器标识，调用watchOrientation方法的返回值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持 </li><li>iOS - 4.3+ (支持) : 支持 </li></ul>
<h1 style="margin-left:0;">OrientationOption</h1>
JSON对象，监听设备方向感应器参数
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>frequency: (Number 类型 )更新方向信息的时间间隔 数值类型，单位为ms，默认值为500ms。 </li></ul>
<h1 style="margin-left:0;">Rotation</h1>
JSON对象，设备方向信息数据
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Rotation {
readonly attribute float alpha;
readonly attribute float beta;
readonly attribute float gamma;
readonly attribute float magneticHeading;
readonly attribute float trueHeading;
readonly attribute float headingAccuracy;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>alpha: (float 类型 )以z方向为轴心的旋转角度 浮点数类型，只读属性，取值范围为0到360（不等于360）。 </li><li>beta: (float 类型 )以x方向为轴心的旋转角度 浮点数类型，只读属性，取值范围为-180到180（不等于180）。 </li><li>gamma: (float 类型 )以y方向为轴心的旋转角度 浮点数类型，只读属性，取值范围为-180到180（不等于180）。 </li><li>magneticHeading: (float 类型 )设备方向与地球磁场北极方向的角度 浮点数类型，只读属性，取值范围为0到360（不等于360）。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持) : iTouch、iPad设备不支持 </li></ul></li><li>trueHeading: (float 类型 )设备方向与地球真实北极方向的角度 浮点数类型，只读属性，取值范围为0到360（不等于360）。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持) : iTouch、iPad设备不支持 </li></ul></li><li>headingAccuracy: (float 类型 )设备方向值的误差值 浮点数类型，只读属性，取值范围为0到360（不等于360）。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持)</li><li>iOS - 4.3+ (支持) : iTouch、iPad设备不支持 </li></ul></li></ul>
<h1 style="margin-left:0;">OrientationSuccessCallback</h1>
获取设备方向信息成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( rotation ){
// Get orientation success code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>rotation: ( <ahref="https://www.html5plus.org/doc/zh_cn/orientation.html#plus.orientation.Rotation">Rotation</a> ) 必选 设备的方向信息Rotation </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">OrientationErrorCallback</h1>
获取设备方向信息失败的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onError( error ) {
// Get orientation error code. 
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 失败信息 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

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

Orientation模块管理设备的方向信息，包括alpha、beta、gamma三个方向信息，通过plus. ...