Paquete | flash.media |
Clase | public class Video |
Herencia | Video DisplayObject EventDispatcher Object |
Subclases | VideoPlayer |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cuando se utiliza con Flash Media Server, el objeto Video permite enviar vídeo en vivo capturado por 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.
En Flash Player 9 y versiones posteriores se 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. Consulte la clase flash.net.NetStream para obtener más información sobre la reproducción de vídeo y sobre los formatos admitidos.
En Flash Player 9.0.115.0 y versiones posteriores se admite la asignación MIP para optimizar la calidad y el 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
.
Desde el lanzamiento de AIR 25, se ha introducido una nueva etiqueta para Android en app.xml denominada disableMediaCodec
. Al definir esta etiqueta como true
, se desactiva el códec multimedia y el vídeo se descodifica con OpenMax AL. En caso contrario, el códec permanece activado. El valor predeterminado de esta etiqueta es false
.
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 Flash Professional, también puede colocar el objeto Video en el escenario en lugar de añadirlo con addChild()
, de este modo:
- Si el panel Biblioteca no está visible, seleccione Ventana > Biblioteca para mostrarlo.
- 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.
- 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.
- 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.)
En aplicaciones de AIR en el escritorio, la reproducción de vídeo en modo de pantalla completa deshabilita cualquier característica de ahorro de energía de pantalla (cuando lo permite el sistema operativo).
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.
Más información
Elementos de API relacionados
attachNetStream()
flash.media.Camera.getCamera()
flash.net.NetConnection
flash.net.NetStream
flash.display.DisplayObjectContainer.addChild()
flash.display.Stage.addChild()
Propiedad | Definido por | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización. | DisplayObject | ||
alpha : Number
Indica el valor de transparencia alfa del objeto especificado. | DisplayObject | ||
blendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse. | DisplayObject | ||
blendShader : Shader [solo escritura]
Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo. | DisplayObject | ||
cacheAsBitmap : Boolean
Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true. | DisplayObject | ||
constructor : 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 | ||
filters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. | DisplayObject | ||
height : Number
Indica la altura del objeto de visualización, expresada en píxeles. | DisplayObject | ||
loaderInfo : LoaderInfo [solo lectura]
Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización. | DisplayObject | ||
mask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado. | DisplayObject | ||
metaData : Object
Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4. | DisplayObject | ||
mouseX : Number [solo lectura]
Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | DisplayObject | ||
mouseY : Number [solo lectura]
Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | DisplayObject | ||
name : String
Indica el nombre de instancia de DisplayObject. | DisplayObject | ||
opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo. | DisplayObject | ||
parent : DisplayObjectContainer [solo lectura]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. | DisplayObject | ||
root : DisplayObject [solo lectura]
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 | ||
rotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original. | DisplayObject | ||
rotationX : Number
Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | ||
rotationY : Number
Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | ||
rotationZ : Number
Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | ||
scale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente. | DisplayObject | ||
scaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro. | DisplayObject | ||
scaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | ||
scaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | ||
scrollRect : 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 | ||
stage : Stage [solo lectura]
El escenario del objeto de visualización. | DisplayObject | ||
transform : flash.geom: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 [solo lectura]
Un entero que especifica la altura del flujo de vídeo en píxeles. | Video | ||
videoWidth : int [solo lectura]
Un entero que especifica la anchura del flujo de vídeo en píxeles. | Video | ||
visible : Boolean
Indica si el objeto de visualización es visible. | DisplayObject | ||
width : Number
Indica la anchura del objeto de visualización, expresada en píxeles. | DisplayObject | ||
x : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | ||
y : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | ||
z : Number
Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D. | DisplayObject |
Método | Definido por | ||
---|---|---|---|
Crea una nueva instancia de Video. | Video | ||
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 un flujo de vídeo para que se muestre dentro de los límites del objeto Video en la aplicación. | Video | ||
Borra la imagen mostrada actualmente en el objeto Video (no el flujo de vídeo). | Video | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. | DisplayObject | ||
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 | ||
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales). | DisplayObject | ||
Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional. | DisplayObject | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj. | DisplayObject | ||
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 | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario. | DisplayObject | ||
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales). | DisplayObject | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object | ||
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 |
deblocking | propiedad |
deblocking:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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:
- 0: permite que el compresor de vídeo aplique el filtro de desbloqueo si es preciso.
- 1: no utiliza ningún filtro de desbloqueo.
- 2: utilizar el filtro de desbloqueo Sorenson.
- 3: sólo en caso de vídeo On2, utiliza el filtro de desbloqueo de On2 pero ningún filtro de reducción de estelas.
- 4: sólo en caso de vídeo On2, utiliza el filtro de desbloqueo de On2 y el filtro de reducción de estelas.
- 5: sólo en caso de vídeo On2, utiliza el filtro de desbloqueo de On2 y un filtro de reducción de estelas de On2 de alto rendimiento.
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
smoothing | propiedad |
smoothing:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si el vídeo debe suavizarse (interpolarse) al ajustarlo a escala. Para que funcione el suavizado, el motor de ejecución debe estar en modo de alta calidad (modo predeterminado). El valor predeterminado es false
(sin suavizado).
Para la reproducción de vídeo con Flash Player 9.0.115.0 y versiones posteriores, establezca esta propiedad en true
para aprovechar la optimización de imágenes con los mapas MIP.
Implementación
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void
videoHeight | propiedad |
videoHeight:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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. Para archivos de vídeo grabados, este valor es la altura del vídeo. El evento NetStream.Video.DimensionChange se distribuye en el caso de los vídeos grabados cuando cambia este valor.
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
Elementos de API relacionados
videoWidth | propiedad |
videoWidth:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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. Para archivos de vídeo grabados, este valor es la anchura del vídeo. El evento NetStream.Video.DimensionChange se distribuye en el caso de los vídeos grabados cuando cambia este valor.
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
Elementos de API relacionados
Video | () | Información sobre |
public function Video(width:int = 320, height:int = 240)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, 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.
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.
|
Ejemplo ( Cómo utilizar este ejemplo )
var MyVideo:Video = new Video(); addChild(MyVideo); var MyNC:NetConnection = new NetConnection(); MyNC.connect(null); var MyNS:NetStream = new NetStream(MyNC); MyNS.play("http://www.helpexamples.com/flash/video/clouds.flv"); MyVideo.attachNetStream(MyNS); //the clouds.flv video has metadata we're not using, so create //an error handler to ignore the message generated by the runtime //about the metadata MyNS.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); function asyncErrorHandler(event:AsyncErrorEvent):void { //ignore metadata error message }
attachCamera | () | método |
public function attachCamera(camera:Camera):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, 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 capturado por el usuario al objeto Video. El vídeo en vivo se puede reproducir localmente en el mismo equipo o dispositivo en el que se está capturando o se puede enviar a Flash Media Server y utilizar el servidor para transmitirlo a otros usuarios.
Nota: en una aplicación de AIR para iOS, el vídeo de la cámara no se puede mostrar cuando la aplicación utiliza el modo de procesamiento de GPU.
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 .
|
Elementos de API relacionados
Ejemplo
Cómo utilizar este ejemplo
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 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 de vídeo que se reproduce con NetStream.play()
, un objeto Camera o null
. Si utiliza un archivo de vídeo, 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 de vídeo sólo contiene audio; la parte de audio de los archivos de vídeo se reproduce automáticamente cuando se llama a NetStream.play()
. Para controlar el audio asociado a un archivo de vídeo, utilice la propiedad soundTransform
del objeto NetStream que reproduzca el archivo de vídeo.
Parámetros
netStream:NetStream — Un objeto NetStream. Para perder la conexión al objeto Video, transmita un valor null .
|
Elementos de API relacionados
clear | () | método |
public function clear():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Borra la imagen mostrada actualmente en el objeto Video (no el flujo de vídeo). Este método resulta útil para controlar la imagen actual. Por ejemplo, puede borrar la última imagen o mostrar información de espera sin tener que ocultar el objeto Video.
Elementos de API relacionados
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 { stream = 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. } } }
Tue Jun 12 2018, 02:12 PM Z