Paqueteflash.media
Clasepublic class Video
HerenciaVideo Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Subclases VideoPlayer

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase Video muestra vídeo grabado o en vivo en una aplicación sin incorporar el vídeo al archivo SWF. Esta clase crea un objeto Video en una interfaz de Adobe Flash o Adobe Flex que reproduce cualquiera de los siguientes tipos de vídeo: archivos Flash Video (FLV) grabados y almacenados en un servidor o localmente, o el vídeo en vivo capturado del equipo de un usuario. Un objeto Video es un objeto de visualización en la lista de visualización de la aplicación y representa el espacio visual en el que se ejecuta el vídeo en una interfaz de usuario.

Cuando se utiliza con Flash Media Server, el objeto Video permite enviar vídeo en vivo desde el equipo de un usuario al servidor y después difundirlo desde el servidor a los usuarios. Mediante el uso de estas funciones, se pueden desarrollar aplicaciones como un sencillo reproductor de vídeo, un reproductor de vídeo con multipunto que publica de un servidor a otro o una aplicación de vídeo compartida para una comunidad de usuarios.

Flash Player 9 admite la publicación y la reproducción de archivos FLV codificados con códec Sorenson Spark u On2 VP6 y también admite un canal alfa. El códec de vídeo On2 VP6 utiliza menos ancho de banda que tecnologías más antiguas y además ofrece filtros de desbloqueo y reducción de estelas.

Flash Player Update 3 y las versiones posteriores admiten los mapas MIP para optimizar la calidad y rendimiento de las representaciones en tiempo de ejecución. En la reproducción de vídeo, Flash Player utiliza la optimización de mapas MIP si la propiedad smoothing del objeto Video se establece en true.

Al igual que otros objetos que aparecen en la lista de visualización, puede controlar diversas propiedades de los objetos Video. Por ejemplo, puede desplazar el objeto Video por el escenario utilizando sus propiedades x e y, cambiarle el tamaño mediante sus propiedades height y width, etc.

Para reproducir una transmisión de vídeo, utilice attachCamera() o attachNetStream() para vincular el vídeo al objeto Video. A continuación, añada el objeto Video a la lista de visualización mediante addChild().

Si utiliza la herramienta de edición de Flash, puede también colocar el objeto Video en el escenario en lugar de añadirlo con addChild(), de este modo:

  1. Si el panel Biblioteca no está visible, seleccione Ventana > Biblioteca para mostrarlo.
  2. Añada un objeto Video incorporado a la biblioteca haciendo clic en el menú Opciones de la parte derecha de la barra de título del panel Biblioteca y seleccionando Nuevo vídeo.
  3. En el cuadro de diálogo Propiedades de vídeo, asigne un nombre al objeto Video incorporado para su uso en la biblioteca y haga clic en Aceptar.
  4. Arrastre el objeto Video hasta el escenario y utilice el inspector de propiedades para asignarle un nombre de instancia exclusivo como, por ejemplo, my_video. (No le asigne el nombre Video.)

Nota: la clase Video no es una subclase de la clase InteractiveObject, por lo que no puede distribuir eventos de ratón. Sin embargo, puede llamar al método addEventListener() en el contenedor del objeto de visualización que incluye el objeto Video.

Ver los ejemplos

Véase también

attachCamera()
attachNetStream()
flash.media.Camera.getCamera()
flash.net.NetConnection
flash.net.NetStream
flash.display.DisplayObjectContainer.addChild()
flash.display.Stage.addChild()
Clases principales de visualización
Fundamentos de la utilización de vídeo


Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : Number
Indica el valor de transparencia alfa del objeto especificado.
DisplayObject
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Si se define como true, Flash Player deja en caché una representación interna de mapa de bits del objeto de visualización.
DisplayObject
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  deblocking : int
Indica el tipo de filtro aplicado al vídeo descodificado como parte del proceso posterior.
Video
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 Inheritedheight : Number
Indica la altura del objeto de visualización, expresada en píxeles.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[read-only] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.
DisplayObject
 Inheritedmask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
DisplayObject
 InheritedmouseX : Number
[read-only] Indica la coordenada x de la posición del ratón en píxeles.
DisplayObject
 InheritedmouseY : Number
