| 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
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| 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():BooleanExemplo ( 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():BooleanElementos 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.StatusEventpropriedade 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.AccelerometerEventpropriedade 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