FLVPlayback  - AS3 Flash

Número que especifica qué instancia del reproductor de vídeo se verá afectada por otras API (interfaz de programación de aplicaciones). Utilice esta propiedad para administrar varios flujos de archivos FLV.

Esta propiedad no hace visible el reproductor de vídeo; utilice la propiedad visibleVideoPlayerIndex para dicho propósito.

Se crea un nuevo reproductor de vídeo la primera vez que se asigna un valor numérico a activeVideoPlayerIndex. Cuando se crea el nuevo reproductor de vídeo, sus propiedades se establecen en el valor del reproductor de vídeo predeterminado (activeVideoPlayerIndex == 0), salvo source, totalTime y isLive, que siempre se establecen en sus valores predeterminados (cadena vacía, NaN y false, respectivamente) y autoPlay, que siempre es false (el valor predeterminado es true sólo para el reproductor de vídeo predeterminado, es decir, 0). La propiedad cuePoints no produce ningún efecto, ni siquiera si se carga posteriormente en el reproductor de vídeo predeterminado.

Las API que controlan el volumen, la posición, las dimensiones, la visibilidad y los controles de interfaz de usuario siempre son globales y su comportamiento no se ve afectado al establecer el valor de activeVideoPlayerIndex. Establecer la propiedad activeVideoPlayerIndex no afecta a los siguientes métodos y propiedades en concreto.

Nota: la propiedad visibleVideoPlayerIndex, no la propiedad activeVideoPlayerIndex, determina qué reproductor de vídeo controla el aspecto. Asimismo, las API que controlan las dimensiones interactúan con la propiedad visibleVideoPlayerIndex.

Las API restantes se destinan a un reproductor de vídeo específico que depende del valor de activeVideoPlayerIndex.

Para cargar un segundo archivo FLV en segundo plano, establezca activeVideoPlayerIndex como 1 y llame al método load(). Cuando esté preparado para mostrar este archivo FLV y ocultar el otro, establezca visibleVideoPlayerIndex como 1.

El valor predeterminado es 0.

Elementos de API relacionados

Especifica el diseño del vídeo si la propiedad scaleMode se ha establecido como VideoScaleMode.MAINTAIN_ASPECT_RATIO o VideoScaleMode.NO_SCALE. Las dimensiones del vídeo se basan en las propiedades registrationX, registrationY, registrationWidth y registrationHeight. Si se define la propiedad align, los valores proceden de la clase VideoAlign. El valor predeterminado es VideoAlign.CENTER.

Elementos de API relacionados

Valor booleano que, si se establece como true, hace que el archivo FLV comience a reproducirse automáticamente tras definir la propiedad source. Si se establece como false, el archivo FLV se carga, pero no inicia la reproducción hasta que se llama al método play() o playWhenEnoughDownloaded().

La reproducción comienza automáticamente si un archivo FLV se transmite desde Flash Media Server (FMS) y la propiedad autoPlay está establecida como true. Sin embargo, al cargar un archivo FLV mediante descarga progresiva, la reproducción comienza una vez que el archivo FLV se ha descargado lo suficiente, de modo que éste se pueda reproducir de principio a fin.

Para forzar la reproducción sin que el archivo FLV se haya descargado lo suficiente, llame al método play() sin parámetros. Si la reproducción ha comenzado y desea volver al estado de espera de una descarga suficiente y luego comenzar la reproducción automáticamente, llame al método pause() y, a continuación, al método playWhenEnoughDownloaded().

Si establece la propiedad como true en el intervalo entre la carga de nuevos archivos FLV, no se producirá ningún efecto hasta que se establezca la propiedad source.

Establecer la propiedad autoPlay como true y source como una URL tiene el mismo efecto que llamar al método play() con dicha URL.

Llamar al método load() con una URL tiene el mismo efecto que establecer la propiedad source como dicha URL con la propiedad autoPlay establecida como false.

El valor predeterminado es true.

Elementos de API relacionados

Valor booleano que, si es true, hace que el archivo FLV se rebobine hasta el fotograma 1 cuando se detenga la reproducción, ya sea porque el reproductor llegó al final del flujo o porque se llamó al método stop(). Esta propiedad no se utiliza para flujos dinámicos.

