DeviceRotation

套件	flash.sensors
類別	public class DeviceRotation
繼承	DeviceRotation EventDispatcher Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

DeviceRotation 類別會根據裝置的加速計、迴轉儀感應器偵測到的活動來傳送事件。這個資料代表裝置的滾動、俯仰、偏轉和四元數。當裝置旋轉時，感應器會偵測到此次旋轉並傳回這個資料。DeviceRotation 類別提供查詢是否支援裝置旋轉事件處理的方法，同時也設定裝置旋轉事件傳送的速率。

注意：使用 DeviceRotation.isSupported 屬性可以測試執行階段環境是否有能力使用此功能。雖然多個執行階段平台和裝置都可以存取裝置旋轉類別及其成員，但這不意味著處理常式總是在執行階段受到支援。在 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

相關 API 元素

status

建構函式詳細資料

()

建構函式

public function DeviceRotation()

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

建立新的 DeviceRotation 實體。

方法詳細資訊

setRequestedUpdateInterval

()

方法

public function setRequestedUpdateInterval(interval:Number):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 26.0

setRequestedUpdateInterval 方法用於設定希望的更新時間間隔。時間間隔的測量以毫秒為單位。更新間隔僅用於提示以保留電池電力。裝置旋轉向量更新之間的實際時間可能大於或小於這個值。在更新間隔中所做的任何變更會影響所有註冊的偵聽程式。您可以使用 DeviceRotation 類別，無需呼叫 setRequestedUpdateInterval() 方法。在這種情況下，應用程式會根據裝置預設間隔接收更新。

參數

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

語言元素

附錄

套件 flash.sensors

isSupported

muted

DeviceRotation

setRequestedUpdateInterval

status

update