Pacchettoflash.media
Classepublic class Video
EreditarietàVideo Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sottoclassi VideoPlayer

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Video visualizza video dal vivo o registrati in un'applicazione senza inserire il video nel file SWF. Questa classe crea un oggetto Video in un'interfaccia Adobe Flash o Adobe Flex che riproduce uno dei seguenti tipi di video: file Flash Video (FLV) registrati su un server o in locale o video dal vivo acquisiti dal computer di un utente. Un oggetto Video è un oggetto di visualizzazione dell'elenco di visualizzazione dell'applicazione e rappresenta lo spazio visivo in cui viene riprodotto il video in un'interfaccia utente.

Se utilizzato con Flash Media Server, l'oggetto Video consente di inviare video dal vivo da un computer utente al server e di trasmetterlo dal server ad altri utenti. Utilizzando queste funzioni, è possibile sviluppare applicazioni multimediali come un semplice lettore video, un lettore video con pubblicazione multipoint da un server a un altro o un'applicazione per la condivisione video per una comunità di utenti.

Flash Player 9 supporta la pubblicazione e la riproduzione di file FLV codificati con il codec Sorenson Spark o con il codec On2 VP6 e supporta un canale alfa. Il codec per video On2 VP6 utilizza un'ampiezza di banda inferiore rispetto alle tecnologie precedenti, offrendo inoltre filtri di deblock e deringing aggiuntivi.

Flash Player Aggiornamento 3 e versioni successive supportano il mipmapping per ottimizzare la qualità e le prestazioni del rendering in fase di runtime. Per la riproduzione video, Flash Player utilizza l'ottimizzazione del mipmapping se la proprietà smoothing dell'oggetto Video è impostata su true.

Analogamente a quanto avviene con altri oggetti di visualizzazione presenti nell'elenco di visualizzazione, è possibile controllare diverse proprietà degli oggetti Video. Ad esempio, è possibile spostare l'oggetto Video sullo stage mediante le proprietà x e y, modificarne le dimensioni mediante le proprietà height e width e così via.

Per riprodurre uno streaming video, utilizzare attachCamera() o attachNetStream() per allegare il video all'oggetto Video. Aggiungere quindi l'oggetto Video all'elenco di visualizzazione utilizzando addChild().

Se si utilizza lo strumento di creazione di Flash, è possibile posizionare l'oggetto Video nello stage piuttosto che aggiungerlo con addChild(), come segue:

  1. Se il pannello Libreria non è visibile, selezionare Finestra > Libreria per visualizzarlo.
  2. Aggiungere alla libreria un oggetto Video incorporato facendo clic sul menu Opzioni presente sul lato destro della barra del titolo del pannello Libreria e selezionare Nuovo video.
  3. Nella finestra di dialogo delle proprietà video, assegnare un nome all'oggetto Video inserito per utilizzarlo nella libreria e fare clic su OK.
  4. Trascinare l'oggetto Video sullo stage e utilizzare la finestra di ispezione Proprietà per assegnargli un nome di istanza univoco, ad esempio my_video (non utilizzare il nome Video).

Nota: la classe Video non è una sottoclasse di InteractiveObject, quindi non può inviare eventi del mouse. È possibile tuttavia chiamare il metodo addEventListener() sul contenitore dell'oggetto di visualizzazione che contiene l'oggetto Video.

Vedere gli esempi

Vedere anche

attachCamera()
attachNetStream()
flash.media.Camera.getCamera()
flash.net.NetConnection
flash.net.NetStream
flash.display.DisplayObjectContainer.addChild()
flash.display.Stage.addChild()
Classi di visualizzazione di base
Elementi fondamentali del video


Proprietà pubbliche
 ProprietàDefinito da
 InheritedaccessibilityProperties: AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione.
DisplayObject
 Inheritedalpha: Number
Indica il valore della trasparenza alfa dell'oggetto specificato.
DisplayObject
 InheritedblendMode: String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare.
DisplayObject
 InheritedcacheAsBitmap: Boolean
Se è impostata su true, viene memorizzata nella cache una rappresentazione bitmap interna dell'oggetto di visualizzazione.
DisplayObject
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  deblocking: int
Indica il tipo di filtro applicato al decodificatore video nel corso del postprocessing.
Video
 Inheritedfilters: Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione.
DisplayObject
 Inheritedheight: Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel.
DisplayObject
 InheritedloaderInfo: LoaderInfo
[sola lettura] Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene.
DisplayObject
 Inheritedmask: DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato.
DisplayObject
 InheritedmouseX: Number
[sola lettura] Indica la coordinata x della posizione del mouse, in pixel.
DisplayObject
 InheritedmouseY: Number
[sola lettura] Indica la coordinata y della posizione del mouse, in pixel.
DisplayObject
 Inheritedname: String
Indica il nome dell'istanza dell'oggetto DisplayObject.
DisplayObject
 InheritedopaqueBackground: Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo.
DisplayObject
 Inheritedparent: DisplayObjectContainer