El valor predeterminado es false.

Control de reproducción BackButton. Al hacer clic se llama al método seekToPrevNavCuePoint().

Elementos de API relacionados

Número que especifica los bits por segundo establecidos para la transferencia del archivo FLV.

Al transmitir desde un servicio Flash Video Streaming Service que admite la detección automática del ancho de banda, puede proporcionar un archivo SMIL que describa cómo cambiar entre varios flujos en función del ancho de banda. Dependiendo del servicio FVSS, el ancho de banda se puede detectar automáticamente y, si se define este valor, se omitirá.

Al realizar una descarga HTTP puede utilizar el mismo formato SMIL, pero debe establecer la velocidad, ya que no hay detección automática.

Valor booleano. Es true si el vídeo está en estado de almacenamiento en búfer.

Control de la barra de almacenamiento en búfer. Este control aparece cuando el archivo FLV está en estado de carga o de almacenamiento en búfer.

Si se establece como true, oculta el control SeekBar y desactiva los controles Play, Pause, PlayPause, BackButton y ForwardButton mientras el archivo FLV está en estado de almacenamiento en búfer. Esto puede ser útil para evitar que un usuario utilice estos controles para intentar acelerar la reproducción del archivo FLV cuando se descarga o transmite a través de una conexión lenta.

Valor que especifica el número de segundos que se almacenarán en la memoria antes de que se inicie la reproducción de un flujo de vídeo. En los archivos FLV que se transmiten a través de RTMP, que no se descargan y sólo se almacenan en búfer, puede ser importante aumentar el valor predeterminado de 0,1. En los archivos FLV que se descargan progresivamente a través de HTTP, aumentar este valor no supone una gran ventaja, aunque sí puede mejorar la visualización de vídeo de alta calidad en un equipo antiguo que sea más lento.

En el caso de vídeo pregrabado (no dinámico), no defina la propiedad bufferTime como 0: utilice el tiempo de búfer predeterminado o auméntelo.

Esta propiedad no especifica la cantidad de archivo FLV que se descarga antes de iniciar la reproducción.

El valor predeterminado es 0.1.

Elementos de API relacionados

Valor que indica el número de bytes descargados para una descarga HTTP. Devuelve 0 cuando no hay flujo, cuando éste procede de Flash Media Server (FMS) o si la información aún no está disponible. El valor devuelto sólo es útil para una descarga HTTP.

Valor que especifica el número total de bytes descargados para una descarga HTTP. Devuelve 0 cuando no hay flujo, cuando éste procede de Flash Media Server (FMS) o si la información aún no está disponible. El valor devuelto sólo es útil para una descarga HTTP.

Conjunto que describe los puntos de referencia de ActionScript y los puntos de referencia del archivo FLV incorporados desactivados. Esta propiedad se crea específicamente para el inspector de componentes y el inspector de propiedades. No funciona si se establece de cualquier otro modo. Su valor sólo produce efecto en el primer archivo FLV cargado, y sólo si se carga estableciendo la propiedad source en el inspector de componentes o en el inspector de propiedades.

Nota: no es posible acceder a esta propiedad mediante ActionScript. Para acceder a la información de punto de referencia en ActionScript, utilice la propiedad metadata.

Para añadir, quitar, activar o desactivar puntos de referencia con ActionScript, utilice los métodos addASCuePoint(), removeASCuePoint() o setFLVCuePointEnabled().

Elementos de API relacionados

Devuelve el valor siguiente disponible de tabIndex tras los controles de FLVPlayback. El valor se establece una vez llamado el método assignTabIndexes.

Elementos de API relacionados

Control del botón de avance. Al hacer clic se llama al método seekToNextNavCuePoint().

Elementos de API relacionados

Color de fondo utilizado en el modo de pantalla completa. Este color es visible si el vídeo no cubre toda la pantalla en función del valor de la propiedad scaleMode.

El valor predeterminado es 0x000000.

Control del botón FullScreen.

