Pacote | flash.sensors |
Classe | public class DeviceRotation |
Herança | DeviceRotation EventDispatcher Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
Observação: use a propriedade DeviceRotation.isSupported
para testar o ambiente de tempo de execução quanto à capacidade de usar este recurso. Quando a classe de rotação do Dispositivo e seus membros estiverem acessíveis por várias plataformas e dispositivos de tempo de execução, isso não significa que o manipulador é sempre suportado no tempo de execução. Há alguns casos como Android versão etc. onde esse controlador não é suportado e, portanto, você deve verificar o suporte desse manipulador usando a propriedade DeviceRotation.isSupported
. Caso DeviceRotation.isSupported
seja true
durante o tempo de execução, então o suporte ao DeviceRotation existe.
Suporte a perfil do AIR: Este recurso é suportado só em dispositivos móveis. Não conta com o suporte em desktops nem em dispositivos AIR for TV. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Elementos da API relacionados
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
isSupported : Boolean [estático] [somente leitura]
A propriedade isSupported é definida para true se os sensores de acelerômetro e de giroscópio estiverem disponíveis no dispositivo, de outra maneira, ela é definida para false. | DeviceRotation | ||
muted : Boolean [somente leitura]
Especifica se o usuário tem acesso negado aos dados de Rotação do dispositivo (true) ou acesso permitido (false). | DeviceRotation |
Método | Definido por | ||
---|---|---|---|
Cria uma nova ocorrência de DeviceRotation. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
O método setRequestedUpdateInterval é usado para definir o intervalo de tempo para as atualizações. | DeviceRotation | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando a rotação do dispositivo alterar seu status. | DeviceRotation | |||
O evento de atualização é despachado quando o dispositivo é girado em resposta às atualizações de leituras combinadas dos sensores do acelerômetro e do giroscópio. | DeviceRotation |
isSupported | propriedade |
isSupported:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
A propriedade isSupported
é definida para true
se os sensores de acelerômetro e de giroscópio estiverem disponíveis no dispositivo, de outra maneira, ela é definida para false
.
Implementação
public static function get isSupported():Boolean
Exemplo ( Como usar este exemplo )
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 | propriedade |
muted:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
Especifica se o usuário tem acesso negado aos dados de Rotação do dispositivo (true
) ou acesso permitido (false
). Quando esse valor for alterado, é despachado um evento status
.
Implementação
public function get muted():Boolean
Elementos da API relacionados
DeviceRotation | () | Construtor |
public function DeviceRotation()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
Cria uma nova ocorrência de DeviceRotation.
setRequestedUpdateInterval | () | método |
public function setRequestedUpdateInterval(interval:Number):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
O método setRequestedUpdateInterval
é usado para definir o intervalo de tempo desejado para as atualizações. O intervalo de tempo é medido e exibido em milissegundos. O intervalo de atualização só é usado como uma sugestão para economizar a bateria. A hora real entre atualizações do vetor de rotação do dispositivo pode ser maior ou menor do que este valor. Qualquer mudança no intervalo de atualização afeta todos os ouvintes registrados. Você pode usar a classe DeviceRotation sem chamar o métodosetRequestedUpdateInterval()
. Nesta caixa, o aplicativo recebe atualizações baseadas no intervalo de padrão do dispositivo.
Parâmetros
interval:Number — O intervalo de atualização solicitado. Se o intervalo estiver definido como 0, o mínimo intervalo de atualização compatível será usado.
|
Lança
ArgumentError — O interval especificado é menor do que zero.
|
status | Evento |
flash.events.StatusEvent
propriedade StatusEvent.type =
flash.events.StatusEvent.STATUS
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
Despachado quando a rotação do dispositivo alterar seu status.
Define o valor da propriedadetype
de um objeto de evento status
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
code | Uma descrição do status do objeto. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
nível | A categoria da mensagem, como "status" , "warning" ou "error" . |
target | O objeto que está reportando o status. |
update | Evento |
flash.events.DeviceRotationEvent
propriedade DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 26.0 |
O evento update
é despachado quando o dispositivo é girado em resposta às atualizações de leituras combinadas dos sensores do acelerômetro e do giroscópio. O evento é despachado nas seguintes circunstâncias:
- Quando uma nova função de ouvinte é anexada por
addEventListener()
, esse evento é entregue uma vez a todos os ouvintes registrados para fornecer o valor atual do vetor de rotação do dispositivo em termos de rolagem, inclinação e quatérnios. - Sempre que as atualizações de rotação do dispositivo sejam obtidas da plataforma em intervalos determinados de dispositivo.
- Sempre que o aplicativo ignore uma mudança na rotação do dispositivo (por exemplo, o runtime está prosseguindo depois de estar ocioso).
type
de um objeto de evento DeviceRotationEvent
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
timestamp | O carimbo de data e hora da atualização de DeviceRotation. |
roll | O valor de rolagem em graus. |
pitch | O valor de inclinação em graus. |
yaw | O valor de guinada em graus. |
quaternion | Os dados de quatérnio no formato [w, x, y, z] |
Wed Jun 13 2018, 11:10 AM Z