[sola lettura] Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione.
DisplayObject
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
 Inheritedroot: DisplayObject
[sola lettura] Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF.
DisplayObject
 Inheritedrotation: Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale.
DisplayObject
 Inheritedscale9Grid: Rectangle
La griglia di modifica in scala attualmente attiva.
DisplayObject
 InheritedscaleX: Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione.
DisplayObject
 InheritedscaleY: Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto.
DisplayObject
 InheritedscrollRect: Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione.
DisplayObject
  smoothing: Boolean
Specifica se il video debba essere attenuato (interpolato) quando viene modificato in scala.
Video
 Inheritedstage: Stage
[sola lettura] Lo stage dell'oggetto di visualizzazione.
DisplayObject
 Inheritedtransform: Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione.
DisplayObject
  videoHeight: int
[sola lettura] Un numero intero che specifica l'altezza del flusso video espressa in pixel.
Video
  videoWidth: int
[sola lettura] Un numero intero che specifica la larghezza del flusso video espressa in pixel.
Video
 Inheritedvisible: Boolean
Determina se l'oggetto di visualizzazione è visibile o meno.
DisplayObject
 Inheritedwidth: Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel.
DisplayObject
 Inheritedx: Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.
DisplayObject
 Inheritedy: Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.
DisplayObject
Metodi pubblici
 MetodoDefinito da
  
Video(width:int = 320, height:int = 240)
Crea una nuova istanza Video.
Video
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.
EventDispatcher
  
Specifica un flusso video proveniente da una videocamera da visualizzare all'interno dei limiti dell'oggetto Video nell'applicazione.
Video
  
Specifica un flusso video da visualizzare all'interno dei limiti dell'oggetto Video nell'applicazione.
Video
  
Cancella l'immagine attualmente visualizzata nell'oggetto Video.
Video
 Inherited
Invia un evento nel flusso di eventi.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace.
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme.
DisplayObject
 Inherited
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point.
DisplayObject
 Inherited
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.
EventDispatcher
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con l'oggetto di visualizzazione obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y.
DisplayObject
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point.
DisplayObject
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Rimuove un listener dall'oggetto EventDispatcher.
EventDispatcher
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
 Inherited
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.
EventDispatcher
Eventi
 Evento Riepilogo Definito da
 Inherited Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo.EventDispatcher
 Inherited Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione.DisplayObject
 Inherited Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.DisplayObject
 Inherited Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.EventDispatcher
 Inherited Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma.DisplayObject
 Inherited Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione.DisplayObject
 Inherited Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.DisplayObject
 Inherited Inviato quando l'elenco di visualizzazione sta per essere aggiornato e sottoposto a rendering.DisplayObject
Descrizione delle proprietà
deblockingproprietà
deblocking:int  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica il tipo di filtro applicato al decodificatore video nel corso del postprocessing. Il valore predefinito è 0, che consente al compressore video di applicare il filtro di deblock necessario.

La compressione video può determinare la comparsa di disturbi indesiderati. È possibile utilizzare la proprietà deblocking per impostare filtri che riducono il blocking e, per i video compressi con il codec On2, il ringing.

Il blocking è la presenza di imperfezioni visibili tra i limiti dei blocchi che compongono i singoli fotogrammi video. Il ringing è la presenza di bordi distorti attorno agli elementi di un'immagine video.

Sono disponibili due filtri di deblock: uno nel codec Sorenson e uno nel codec On2 VP6. È inoltre disponibile un filtro di deringing quando si utilizza il codec On2 VP6. Per impostare un filtro, utilizzare uno dei seguenti valori:

Se quando si utilizza il codec Sorenson viene selezionato un valore maggiore di 2 per il video, il decodificatore Sorenson imposta il valore predefinito 2.

L'uso del filtro di deblock incide sulle prestazioni complessive della riproduzione e di solito non è necessario per i video riprodotti con un'ampiezza di banda elevata. Se il sistema non è sufficientemente potente, l'attivazione di questo filtro può comportare delle difficoltà di riproduzione.


Implementazione
    public function get deblocking():int
    public function set deblocking(value:int):void
smoothingproprietà 
smoothing:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Specifica se il video debba essere attenuato (interpolato) quando viene modificato in scala. Affinché l'attenuazione funzioni, il player deve essere impostato sulla modalità di riproduzione di alta qualità. Il valore predefinito è false (nessuna attenuazione).

Per la riproduzione video con Flash Player Aggiornamento 3 e versioni successive, impostare questa proprietà su true per sfruttare l'ottimizzazione delle immagini mediante mipmapping.


Implementazione
    public function get smoothing():Boolean
    public function set smoothing(value:Boolean):void
videoHeightproprietà 
videoHeight:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero intero che specifica l'altezza del flusso video espressa in pixel. Per lo streaming dal vivo, questo valore è lo stesso della proprietà Camera.height dell'oggetto Camera che sta catturando lo streaming video. Per i file FLV, questo valore corrisponde all'altezza del file esportato in formato FLV.

