Pacote | flash.sensors |
Classe | public class Accelerometer |
Herança | Accelerometer EventDispatcher Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2, Flash Player 10.1, Flash Lite 4 |
Observação: Use a propriedade Accelerometer.isSupported
para testar o ambiente de tempo de execução quanto à capacidade de usar este recurso. Enquanto a classe Accelerometer e os seus membros estiverem acessíveis às Versões do Tempo de Execução listadas para cada entrada de API, o ambiente atual do tempo de execução determinará a disponibilidade deste recurso. Por exemplo, você pode compilar o código que usa as propriedades da classe Acellerometer do Flash Player 10.1, mas tem de usar a propriedade Accelerometer.isSupported
para testar a disponibilidade do recurso Acelerômetro no ambiente de implementação atual do tempo de execução do Flash Player. Se Accelerometer.isSupported
for true
no tempo de execução, então haverá suporte atual para o Acelerômetro.
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.
Saiba mais
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 verdadeiro se o sensor de acelerômetro estiver disponível no dispositivo, de outra maneira, ela é definida para falso. | Accelerometer | ||
muted : Boolean [somente leitura]
Especifica se o usuário tem acesso negado ao acelerômetro (true) ou acesso permitido (false). | Accelerometer |
Método | Definido por | ||
---|---|---|---|
Cria uma nova instância de Accelerometer. | Accelerometer | ||
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. | Accelerometer | ||
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 um acelerômetro altera seu status. | Accelerometer | |||
O evento de atualização é despachado em resposta às atualizações do sensor de acelerômetro. | Accelerometer |
isSupported | propriedade |
isSupported:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2, Flash Player 10.1, Flash Lite 4 |
A propriedade isSupported
é definida para true
se o sensor de acelerômetro estiver disponível no dispositivo, de outra maneira, ela é definida para false
.
Implementação
public static function get isSupported():Boolean
Exemplo ( Como usar este exemplo )
Accelerometer.isSupported
para testar o suporte ao Acelerômetro no tempo de execução. Se o ambiente atual suportar o recurso de Acelerômetro, então um ouvinte de eventos será adicionado ao objeto Acellerometer, e o programa de manipulação associado preencherá o campo de texto com valores de aceleração e marca de data/hora. Caso contrário, o campo de texto indicará que o recurso não é suportado no ambiente atual.
var myTextField:TextField = new TextField(); myTextField.width = 200; addChild(myTextField); var acc1:Accelerometer = new Accelerometer(); var isSupported:Boolean = Accelerometer.isSupported; checksupport(); function checksupport():void { if (isSupported) { myTextField.text = "Accelerometer feature supported"; acc1.addEventListener(AccelerometerEvent.UPDATE, updateHandler); } else { myTextField.text = "Accelerometer feature not supported"; } } function updateHandler(evt:AccelerometerEvent):void { myTextField.text = String("at: " + evt.timestamp + "\n" + "acceleration X: " + evt.accelerationX + "\n" + "acceleration Y: " + evt.accelerationY + "\n" + "acceleration Z: " + evt.accelerationZ); }
muted | propriedade |
muted:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2, Flash Player 10.1 |
Especifica se o usuário tem acesso negado ao acelerômetro (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
Accelerometer | () | Construtor |
public function Accelerometer()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2, Flash Player 10.1, Flash Lite 4 |
Cria uma nova instância de Accelerometer.
setRequestedUpdateInterval | () | método |
public function setRequestedUpdateInterval(interval:Number):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2, Flash Player 10.1, Flash Lite 4 |
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 de aceleração 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 Accelerometer 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 2, Flash Player 10.1, Flash Lite 4 |
Despachado quando um acelerômetro altera seu status.
Observação: em alguns dispositivos, o acelerômetro está sempre disponível. Em tais dispositivos, um objeto Acelerômetro nunca despacha um eventostatus
.
type
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.AccelerometerEvent
propriedade AccelerometerEvent.type =
flash.events. AccelerometerEvent.UPDATE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 2, Flash Player 10.1, Flash Lite 4 |
O evento update
é despachado em resposta às atualizações do sensor de acelerômetro. O evento é despachado nas seguintes circunstâncias:
- Quando uma nova função de ouvinte é anexada por
addEventListener()
, este evento é entregue uma vez a todos os ouvintes registrados para fornecer o valor atual do acelerômetro. - Sempre que as atualizações de acelerômetro forem obtidas da plataforma em intervalos determinados de dispositivo.
- Sempre que o aplicativo ignore uma mudança no acelerômetro (por exemplo, o tempo de execução está prosseguindo depois de estar ocioso).
update
do acelerômetro. Os eventos upadate
do acelerômetro indicam o movimento do dispositivo.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; import flash.events.AccelerometerEvent; import flash.sensors.Accelerometer; public class AccelerometerTest extends Sprite { private var ball:Sprite; private var accelerometer:Accelerometer; private var xSpeed:Number = 0; private var ySpeed:Number = 0; private const RADIUS = 20; public final function AccelerometerTest() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; createBall(); if (Accelerometer.isSupported) { accelerometer = new Accelerometer(); accelerometer.addEventListener(AccelerometerEvent.UPDATE, accUpdateHandler); stage.addEventListener(Event.ENTER_FRAME, enterFrameHandler); } } private final function createBall():void { ball = new Sprite(); ball.graphics.beginFill(0xFF0000); ball.graphics.drawCircle(0, 0, RADIUS); ball.cacheAsBitmap = true; ball.x = stage.stageWidth / 2; ball.y = stage.stageHeight / 2; addChild(ball); } private final function enterFrameHandler(event:Event):void { event.stopPropagation(); moveBall(); } private final function moveBall():void { var newX:Number = ball.x + xSpeed; var newY:Number = ball.y + ySpeed; if (newX < 20) { ball.x = RADIUS; xSpeed = 0; } else if (newX > stage.stageWidth - RADIUS) { ball.x = stage.stageWidth - RADIUS; xSpeed = 0; } else { ball.x += xSpeed; } if (newY < RADIUS) { ball.y = RADIUS; ySpeed = 0; } else if (newY > stage.stageHeight - RADIUS) { ball.y = stage.stageHeight - RADIUS; ySpeed = 0; } else { ball.y += ySpeed; } } private final function accUpdateHandler(event:AccelerometerEvent):void { xSpeed -= event.accelerationX * 2; ySpeed += event.accelerationY * 2; } } }
Wed Jun 13 2018, 11:10 AM Z