Especifica el tiempo de demora, en milisegundos, para ocultar el aspecto. En modo de pantalla completa, si la propiedad skinAutoHide tiene el valor true, se activa la ocultación automática si el usuario no desplaza el ratón durante más segundos de los indicados por la propiedad fullScreenSkinDelay. Si el ratón está sobre el propio aspecto, la ocultación automática no se activa.

El valor predeterminado es 3000 milliseconds (3 seconds).

Cuando el escenario entra en modo de pantalla completa, el componente FLVPlayback está por encima de todo el contenido y toma el control de toda la pantalla. Cuando el escenario sale del modo de pantalla completa, la pantalla vuelve a su estado anterior.

La configuración recomendada para el modo de pantalla completa es scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO y align = VideoAlign.CENTER.

Si el archivo SWF se carga con el componente FLVPlayback y no tiene acceso al escenario debido a las restricciones de seguridad, el modo de pantalla completa no se activa. No se emiten errores.

El valor predeterminado es true.

Número que especifica la altura de la instancia de FLVPlayback. Esta propiedad sólo afecta a la altura de la instancia de FLVPlayback y no a la de un archivo SWF de aspecto que pueda cargarse. Establecer la propiedad height también establece la propiedad registrationHeight en el mismo valor.

Elementos de API relacionados

Cantidad de tiempo, en milisegundos, antes de que Flash cierre una conexión inactiva con Flash Media Server (FMS) tras realizar una pausa o detener una reproducción. Esta propiedad no produce ningún efecto en la descarga de un archivo FLV a través de HTTP.

Si se establece esta propiedad cuando un flujo de vídeo ya está inactivo, el período de tiempo de espera se reinicia con el nuevo valor.

El valor predeterminado es 300,000 milliseconds (5 minutes).

Elementos de API relacionados

Valor booleano. Es true si el flujo de vídeo es dinámico. Esta propiedad sólo es efectiva cuando se transmite desde Flash Media Server (FMS) u otro servicio Flash Video Streaming Service (FVSS). El valor de esta propiedad se omitirá para una descarga HTTP.

Si establece esta propiedad mientras se cargan nuevos archivos FLV, no tendrá ningún efecto hasta que se establezca el valor de la propiedad source para el nuevo archivo FLV.

Define la propiedad isLive como false si se envía un flujo de vídeo pregrabado al reproductor de vídeo y como true si se envían datos en tiempo real, como una emisión dinámica. Para obtener un mejor rendimiento al definir la propiedad isLive como false, no defina bufferTime con el valor 0.

Elementos de API relacionados

Valor booleano. Es true si el archivo FLV se transmite desde Flash Media Server (FMS) con RTMP. Su valor es false en cualquier otro origen de archivo FLV.

Elementos de API relacionados

Objeto que es un paquete de información de metadatos que se recibe de una llamada al método callback NetSteam.onMetaData(), si está disponible. Está listo cuando se distribuye el evento metadataReceived.

Si el archivo FLV se codifica con el codificador de Flash 8, la propiedad metadata contiene la siguiente información. Los archivos FLV antiguos sólo contienen los valores de height, width y duration.

Más información

Elementos de API relacionados

Valor booleano. Es true si se ha encontrado y procesado un paquete de metadatos o si el archivo FLV se ha codificado sin el paquete de metadatos. Dicho de otro modo, el valor es true si se reciben los metadatos o nunca se van a obtener metadatos. Así, puede saber si tiene los metadatos y, si no los tiene, sabe que no debe esperar a recibirlos. Si simplemente desea saber si tiene metadatos o no, puede comprobar el valor con:

FLVPlayback.metadata != null

Utilice esta propiedad para comprobar si puede obtener información útil con los métodos para buscar y activar o desactivar los puntos de referencia (findCuePoint, findNearestCuePoint, findNextCuePointWithName y isFLVCuePointEnabled).

Elementos de API relacionados

Control del botón de silencio.

Objeto INCManager que proporciona acceso a una instancia de la clase que implementa INCManager, que es una interfaz de la clase NCManager.

Puede utilizar esta propiedad para implementar un objeto INCManager personalizado que requiere una inicialización personalizada.

Elementos de API relacionados

Control del botón de pausa.

Valor booleano. Es true si el archivo FLV está en estado de pausa.

Control del botón de reproducción.

