| Paquete | flash.events |
| Clase | public class ThrottleEvent |
| Herencia | ThrottleEvent  Event Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Este evento es un evento de difusión, lo que significa que lo distribuyen todos los objetos EventDispatcher con un detector registrado para este evento. Para obtener más información sobre los eventos de difusión, consulte la clase DisplayObject.
Nota: este evento no tiene ni "fase de captura" ni "fase de propagación", lo que significa que los detectores de eventos deben añadirse directamente a cualquier destino potencial, se encuentre o no en la lista de visualización.
Flash Player puede reducir la aceleración del contenido a una velocidad de fotogramas baja (es decir, la velocidad de fotogramas se reduce a un valor normalmente entre 2 y 8 fps). El contenido no se puede acelerar si su pestaña está oculta o está minimizada. En un dispositivo móvil, el contenido se puede acelerar cuando la retroiluminación se apaga o se activa el modo de protector de pantalla. Antes de acelerar el contenido, se distribuye un evento ThrottleEvent con ThrottleEvent.state=ThrottleType.THROTTLE. La propiedad ThrottleEvent.targetFrameRate contiene el valor de la nueva velocidad de fotogramas de destino.
El contenido puede ejecutar código en el detector de eventos para preparar el acelerador. Esta es una oportunidad para alertar al contenido externo de que el contenido acelerado tiene mucha menos capacidad de respuesta. Por ejemplo, un método FileReference.upload() o FileReference.download() activo podría cancelarse. O bien, si el contenido se comunica a través de LocalConnection con otro SWF, esta es una oportunidad para informar de que el SWF tendrá menor capacidad de respuesta. Tenga en cuenta que contenido acelerado no podrá ser capaz de completar acciones asíncronas antes de acceder al acelerador. El contenido entra en estado de aceleración cuando el detector de eventos devuelve el resultado.
Flash Player puede poner el contenido en pausa. Por ejemplo, el contenido se puede poner en pausa cuando el usuario se desplaza fuera de la pantalla en un dispositivo móvil en un momento en que no se reproduce ni audio ni vídeo. Antes de poner el contenido en pausa, se distribuye un evento ThrottleEvent con ThrottleEvent.state=ThrottleType.PAUSE y ThrottleEvent.targetFrameRate=0. De modo similar a cuando el contenido recibe un evento ThrottleType.THROTTLE, es posible que el contenido ejecute código en el detector de eventos para preparar la pausa. Cuando el detector de eventos devuelve el resultado, el contenido entra en estado de pausa. Durante la pausa, el contenido no responde a la interacción del usuario, por ejemplo, clics del ratón o teclas del teclado. Sin embargo, los eventos de red de ActionScript se siguen pudiendo recibir.
Cuando Flash Player reanuda el contenido desde un estado de aceleración o de pausa, se distribuye un evento ThrottleEvent con ThrottleEvent.state=ThrottleType.RESUME. ThrottleEvent.targetFrameRate describe la velocidad de fotogramas y normalmente es igual a Stage.frameRate. El contenido se puede reanudar cuando cualquier parte del escenario se hace visible o cuando el usuario realiza una petición para que el contenido se reanude.
Las plataformas que admiten aceleración y pausa actualmente son las siguientes: Flash Player para escritorio en Mac y Windows; AIR para móvil y Flash Player para Android. Las siguientes plataformas no distribuyen el evento ThrottleEvent automáticamente porque todavía no admiten realizar una pausa o acelerar: dispositivos con AIR para TV, AIR para escritorio, y Flash Player Linux Desktop.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | |
| cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | |
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | |
| eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | |
| state : String [solo lectura]
Describe el estado al que el reproductor está accediendo:ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [solo lectura]
El destino del evento. | Event | |
| targetFrameRate : Number [solo lectura]
Se distribuye la velocidad de fotogramas que alcanza Flash Player o AIR tras el evento ThrottleEvent. | ThrottleEvent | ||
| type : String [solo lectura]
El tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Crea un objeto Event que contiene información sobre ThrottleEvent. | ThrottleEvent | ||
[override]
Crea una copia del objeto ThrottleEvent y define el valor de cada propiedad para que coincida con el del objeto original. | ThrottleEvent | ||
|
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Comprueba si se ha llamado a preventDefault() en el evento. | Event | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | |
|
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
[override]
Devuelve una cadena con todas las propiedades del objeto ThrottleEvent. | ThrottleEvent | ||
|
Devuelve el valor simple del objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [estática]
Define el valor de la propiedad type de un objeto de evento ThrottleEvent. | ThrottleEvent | ||
state | propiedad |
state:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
Describe el estado al que el reproductor está accediendo: ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME.
Implementación
public function get state():StringElementos de API relacionados
targetFrameRate | propiedad |
targetFrameRate:Number [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
Se distribuye la velocidad de fotogramas que alcanza Flash Player o AIR tras el evento ThrottleEvent.
Por ejemplo, si el contenido se pone en pausa, targetFrameRate es 0. Si·el·contenido·se·está·acelerando,·targetFrameRate suele tener un valor entre 2 y 8, en función de la plataforma en la que se esté ejecutando el contenido, de si se está reproduciendo el audio y de otros factores. Si el contenido se devuelve a la velocidad de fotogramas esperada después que haberse puesto en pausa o acelerado, targetFrameRate es igual que Stage.frameRate.
Implementación
public function get targetFrameRate():NumberElementos de API relacionados
ThrottleEvent | () | Información sobre |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
Crea un objeto Event que contiene información sobre ThrottleEvent. Los objetos de evento se transfieren como parámetros a los detectores de eventos.
Parámetrostype:String — El tipo de evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad type heredada. Sólo hay un tipo de evento ThrottleEvent: ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles heredada.
| |
cancelable:Boolean (default = false)cancelable heredada.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate es 0. Si·el·contenido·se·está·acelerando,·targetFrameRate suele tener un valor entre 2 y 8, en función de la plataforma en la que se esté ejecutando el contenido, de si se está reproduciendo el audio y de otros factores. Si el contenido se devuelve a la velocidad de fotogramas esperada después que haberse puesto en pausa o acelerado, targetFrameRate es igual que Stage.frameRate.
|
Elementos de API relacionados
clone | () | método |
override public function clone():Event| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
Crea una copia del objeto ThrottleEvent y define el valor de cada propiedad para que coincida con el del objeto original.
Valor devueltoEvent — Un nuevo objeto ThrottleEvent con valores de propiedades que coinciden con los del objeto original.
|
toString | () | método |
override public function toString():String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
Devuelve una cadena con todas las propiedades del objeto ThrottleEvent. La cadena tiene el siguiente formato:
[ThrottleEvent type=valor bubbles=valor cancelable=valor state=valor targetFrameRate=valor]
String — Una cadena que contiene todas las propiedades del objeto ThrottleEvent.
|
THROTTLE | Constante |
public static const THROTTLE:String = "throttle"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.2 |
Define el valor de la propiedad type de un objeto de evento ThrottleEvent.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de DisplayObject con un detector registrado para el evento throttle. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE o ThrottleType.RESUME. |
targetFrameRate | Describe la velocidad de fotogramas que Flash Player o AIR buscarán cuando se distribuya el evento ThrottleEvent. Por ejemplo, si el contenido está en pausa, targetFrameRate será 0. Si el contenido se está acelerando, targetFrameRate suele tener un valor entre 2 y 8, en función de la plataforma en la que se esté ejecutando el contenido, de si se está reproduciendo el audio y de otros factores. Si el contenido se devuelve a la velocidad de fotogramas esperada después que haberse puesto en pausa o acelerado, targetFrameRate es igual que Stage.frameRate. |
Elementos de API relacionados
Tue Jun 12 2018, 02:12 PM Z