ThrottleEvent

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

Un evento ThrottleEvent se distribuye cuando Flash Player acelera, pone en pausa o reanuda contenido. Sólo hay un tipo de evento ThrottleEvent: 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

flash.display.DisplayObject
flash.display.Stage
flash.events.ThrottleType

Propiedades públicas

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étodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	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
		clone():Event [override] Crea una copia del objeto ThrottleEvent y define el valor de cada propiedad para que coincida con el del objeto original.	ThrottleEvent
		formatToString(className:String, ... arguments):String Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isDefaultPrevented():Boolean Comprueba si se ha llamado a preventDefault() en el evento.	Event
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		preventDefault():void Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.	Event
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		stopImmediatePropagation():void Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.	Event
		stopPropagation():void Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.	Event
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String [override] Devuelve una cadena con todas las propiedades del objeto ThrottleEvent.	ThrottleEvent
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		THROTTLE : String = "throttle" [estática] Define el valor de la propiedad type de un objeto de evento ThrottleEvent.	ThrottleEvent

Información sobre propiedades

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():String

Elementos de API relacionados

flash.events.ThrottleType

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():Number

Elementos de API relacionados

flash.display.Stage

Información sobre constructores

()

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ámetros

	`type: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`) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad `bubbles` heredada.

	`cancelable:Boolean` (default = `false`) — Determina si se puede cancelar el objeto Event. Los detectores de eventos pueden acceder a esta información a través de la propiedad `cancelable` heredada.

	`state:String` (default = `null`) — `ThrottleType.THROTTLE`, `ThrottleType.PAUSE` o `ThrottleType.RESUME`.

	`targetFrameRate:Number` (default = `0`) — Describe la velocidad de fotogramas que Flash Player o AIR buscarán cuando se distribuya 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`.

Elementos de API relacionados

flash.display.Stage

Información sobre métodos

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 devuelto

Event — 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]

Valor devuelto

String — Una cadena que contiene todas las propiedades del objeto ThrottleEvent.

Información sobre constantes

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

flash.display.Stage

Avisos legales | Política de privacidad en línea

ThrottleEvent - AS3

Clases x

state

targetFrameRate

ThrottleEvent

clone

toString

THROTTLE