È possibile utilizzare questa proprietà, ad esempio, per fare in modo che l'utente visualizzi il video con le stesse dimensioni con cui è stato catturato, a prescindere dalle dimensioni effettive dell'oggetto Video sullo stage.


Implementazione
    public function get videoHeight():int

Vedere anche

videoWidthproprietà 
videoWidth:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero intero che specifica la larghezza del flusso video espressa in pixel. Per i flussi dal vivo, questo valore è uguale a quello della proprietà Camera.width dell'oggetto Camera che sta catturando il flusso video. Per i file FLV, questo valore corrisponde alla larghezza del file esportato in formato FLV.

È possibile utilizzare questa proprietà, ad esempio, per fare in modo che l'utente visualizzi il video con le stesse dimensioni con cui è stato catturato, a prescindere dalle dimensioni effettive dell'oggetto Video sullo stage.


Implementazione
    public function get videoWidth():int

Vedere anche

Descrizione della funzione di costruzione
Video()Funzione di costruzione
public function Video(width:int = 320, height:int = 240)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una nuova istanza Video. Se non vengono forniti valori per i parametri width e height, vengono utilizzati i valori predefiniti. Le proprietà altezza e larghezza dell'oggetto Video si possono impostare anche dopo la costruzione iniziale mediante Video.width e Video.height. Quando viene creato un nuovo oggetto Video non è consentito specificare un valore zero per l'altezza o la larghezza; se viene passato il valore zero vengono applicati i valori predefiniti.

Dopo che è stato creato l'oggetto Video, chiamare il metodo DisplayObjectContainer.addChild() o DisplayObjectContainer.addChildAt() per aggiungerlo a un oggetto principale DisplayObjectContainer.

Parametri
width:int (default = 320) — La larghezza del video espressa in pixel.
 
height:int (default = 240) — L'altezza del video espressa in pixel.
Descrizione dei metodi
attachCamera()metodo
public function attachCamera(camera:Camera):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Specifica un flusso video proveniente da una videocamera da visualizzare all'interno dei limiti dell'oggetto Video nell'applicazione.

Utilizzare questo metodo per allegare il video dal vivo dal computer di un utente a un oggetto Video. È possibile riprodurre il video dal vivo in locale sullo stesso computer su cui viene acquisito o inviarlo a Flash Media Server e utilizzare il server per inviarlo in streaming ad altri utenti.

Parametri

camera:Camera — Un oggetto Camera che cattura dati video. Per interrompere la connessione all'oggetto Video, passare il valore null.

Vedere anche


Esempio
Come utilizzare gli esempi
Per ulteriori informazioni sull'uso di questo metodo, fare riferimento all'esempio sul metodo Camera.getCamera().
attachNetStream()metodo 
public function attachNetStream(netStream:NetStream):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Specifica un flusso video da visualizzare all'interno dei limiti dell'oggetto Video nell'applicazione. Lo streaming video è un file FLV riprodotto con NetStream.play(), un oggetto Camera o null. Se si utilizza un file FLV, è possibile salvarlo sul file system locale o su Flash Media Server. Se il valore dell'argomento netStream è null, il video non viene più riprodotto nell'oggetto Video.

Non è necessario utilizzare questo metodo se il file FLV contiene solo audio; la porzione audio dei file FLV viene riprodotta automaticamente quando viene chiamato NetStream.play(). Per controllare l'audio associato a un file FLV, utilizzare la proprietà soundTransform dell'oggetto NetStream che riproduce il file FLV.

Parametri

netStream:NetStream — Un oggetto NetStream. Per interrompere la connessione all'oggetto Video, passare il valore null.

Vedere anche


Esempio
Come utilizzare gli esempi
vedere l'esempio alla fine di questa classe per una descrizione della modalità di utilizzo del metodo.
clear()metodo 
public function clear():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Cancella l'immagine attualmente visualizzata nell'oggetto Video. Questa funzione è utile quando si desidera visualizzare le informazioni di standby senza nascondere l'oggetto Video.

Vedere anche

Esempi Come utilizzare gli esempi
VideoExample.as

Nell'esempio seguente viene utilizzato un oggetto Video con le classi NetConnection e NetStream per caricare ed eseguire un file FLV. Per provare questo esempio, è necessario un file FLV con un nome e una posizione corrispondenti alla variabile passata a videoURL; in questo caso, si tratta di un file FLV denominato Video.flv che si trova nella stessa directory del file SWF.

In questo esempio, il codice che crea gli oggetti Video e NetStream e chiama i metodi Video.attachNetStream() e NetStream.play() viene collocato in una funzione gestore. Il gestore viene chiamato solo se il tentativo di connessione all'oggetto NetConnection ha esito positivo; cioè quando l'evento netStatus restituisce un oggetto info con una proprietà code che indica l'esito positivo. È consigliabile attendere la riuscita della connessione prima di effettuare la chiamata 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.
        }
    }
 }




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/media/Video.html