DeviceRotation

包	flash.sensors
类	public class DeviceRotation
继承	DeviceRotation EventDispatcher Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

DeviceRotation 类根据设备的加速计、陀螺仪传感器检测到的活动调度事件。此数据表示设备的翻滚、俯仰、偏航和四元数。当设备旋转时，传感器检测此旋转并返回此数据。DeviceRotation 类提供了各种方法，用于查询是否支持设备旋转事件处理以及设置调度设备旋转事件时使用的速率。

注意：使用 DeviceRotation.isSupported 属性测试运行时环境是否能够使用此功能。虽然多个运行时平台和设备可以访问 DeviceRotation 类及其成员，但是这并不意味着运行时始终支持该处理函数。某些情况下（例如 Android 版本等），该处理函数不受支持，因此您必须使用 DeviceRotation.isSupported 属性检查该处理函数的支持情况。如果 DeviceRotation.isSupported 在运行时为 true，则当前存在 DeviceRotation 支持。

AIR 配置文件支持：仅移动设备支持此功能。桌面或 AIR for TV 设备不支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 AIR 配置文件支持。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		isSupported : Boolean [静态] [只读] 如果加速计和陀螺仪传感器在设备上可用，则 isSupported 属性设置为 true，否则，设置为 false。	DeviceRotation
		muted : Boolean [只读] 指定用户是已经拒绝对设备旋转数据的访问 (true) 还是已经允许对设备旋转数据的访问 (false)。	DeviceRotation

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		DeviceRotation() 创建一个新的 DeviceRotation 实例。	DeviceRotation
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setRequestedUpdateInterval(interval:Number):void setRequestedUpdateInterval 方法用于设置更新所需的时间间隔。	DeviceRotation
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
status	当设备旋转更改其状态时调度。	DeviceRotation
update	当设备旋转来响应加速计和陀螺仪传感器的组合读数更新时调度 update 事件。	DeviceRotation

属性详细信息

isSupported

属性

isSupported:Boolean [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

如果加速计和陀螺仪传感器在设备上可用，则 isSupported 属性设置为 true，否则，设置为 false。

实现
public static function get isSupported():Boolean

示例 ( 如何使用本示例 )

在以下示例中，DeviceRotation.isSupported 属性用于在运行时测试是否支持 DeviceRotation。如果当前的环境支持 DeviceRotation 功能，那么会为 DeviceRotation 对象添加一个事件侦听器，并且相关的处理程序会使用时间戳和滚动、偏移和间距值来填充文本字段。否则，该文本字段会指示当前的环境不支持该功能。

var myTextField:TextField = new TextField();
myTextField.width = 200;
addChild(myTextField);
var deviceRotation = new DeviceRotation();
var isSupported:Boolean = DeviceRotation.isSupported;
checksupport();

function checksupport():void {
    if (isSupported) {
        myTextField.text = "DeviceRotation feature supported";
        deviceRotation.addEventListener(DeviceRotationEvent.UPDATE,deviceRotUpdateHandler);
    } else {
        myTextField.text = "DeviceRotation feature not supported";
    }
}

function deviceRotUpdateHandler(evt:DeviceRotationEvent):void {
    myTextField.text = String("at: " + evt.timestamp + "\n" + "Roll: " + evt.roll + "\n" + "Yaw: " + evt.yaw + "\n" + "Pitch: " + evt.pitch);

}

muted

属性

muted:Boolean [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

指定用户是已经拒绝对设备旋转数据的访问 (true) 还是已经允许对设备旋转数据的访问 (false)。当此值发生变化时，会调度 status 事件。

实现
public function get muted():Boolean

()

构造函数

public function DeviceRotation()

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

创建一个新的 DeviceRotation 实例。

方法详细信息

setRequestedUpdateInterval

()

方法

public function setRequestedUpdateInterval(interval:Number):void

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

setRequestedUpdateInterval 方法用于设置更新所需的时间间隔。以毫秒为单位度量时间间隔。更新间隔仅用作节省电池电量的提示。设备旋转矢量更新间的实际时间可能大于或小于此值。更新间隔的任何更改都会影响所有注册侦听器。无需调用 setRequestedUpdateInterval() 方法即可使用 DeviceRotation 类。在这种情况下，应用程序会根据设备的默认间隔接收更新。

参数

interval:Number — 请求更新的间隔。如果 interval 设置为 0，则使用支持的更新时间间隔的最小值。

引发

ArgumentError — 指定的 interval 小于零。

事件详细信息

status

事件

事件对象类型: flash.events.StatusEvent
属性 StatusEvent.type = flash.events.StatusEvent.STATUS

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

当设备旋转更改其状态时调度。

定义 status 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`code`	对象状态的描述。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`level`	消息类别，例如 `"status"`、`"warning"` 或 `"error"`。
`target`	报告其状态的对象。

update

事件

事件对象类型: flash.events.DeviceRotationEvent
属性 DeviceRotationEvent.type = flash.events.DeviceRotationEvent.UPDATE

语言版本:

ActionScript 3.0

运行时版本:

AIR 26.0

当设备旋转来响应加速计和陀螺仪传感器的组合读数更新时调度 update 事件。在下列情况下调度此事件：

当通过 addEventListener() 附加新的侦听器函数时，此事件将一次性传送给所有注册的侦听器，用于在翻滚、俯仰和四元数方面提供设备旋转矢量的当前值。
以设备确定的间隔从平台获得设备旋转更新时。
当应用程序丢失对设备旋转的更改时（例如，空闲状态后恢复运行时）。

定义 DeviceRotationEvent 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`timestamp`	DeviceRotation 更新的时间戳。
`roll`	以度为单位的翻滚值。
`pitch`	以度为单位的俯仰值。
`yaw`	以度为单位的偏航值。
`quaternion`	格式为 [w, x, y, z] 的四元数据

法律声明 | 在线隐私策略

DeviceRotation - AS3

类 x

isSupported

muted

DeviceRotation

setRequestedUpdateInterval

status

update