[read-only] Indica la coordenada y de la posición del ratón en píxeles.
DisplayObject
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
 Inheritedroot : DisplayObject
[read-only] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.
DisplayObject
 InheritedscaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
  smoothing : Boolean
Especifica si el vídeo debe suavizarse (interpolarse) al ajustarlo a escala.
Video
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
 Inheritedtransform : Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.
DisplayObject
  videoHeight : int
[read-only] Un entero que especifica la altura del flujo de vídeo en píxeles.
Video
  videoWidth : int
[read-only] Un entero que especifica la anchura del flujo de vídeo en píxeles.
Video
 Inheritedvisible : Boolean
Indica si el objeto de visualización es visible.
DisplayObject
 Inheritedwidth : Number
Indica la anchura del objeto de visualización, expresada en píxeles.
DisplayObject
 Inheritedx : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedy : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
Video(width:int = 320, height:int = 240)
Crea una nueva instancia de Video.
Video
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
  
Especifica una transmisión de vídeo de una cámara para que se muestre dentro de los límites del objeto Video en la aplicación.
Video
  
Especifica una transmisión de vídeo para que se muestre dentro de los límites del objeto Video en la aplicación.
Video
  
Borra la imagen actualmente mostrada en el objeto Video.
Video
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.
DisplayObject
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el objeto de visualización obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y.
DisplayObject
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
 Inherited Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando la lista de visualización se va a actualizar y mostrar.DisplayObject
Información sobre propiedades
deblockingpropiedad
deblocking:int  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica el tipo de filtro aplicado al vídeo descodificado como parte del proceso posterior. El valor predeterminado es 0, lo que permite al compresor de vídeo aplicar un filtro de desbloqueo si es necesario.

El resultado de la compresión de vídeo puede ser imprevisible. Puede utilizar la propiedad deblocking para ajustar los filtros que reducen el bloqueo y, en el caso de vídeo comprimido con el códec On2, las estelas.

Bloqueo es el término empleado para referirse a las imperfecciones visibles que aparecen entre los límites de los bloques que forman cada fotograma de vídeo. Estelas es el término empleado para referirse a los bordes distorsionados que aparecen alrededor de los elementos de una imagen de vídeo.

Hay dos filtros de desbloqueo disponibles: uno en códec Sorenson y uno en códec On2 VP6. Además, hay un filtro de reducción de estelas cuando se utiliza el códec On2 VP6. Para ajustar un filtro, utilice uno de estos valores:

Si se selecciona un valor superior a 2 para vídeo con el códec Sorenson, el descodificador Sorenson usa de forma predeterminada el modo 2.

El uso del filtro de desbloqueo tiene un efecto global en el rendimiento de la reproducción y normalmente no es necesario para vídeo de banda ancha. Si el sistema del usuario no es lo suficientemente potente, es posible que surjan dificultades para reproducir vídeo con un filtro de desbloqueo activado.


Implementación
    public function get deblocking():int
    public function set deblocking(value:int):void
smoothingpropiedad 
smoothing:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica si el vídeo debe suavizarse (interpolarse) al ajustarlo a escala. Para que funcione el suavizado, el reproductor debe estar en modo de alta calidad. El valor predeterminado es false (sin suavizado).

Para la reproducción de vídeo con Flash Player Update 3 y versiones posteriores, establezca esta propiedad en true a fin de aprovechar la optimización de imagen de mapas MIP (o mipmap).


Implementación
    public function get smoothing():Boolean
    public function set smoothing(value:Boolean):void
videoHeightpropiedad 
videoHeight:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un entero que especifica la altura del flujo de vídeo en píxeles. En el caso de flujos en vivo, este valor es el mismo que el de la propiedad Camera.height del objeto Camera que está capturando el flujo de vídeo. En el caso de archivos FLV, este valor es la altura del archivo exportado como FLV.

Puede utilizar esta propiedad, por ejemplo, para asegurarse de que el usuario está viendo el vídeo con el mismo tamaño con el que se capturó, con independencia del tamaño real del objeto Video existente en el escenario.


Implementación
    public function get videoHeight():int

Véase también

videoWidthpropiedad 
videoWidth:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un entero que especifica la anchura del flujo de vídeo en píxeles. En el caso de flujos en vivo, este valor es el mismo que el de la propiedad Camera.width del objeto Camera que está capturando el flujo de vídeo. En el caso de archivos FLV, este valor es la anchura del archivo exportado como archivo FLV.

