패키지 | flash.sensors |
클래스 | public class DeviceRotation |
상속 | DeviceRotation EventDispatcher Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 26.0 |
참고:
DeviceRotation.isSupported
속성을 사용하여 런타임 환경이 이 기능을 사용할 수 있는지 테스트합니다. DeviceRotation 클래스 및 해당 멤버를 여러 런타임 플랫폼 및 장치에서 액세스할 수 있다고 해서 핸들러가 런타임에 항상 지원되는 것은 아닙니다. 이 핸들러가 지원되지 않는 Android 버전 같은 몇 가지 경우가 있으므로 DeviceRotation.isSupported
속성을 사용하여 이 핸들러가 지원되는지 여부를 확인해야 합니다. 런타임에 DeviceRotation.isSupported
가 true
로 반환되면 DeviceRotation이 현재 지원되는 것입니다.
AIR 프로파일 지원: 이 기능은 휴대 장치에서만 지원됩니다. 데스크톱 또는 AIR for TV 장치에서는 지원되지 않습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
isSupported : Boolean [정적] [읽기 전용]
장치에서 가속도계 및 자이로스코프 센서를 사용할 수 있으면 isSupported 속성이 true로 설정되고, 그렇지 않으면 false로 설정됩니다. | DeviceRotation | ||
muted : Boolean [읽기 전용]
사용자가 장치 회전 데이터에 대한 액세스를 거부(true)했는지 아니면 허용(false)했는지 나타냅니다. | DeviceRotation |
메서드 | 정의 주체 | ||
---|---|---|---|
새 DeviceRotation 인스턴스를 만듭니다. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
setRequestedUpdateInterval 메서드는 원하는 업데이트 시간 간격을 설정하는 데 사용됩니다. | DeviceRotation | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
이벤트 | 요약 | 정의 주체 | ||
---|---|---|---|---|
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | |||
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | |||
장치 회전 상태가 변경될 때 전달됩니다. | DeviceRotation | |||
update 이벤트는 가속도계 및 자이로스코프 센서의 통합된 판독값을 기반으로 한 업데이트에 반응하여 장치가 회전할 때 전달됩니다. | DeviceRotation |
isSupported | 속성 |
isSupported:Boolean
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 26.0 |
장치에서 가속도계 및 자이로스코프 센서를 사용할 수 있으면 isSupported
속성이 true
로 설정되고, 그렇지 않으면 false
로 설정됩니다.
구현
public static function get isSupported():Boolean
예제 ( 예제 사용 방법 )
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 | 속성 |
DeviceRotation | () | 생성자 |
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 이 영(0)보다 작습니다.
|
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] 형식의 쿼터니언 데이터입니다. |
Tue Jun 12 2018, 03:17 PM Z