Número que especifica el valor actual de playheadTime como un porcentaje de la propiedad totalTime. Si accede a esta propiedad, verá que contiene el porcentaje de tiempo de reproducción transcurrido. Si establece esta propiedad, provoca una operación de búsqueda en el punto que representa dicho porcentaje del tiempo de reproducción del archivo FLV.

El valor de esta propiedad es relativa al valor de la propiedad totalTime.

Número que representa el tiempo o la posición actual (en segundos) de la cabeza lectora, que puede ser un valor fraccionario. Si se establece esta propiedad, se activa una búsqueda, con todas las restricciones que conlleva.

Cuando cambia el tiempo de la cabeza lectora, lo que ocurre una vez cada 0,25 segundos mientras se reproduce el archivo FLV, el componente distribuye el evento playheadUpdate.

Por varias razones, es posible que la propiedad playheadTime no tenga el valor esperado inmediatamente después de llamar a uno de los métodos de búsqueda o establecer playheadTime para provocar la búsqueda. En primer lugar, en una descarga progresiva, sólo se puede buscar en un fotograma clave, de forma que la búsqueda devuelve como resultado el tiempo del primer fotograma clave después del tiempo especificado. (En la transmisión de flujo, una búsqueda siempre devuelve el tiempo exacto especificado aunque el archivo FLV de origen no tenga ningún fotograma clave en tal punto.) En segundo lugar, la búsqueda es asíncrona, de forma que si se llama a un método de búsqueda o se establece la propiedad playheadTime, el valor de playheadTime no se actualiza inmediatamente. Para obtener el tiempo después de completar la búsqueda, detecte el evento seek, que no se activa hasta que se actualiza la propiedad playheadTime.

Elementos de API relacionados

Número que es la cantidad de tiempo en milisegundos entre cada evento playheadUpdate. Si se establece esta propiedad mientras se está reproduciendo el archivo FLV, se reinicia el temporizador.

Dado que los puntos de referencia de ActionScript se inician cuando se actualiza la cabeza lectora, al disminuir el valor de la propiedad playheadUpdateInterval, puede aumentar la precisión de los puntos de referencia de ActionScript.

Como el intervalo de actualización de la cabeza lectora se establece mediante una llamada al método global setInterval(), la actualización no puede activarse con más frecuencia que la velocidad de fotogramas del archivo SWF, tal y como ocurre con cualquier otro intervalo que se establezca de este modo. Así pues, por ejemplo, para una velocidad de fotogramas predeterminada de 12 fotogramas por segundo, el intervalo efectivo más bajo es aproximadamente 83 milisegundos, o un segundo (1.000 milisegundos) dividido por 12.

El valor predeterminado es 250.

Elementos de API relacionados

Valor booleano. Es true si el archivo FLV está en estado de reproducción.

Control del botón de reproducción/pausa.

Número que especifica la altura del archivo de origen FLV. Esta información no es válida inmediatamente después de llamar a los métodos play() o load(). Es válida cuando se inicia el evento ready. Si el valor de la propiedad scaleMode es VideoScaleMode.MAINTAIN_ASPECT_RATIO o VideoScaleMode.NO_SCALE, es mejor leer el valor tras distribuir el evento layout. Esta propiedad devuelve -1 si aún no hay información disponible.

Elementos de API relacionados

Proporciona la anchura del archivo de origen FLV. Esta información no es válida de forma inmediata después de llamar a los métodos play() o load(), sino tras distribuir el evento ready. Si el valor de la propiedad scaleMode es VideoScaleMode.MAINTAIN_ASPECT_RATIO o VideoScaleMode.NO_SCALE, es mejor leer el valor tras distribuir el evento layout. Esta propiedad devuelve -1 si aún no hay información disponible.

Elementos de API relacionados

Sólo para previsualización dinámica. Lee un archivo PNG para obtener la previsualización.

Número que es la cantidad de tiempo en milisegundos entre cada evento progress. Si establece el valor de esta propiedad mientras se está reproduciendo el flujo de vídeo, se reinicia el temporizador.

El valor predeterminado es 250.

Elementos de API relacionados

