Пакет | 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 для телевизионных устройств. Дополнительные сведения о поддержке 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 | свойство |
muted:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 26.0 |
Определяет наличие у пользователя доступа к данным о повороте устройства: нет доступа (true
), или доступ разрешен (false
). При изменении этого значения отправляется событие status
.
Реализация
public function get muted():Boolean
Связанные элементы API
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
. Интервал времени измеряется в миллисекундах. Интервал обновления предназначен только в качестве ориентира для экономии заряда аккумулятора. Фактическое время между обновлениями вектора поворота устройства может быть больше или меньше этого значения. Любое изменение в интервале обновления затрагивает все зарегистрированные прослушиватели. Класс DeviceRotation можно использовать, не вызывая метод setRequestedUpdateInterval()
. В этом случае приложение получает обновления с интервалом, используемым устройством по умолчанию.
Параметры
interval:Number — Требуемый интервал обновления. Если для interval установлено значение 0, используется минимальный поддерживаемый интервал обновления.
|
Выдает
ArgumentError — Значение свойства interval меньше нуля.
|
status | Событие |
flash.events.StatusEvent
свойство StatusEvent.type =
flash.events.StatusEvent.STATUS
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 26.0 |
Отправляется, когда изменяется состояние поворота устройства.
Задает значение свойстваtype
для объекта события status
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
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()
, это событие отправляется один раз всем зарегистрированным прослушивателям для того, чтобы передать текущее значение вектор поворота устройства с учетом поворота относительно продольной и поперечной осей, а также кватерниона; - каждый раз при получении обновлений состояния поворота устройства от платформы через установленные устройством интервалы;
- каждый раз, когда приложение пропускает изменение поворота устройства (например, когда среда выполнения восстанавливается после режима ожидания).
type
для объекта события DeviceRotationEvent
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
timestamp | Метка времени обновления объекта DeviceRotation. |
roll | Значение поворота относительно продольной оси устройства в градусах. |
pitch | Значение поворота относительно поперечной оси в градусах. |
yaw | Значение поворота относительно вертикальной оси в градусах. |
quaternion | Данные кватерниона в формате [w, x, y, z] |
Tue Jun 12 2018, 11:34 AM Z