Puede utilizar esta propiedad, por ejemplo, para asegurarse de que el usuario está viendo el vídeo con el mismo tamaño con el que se capturó, con independencia del tamaño real del objeto Video existente en el escenario.


Implementación
    public function get videoWidth():int

Véase también

Información sobre constructores
Video()constructor
public function Video(width:int = 320, height:int = 240)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea una nueva instancia de Video. Si no se suministran valores para los parámetros width y height, se utilizan los valores predeterminados. También se pueden establecer las propiedades de anchura y altura del objeto Video después de la construcción inicial; para ello, utilice Video.width y Video.height. Al crear un nuevo objeto Video, no se permiten valores de cero para la anchura o la altura; si se transmite un cero, se aplicarán los valores predeterminados.

Una vez creado el objeto Video, llame al método DisplayObjectContainer.addChild() o DisplayObjectContainer.addChildAt() para añadir el objeto Video a un objeto DisplayObjectContainer principal.

Parámetros
width:int (default = 320) — La anchura del vídeo, en píxeles.
 
height:int (default = 240) — La altura del vídeo, expresada en píxeles.
Información sobre métodos
attachCamera()método
public function attachCamera(camera:Camera):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica una transmisión de vídeo de una cámara para que se muestre dentro de los límites del objeto Video en la aplicación.

Utilice este método para conectar vídeo en vivo del equipo de un usuario al objeto Video. El vídeo en vivo se puede reproducir localmente en el mismo equipo en el que se está capturando o se puede enviar a Flash Media Server y utilizar el servidor para transmitirlo a otros usuarios.

Parámetros

camera:Camera — Un objeto Camera que captura datos de vídeo. Para perder la conexión al objeto Video, transmita un valor null.

Véase también


Ejemplo
Cómo utilizar los ejemplos
Consulte el ejemplo del método Camera.getCamera() para ver el modo en que se utiliza este método.
attachNetStream()método 
public function attachNetStream(netStream:NetStream):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica una transmisión de vídeo para que se muestre dentro de los límites del objeto Video en la aplicación. La transmisión de vídeo es un archivo FLV que se reproduce con NetStream.play(), un objeto Camera o null. Si utiliza un archivo FLV, se puede almacenar en el sistema de archivos local o en Flash Media Server. Si el valor del argumento netStream es null, el vídeo ya no se reproduce en el objeto Video.

No es necesario que utilice este método si el archivo FLV sólo contiene audio; la parte de audio de los archivos FLV se reproduce automáticamente cuando se llama a NetStream.play(). Para controlar el audio asociado a un archivo FLV, utilice la propiedad soundTransform del objeto NetStream que reproduzca el archivo FLV.

Parámetros

netStream:NetStream — Un objeto NetStream. Para perder la conexión al objeto Video, transmita un valor null.

Véase también


Ejemplo
Cómo utilizar los ejemplos
Consulte el ejemplo al final de esta clase para saber cómo utilizar este método.
clear()método 
public function clear():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Borra la imagen actualmente mostrada en el objeto Video. Esto resulta útil cuando se desea mostrar información de espera sin tener que ocultar el objeto Video.

Véase también

Ejemplos Cómo utilizar los ejemplos
VideoExample.as

En el ejemplo siguiente, se utiliza un objeto Video con las clases NetConnection y NetStream para cargar y reproducir un archivo FLV. Para ejecutar este ejemplo, necesita un archivo FLV con el mismo nombre y ubicación que la variable transferida a videoURL; en este caso, un archivo FLV denominado Video.flv que se encuentra en el mismo directorio que el archivo SWF.

En este ejemplo, el código que crea los objetos Video y NetStream y llama a los métodos Video.attachNetStream() y NetStream.play() se coloca en una función de controlador. Sólo se llamará al controlador si el intento de conexión con el objeto NetConnection se realiza correctamente; es decir, si el evento netStatus devuelve un objeto info con una propiedad a code que indica la realización correcta. Se recomienda que espere a establecer una conexión correcta antes de llamar a NetStream.play().


 package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;

    public class VideoExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function VideoExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }
    }
 }




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/media/Video.html