Altura utilizada para alinear el contenido del vídeo al realizar el cambio de tamaño automático. No confunda la propiedad registrationHeight con la propiedad height. La propiedad height representa la altura real del contenido del vídeo.

Ejemplo 1: cargue un archivo FLV 80x80 con la configuración siguiente:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Ejemplo 2: cargue el mismo escenario que en el ejemplo 1 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Ejemplo 3: cargue el mismo escenario que en el ejemplo 2 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Establecer la propiedad registrationHeight equivale a establecer la propiedad height y viceversa. Establecer cualquier otra propiedad o llamar a cualquier método que modifique la altura, como scaleX, setSize y setScale también mantiene sincronizadas las propiedades height y registrationHeight.

Anchura utilizada para alinear el contenido del vídeo al realizar el cambio de tamaño automático. No confunda la propiedad registrationWidth con la propiedad width. La propiedad width representa la anchura real del contenido del vídeo.

Ejemplo 1: cargue un archivo FLV 80x80 con la configuración siguiente:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Ejemplo 2: cargue el mismo escenario que en el ejemplo 1 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Ejemplo 3: cargue el mismo escenario que en el ejemplo 2 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Establecer la propiedad registrationWidth equivale a establecer la propiedad width y viceversa. Establecer cualquier otra propiedad o llamar a cualquier método que modifique la anchura, como scaleX, setSize y setScale también mantiene sincronizadas las propiedades width y registrationWidth.

Coordenada x empleada para alinear el contenido de vídeo al cambiar el tamaño automáticamente. No la confunda con la propiedad x, que representa la ubicación real del contenido del vídeo.

Ejemplo 1: cargue un archivo FLV 80x80 con la configuración siguiente:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Ejemplo 2: cargue el mismo escenario que en el ejemplo 1 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Ejemplo 3: cargue el mismo escenario que en el ejemplo 2 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Cuando se establece la propiedad x o registrationX, la segunda propiedad se cambia para mantener su desplazamiento con respecto a la primera. Por ejemplo, si x = 10 y registrationX = 20, establecer x = 110 también establece registrationX = 120.

Coordenada y empleada para alinear el contenido de vídeo al cambiar el tamaño automáticamente. No la confunda con la propiedad y, que representa la ubicación real del contenido del vídeo.

Ejemplo 1: cargue un archivo FLV 80x80 con la configuración siguiente:

• registrationX = 100
• registrationY = 100
• registrationWidth = 60
• registrationHeight = 40
• align = VideoAlign.CENTER
• scaleMode = VideoScaleMode.NO_SCALE

• x = 90
• y = 80
• width = 80
• height = 80

Ejemplo 2: cargue el mismo escenario que en el ejemplo 1 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.MAINTAIN_ASPECT_RATIO

• x = 110
• y = 100
• width = 40
• height = 80

Ejemplo 3: cargue el mismo escenario que en el ejemplo 2 aunque con la configuración siguiente:

• scaleMode = VideoScaleMode.EXACT_FIT

• x = 100
• y = 100
• width = 60
• height = 40

Cuando se establece la propiedad y o registrationY, la segunda propiedad se cambia para mantener su desplazamiento con respecto a la primera. Por ejemplo, si y = 10 y registrationY = 20, establecer y = 110 también establece registrationY = 120.

Especifica cómo cambiará el tamaño del vídeo tras la carga. Si se establece como VideoScaleMode.MAINTAIN_ASPECT_RATIO, mantiene la proporción de vídeo dentro del rectángulo definido por registrationX, registrationY, registrationWidth y registrationHeight. Si se establece como VideoScaleMode.NO_SCALE, el tamaño del vídeo se ajusta automáticamente a las dimensiones del archivo de origen FLV. Si se establece como VideoScaleMode.EXACT_FIT, se omiten las dimensiones del archivo de origen FLV y el vídeo se expande para ajustarse al rectángulo definido por registrationX, registrationY, registrationWidth y registrationHeight. Si se establece tras la carga de un archivo FLV, se iniciará inmediatamente un diseño automático. Los valores proceden de VideoScaleMode.

El valor predeterminado es VideoScaleMode.MAINTAIN_ASPECT_RATIO.

Elementos de API relacionados