文章分类 Classification
Orientation
稿件来源: 互联网 撰稿作者: 匿名 发表日期: 2015-03-23 阅读次数: 34 查看权限: 游客查看
Orientation模块管理设备的方向信息，包括alpha、beta、gamma三个方向信息，通过plus.orientation可获取设备方向管理对象。
方法：
- getCurrentOrientation获取当前设备的方向信息，包括alpha、beta、gamma三个方向信息
- watchOrientation监听设备方向信息的变化
- clearWatch关闭监听设备方向信息
对象：
- OrientationOptionJSON对象，监听设备方向感应器参数
- RotationJSON对象，设备方向信息数据
回调方法：
- OrientationSuccessCallback获取设备方向信息成功的回调函数
- OrientationErrorCallback获取设备方向信息失败的回调函数
getCurrentOrientation
获取当前设备的方向信息，包括alpha、beta、gamma三个方向信息
void plus.orientation.getCurrentOrientation( successCB, errorCB );
说明：
方向信息是设备相对于水平初始方向分别以z、x、y轴为轴心旋转的角度，对应值为alpha、beta、gamma三个方向的信息。 方向信息可通过successCB回调函数返回。方向信息获取失败则调用回调函数errorCB
参数：
- successCB (OrientationSuccessCallback) 可选 获取设备方向信息成功回调函数
- errorCB (OrientationErrorCallback) 可选 获取设备方向信息失败回调函数
返回值：
无
示例：
<!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( "OrientationnAlpha:" + o.alpha + "nBeta:" + o.beta + "nGamma:" + o.gamma );
} );
}
</script>
</head>
<body>
Orientation
</body>
</html>
watchOrientation
监听设备方向信息的变化
Number plus.orientation.watchOrientation( successCB, errorCB, option );
说明：
方向信息是设备相对于水平初始方向分别以z、x、y轴为轴心旋转的角度，对应值为alpha、beta、gamma三个方向的信息。watchOrientation每隔固定时间就获取一次设备的方向信息，通过successCB回调函数返回。可通过option的frequency参数设定获取设备方向信息的时间间隔。方向信息获取失败则调用回调函数errorCB。
参数：
- successCB (OrientationSuccessCallback) 可选 获取设备方向信息成功回调函数
- errorCB (OrientationErrorCallback) 可选 获取设备方向信息失败回调函数
- option (OrientationOption) 可选 监听设备方向信息的参数，如更新数据的频率等
返回值：
用于标识方向信息监听器，可通过clearWatch方法取消监听。
示例：
<!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( "OrientationnAlpha:" + o.alpha + "nBeta:" + o.beta + "nGamma:" + o.gamma );
}, function ( e ) {
alert( "Orientation error: " + e.message );
} );
}
</script>
</head>
<body>
Orientation watch
</body>
</html>
clearWatch
关闭监听设备方向信息
void plus.orientation.clearWatch( watchId );
说明：
关闭监听设备方向信息
参数：
- watchId (Number) 可选 需要取消的方向监听器标识，调用watchOrientation方法的返回值。
返回值：
无
OrientationOption
JSON对象，监听设备方向感应器参数
属性：
- frequency：Number，数值类型，单位为ms，默认值为500ms。
Rotation
JSON对象，设备方向信息数据
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;
}
属性：
- alpha：float，只读属性，浮点数类型，只读属性，取值范围为0到360（不等于360）。
- beta：float，只读属性，浮点数类型，只读属性，取值范围为-180到180（不等于180）。
- gamma：float，只读属性，浮点数类型，只读属性，取值范围为-180到180（不等于180）。
- magneticHeading：float，只读属性，浮点数类型，只读属性，取值范围为0到360（不等于360）。
- trueHeading：float，只读属性，浮点数类型，只读属性，取值范围为0到360（不等于360）。
- headingAccuracy：float，只读属性，浮点数类型，只读属性，取值范围为0到360（不等于360）。
OrientationSuccessCallback
获取设备方向信息成功的回调函数
void onSuccess( rotation ){
// Get orientation success code.
}
说明：
获取设备方向信息成功的回调函数
参数：
- rotation (DOMString) 必选 设备的方向信息Rotation
OrientationErrorCallback
获取设备方向信息失败的回调函数
void onError( error ) {
// Get orientation error code.
}
说明：
获取设备方向信息失败的回调函数
参数：
- error (DOMException) 必选 失败信息
关键词: html5puls,Orientation 编辑时间: 2015-03-23 23:19:35
0
高兴
0
支持
0
搞笑
0
不解
0
谎言
0
枪稿
0
震惊
0
无奈
0
无聊
0
反对
0
愤怒
0%(0)
0%(0)
中搜索：Orientation
中搜索：Orientation
- 暂无评论
文章图片 article Pictrue
网友评论