Clase NetStream

Disponibilidad

Flash Player 7.

Nota: esta clase también se admite en Flash Player 6 cuando se utiliza con Flash Communication Server. Para más información, consulte la documentación de Flash Communication Server.

Descripción

La clase NetStream proporciona métodos y propiedades para reproducir archivos de Flash Video (FLV) del sistema de archivos local o de una dirección HTTP. Utilice un objeto NetStream para transmitir vídeo mediante un objeto NetConnection. La reproducción de archivos FLV externos ofrece varias ventajas frente a la incorporación de vídeo en un documento de Flash, como por ejemplo mejor rendimiento y administración de la memoria y velocidades de fotogramas de vídeo y Flash independientes. Esta clase proporciona una serie de métodos y propiedades que puede utilizar para llevar el seguimiento del progreso de la carga y la reproducción de un archivo, así como para proporcionar al usuario el control de la reproducción (detener, pausa, etc.).

Para más información sobre la reproducción de vídeo, consulte Reproducción dinámica de archivos FLV externos.

Resumen de métodos para la clase NetStream

Los métodos y propiedades siguientes de las clases NetConnection y NetStream se utilizan para controlar la reproducción de FLV.

Método	Propósito
`NetStream.close()`	Cierra el flujo pero no se borra el objeto de vídeo.
`NetStream.pause()`	Pausa o reanuda la reproducción de un flujo.
`NetStream.play()`	Inicia la reproducción de un archivo de vídeo externo (FLV).
`NetStream.seek()`	Busca una posición específica en el archivo FLV.
`NetStream.setBufferTime()`	Especifica cuántos datos debe haber en el búfer antes de empezar a visualizar el flujo.

Resumen de propiedades para la clase NetStream

Propiedad	Descripción
`NetStream.bufferLength`	Número de segundos de los datos que hay en el búfer.
`NetStream.bufferTime`	Sólo lectura; número de segundos que `NetStream.setBufferTime()` asigna al búfer.
`NetStream.bytesLoaded`	Sólo lectura; número de bytes de datos que se han cargado en el reproductor.
`NetStream.bytesTotal`	Sólo lectura; tamaño total en bytes del archivo que se está cargando en el reproductor.
`NetStream.currentFps`	Número de fotogramas por segundo que se está visualizando.
`NetStream.time`	Sólo lectura; posición de la cabeza lectora, en segundos.

Resumen de controladores de eventos para la clase NetStream

Controlador de eventos	Descripción
`NetStream.onStatus`	Se invoca cada vez que se genera un cambio de estado o un error para el objeto NetStream.

Constructor para la clase NetStream

Disponibilidad

Flash Player 7.

Nota: esta clase también se admite en Flash Player 6 cuando se utiliza con Flash Communication Server. Para más información, consulte la documentación de Flash Communication Server.

Sintaxis

new NetStream(my_nc)

Parámetros

my_nc Objeto NetConnection.

Valor devuelto

Ninguno.

Descripción

Constructor; crea un flujo que puede utilizarse para reproducir archivos FLV a través del objeto NetConnection especificado.

Ejemplo

En el código siguiente, en primer lugar se construye un nuevo objeto NetConnection, my_nc, y se utiliza para construir un nuevo objeto NetStream denominado videoStream_ns.

my_nc = new NetConnection();
my_nc.connect(null);
videoStream_ns = new NetStream(my_nc);

Véase también

Clase NetConnection, Clase NetStream, Video.attachVideo()