Pacchetto | flash.media |
Classe | public class Video |
Ereditarietà | Video DisplayObject EventDispatcher Object |
Sottoclassi | VideoPlayer |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se utilizzato con Flash Media Server, l'oggetto Video consente di inviare video dal vivo acquisito da un utente al server e di trasmetterlo dal server ad altri utenti. Utilizzando queste funzioni, potete 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 e versioni successive 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. Per maggiori informazioni sulla riproduzione video e sui formati supportati, vedete la classe flash.net.NetStream.
Flash Player 9.0.115.0 e versioni successive supporta il mipmapping per ottimizzare la qualità e le prestazioni del rendering in runtime. Per la riproduzione video, Flash Player utilizza l'ottimizzazione del mipmapping se la proprietà smoothing
dell'oggetto Video è impostata su true
.
A partire da AIR 25, è stato introdotto un nuovo tag per Android in app.xml denominato disableMediaCodec
. Impostando questo tag come true
mediacodec viene disattivato e il video viene decodificato tramite OpenMax AL. In caso contrario, mediacodec è attivato. Il valore di questo tag è false
per impostazione predefinita.
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, utilizzate attachCamera()
o attachNetStream()
per allegare il video all'oggetto Video. Aggiungete quindi l'oggetto Video all'elenco di visualizzazione utilizzando addChild()
.
Se utilizzate Flash Professional, potete anche posizionare l'oggetto Video sullo stage anziché aggiungerlo con addChild()
, come segue:
- Se il pannello Libreria non è visibile, selezionate Finestra > Libreria per visualizzarlo.
- Aggiungete alla libreria un oggetto Video incorporato facendo clic sul menu Opzioni presente sul lato destro della barra del titolo del pannello Libreria e selezionate Nuovo video.
- Nella finestra di dialogo delle proprietà video, assegnate un nome all'oggetto Video inserito per utilizzarlo nella libreria e fate clic su OK.
- Trascinate l'oggetto Video sullo stage e utilizzate la finestra di ispezione Proprietà per assegnargli un nome di istanza univoco, ad esempio
my_video
(non utilizzate il nome Video).
Nelle applicazioni AIR su desktop, la riproduzione di un video in modalità a schermo intero disattiva le impostazioni relative al risparmio energetico e al salvaschermo (se il sistema operativo lo consente).
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.
Altre informazioni
Elementi fondamentali della programmazione degli elementi visivi
Classi di visualizzazione di base
Utilizzo del mipmapping
Elementi fondamentali del video
Nozioni fondamentali sui formati video
Compatibilità Flash Player e AIR con i file video codificati
Nozioni fondamentali sui formati di file video F4V e FLV Adobe
Nozioni fondamentali sulla classe Video
Argomenti avanzati per i file video
Esempio video: Video Jukebox
Operazioni con i file video
Elementi API correlati
attachNetStream()
flash.media.Camera.getCamera()
flash.net.NetConnection
flash.net.NetStream
flash.display.DisplayObjectContainer.addChild()
flash.display.Stage.addChild()
Proprietà | Definito da | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | DisplayObject | ||
alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | DisplayObject | ||
blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | DisplayObject | ||
blendShader : Shader [sola scrittura]
Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo. | DisplayObject | ||
cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true. | DisplayObject | ||
constructor : 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 | ||
filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | DisplayObject | ||
height : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | ||
loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | DisplayObject | ||
mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | DisplayObject | ||
metaData : Object
Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4. | DisplayObject | ||
mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | ||
mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | ||
name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | DisplayObject | ||
opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | DisplayObject | ||
parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | DisplayObject | ||
root : 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 | ||
rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | DisplayObject | ||
rotationX : Number
Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rotationY : Number
Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rotationZ : Number
Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | DisplayObject | ||
scaleX : Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. | DisplayObject | ||
scaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scrollRect : 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 | ||
stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | DisplayObject | ||
transform : flash.geom: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 | ||
visible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno. | DisplayObject | ||
width : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | ||
x : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | ||
y : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | ||
z : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D. | DisplayObject |
Metodo | Definito da | ||
---|---|---|---|
Crea una nuova istanza Video. | Video | ||
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 (non nel flusso video). | Video | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | DisplayObject | ||
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 | ||
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | DisplayObject | ||
Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale. | DisplayObject | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj. | DisplayObject | ||
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | DisplayObject | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali). | DisplayObject | ||
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | DisplayObject | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
deblocking | proprietà |
deblocking:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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, utilizzate uno dei seguenti valori:
- 0 - Consente al compressore video di applicare il filtro di deblock necessario.
- 1 - Non utilizza un filtro di deblock.
- 2 - Utilizza il filtro di deblock Sorenson.
- 3 - Solo per i video On2, utilizza il filtro di deblock On2 ma non un filtro di deringing.
- 4 - Solo per i video On2, utilizza il filtro di deblock e di deringing On2.
- 5 - Solo per i video On2, utilizza il filtro di deblock On2 e un filtro di deringing On2 con prestazioni più elevate.
Se quando utilizzate il codec Sorenson selezionate 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
smoothing | proprietà |
smoothing:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica se il video debba essere attenuato (interpolato) quando viene modificato in scala. Affinché l'attenuazione funzioni, il runtime deve essere impostato sulla modalità di riproduzione di alta qualità (l'impostazione predefinita). Il valore predefinito è false
(nessuna attenuazione).
Per la riproduzione video con Flash Player 9.0.115.0 e versioni successive, impostate questa proprietà su true
per sfruttare l'ottimizzazione delle immagini in mipmapping.
Implementazione
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void
Altre informazioni
videoHeight | proprietà |
videoHeight:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 video registrati, questo valore corrisponde all’altezza del video. L'evento NetStream.Video.DimensionChange viene inviato per i video registrati quando questo valore cambia.
Potete 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
Elementi API correlati
videoWidth | proprietà |
videoWidth:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 video registrati, questo valore corrisponde alla larghezza del video. L'evento NetStream.Video.DimensionChange viene inviato per i video registrati quando questo valore cambia.
Potete 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
Elementi API correlati
Video | () | Funzione di costruzione |
public function Video(width:int = 320, height:int = 240)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Crea una nuova istanza Video. Se non vengono forniti valori per i parametri width
e height
, vengono utilizzati i valori predefiniti. Potete impostare le proprietà width (larghezza) e height (altezza) dell'oggetto Video 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.
width:int (default = 320 ) — La larghezza del video espressa in pixel.
| |
height:int (default = 240 ) — L'altezza del video espressa in pixel.
|
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
public function attachCamera(camera:Camera):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Specifica un flusso video proveniente da una videocamera da visualizzare all'interno dei limiti dell'oggetto Video nell'applicazione.
Utilizzate questo metodo per collegare video dal vivo acquisito dall'utente all'oggetto Video. Potete riprodurre il video dal vivo in locale sullo stesso computer o dispositivo su cui viene acquisito o inviarlo a Flash Media Server e utilizzare il server per inviarlo in streaming ad altri utenti.
Nota: in un'applicazione iOS AIR, le immagini video della fotocamera non vengono visualizzate se l'applicazione usa la modalità di rendering tramite GPU.
Parametri
camera:Camera — Un oggetto Camera che cattura dati video. Per interrompere la connessione all'oggetto Video, passate il valore null .
|
Elementi API correlati
Esempio
Come utilizzare questo esempio
Per ulteriori informazioni sull'uso di questo metodo, fate riferimento all'esempio sul metodo Camera.getCamera().
attachNetStream | () | metodo |
public function attachNetStream(netStream:NetStream):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica un flusso video da visualizzare all'interno dei limiti dell'oggetto Video nell'applicazione. Il flusso video è un file video riprodotto con NetStream.play()
, un oggetto Camera o null
. Se utilizzate un file video, potete salvarlo nel file system locale o in 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 un file video contiene solo audio; la porzione audio dei file video viene riprodotta automaticamente quando chiamate NetStream.play()
. Per controllare l'audio associato a un file video, utilizzate la proprietà soundTransform
dell'oggetto NetStream che riproduce il file video.
Parametri
netStream:NetStream — Un oggetto NetStream. Per interrompere la connessione all'oggetto Video, passate il valore null .
|
Elementi API correlati
clear | () | metodo |
public function clear():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cancella l'immagine attualmente visualizzata nell'oggetto Video (non nel flusso video). Questo metodo è utile per la gestione dell'immagine corrente. Potete, ad esempio, cancellare l'ultima immagine o visualizzare le informazioni di standby senza nascondere l'oggetto Video.
Elementi API correlati
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 { 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:44 PM Z