La quantità di movimento rilevata dalla videocamera. I valori accettabili sono compresi tra 0 (non viene rilevato alcun movimento) e 100 (viene rilevata una grande quantità di movimento). Il valore di questa proprietà può essere utile per determinare se è necessario passare un'impostazione al metodo setMotionLevel().

Se la videocamera è disponibile ma non viene ancora utilizzata perché non è stata effettuata una chiamata al metodo Video.attachCamera(), questa proprietà viene impostata su -1.

Se si effettua lo streaming solo di video locale non compresso, questa proprietà viene impostata solo se è stata assegnata una funzione al gestore di eventi. In caso contrario, è undefined.

Vedere anche

La quantità massima di ampiezza di banda utilizzabile dalla sorgente video in uscita corrente, espressa in byte. Il valore 0 indica che la sorgente può utilizzare tutta l'ampiezza di banda necessaria per mantenere la qualità desiderata.

Per impostare questa proprietà, utilizzare il metodo setQuality().

Vedere anche

La velocità con cui la videocamera sta catturando i dati, espressa in fotogrammi al secondo. Questa proprietà non può essere impostata; tuttavia è possibile utilizzare il metodo setMode() per impostare una proprietà correlata — fps — che specifica la frequenza massima dei fotogrammi con cui si desidera che la videocamera catturi i dati.

Vedere anche

La velocità massima con cui la videocamera cattura i dati, espressa in fotogrammi al secondo. La velocità massima possibile dipende dalle capacità della videocamera; questa frequenza dei fotogrammi non può essere raggiunta.

• Per impostare un valore per questa proprietà, utilizzare il metodo setMode().
• Per determinare la velocità corrente con cui la videocamera cattura i dati, utilizzare la proprietà currentFPS.

Vedere anche

L'altezza della cattura corrente, espressa in pixel. Per impostare un valore per questa proprietà, utilizzare il metodo setMode().

Vedere anche

Un numero intero a base zero che specifica l'indice della videocamera, presente anche nell'array restituito dalla proprietà names.

Vedere anche

Il numero di fotogrammi video trasmessi per intero (i fotogrammi chiave) anziché essere interpolati dall'algoritmo di compressione video. Il valore predefinito è 15, che indica che un fotogramma su 15 è un fotogramma chiave. Un valore di 1 significa che ogni fotogramma è un fotogramma chiave. I valori consentiti sono 1-48.

Vedere anche

Indica se una visualizzazione locale delle immagini catturate dalla videocamera viene compressa e decompressa (true), come accadrebbe per la trasmissione dal vivo mediante Flash Media Server, o se la compressione non viene effettuata (false). Il valore predefinito è false.

Sebbene uno streaming compresso sia utile come prova, ad esempio durante l'anteprima delle impostazioni di qualità del video, ha dei costi di elaborazione significativi. La visualizzazione locale è compressa, modificata la trasmissione come se si trattasse di un collegamento dal vivo e quindi decompressa per la visualizzazione in locale.

Per impostare questo valore, utilizzare Camera.setLoopback(). Per impostare l'entità della compressione utilizzata quando questa proprietà è impostata su true, utilizzare Camera.setQuality().

Vedere anche

La quantità di movimento necessaria per richiamare l'evento activity. I valori accettabili sono compresi tra 0 e 100. Il valore predefinito è 50.

È possibile visualizzare il video a prescindere dal valore della proprietà motionLevel. Per ulteriori informazioni, vedere setMotionLevel().

Vedere anche

Il numero di millisecondi che trascorrono tra il momento in cui la videocamera interrompe il rilevamento del movimento e quello in cui viene richiamato l'evento activity. Il valore predefinito è 2000 (2 secondi).

Per impostare questo valore, utilizzare setMotionLevel().

Vedere anche

Un valore booleano che indica se l'utente ha negato (true) o consentito (false) l'accesso alla videocamera nella finestra di dialogo Riservatezza di Flash Player. Quando questo valore cambia viene inviato l'evento status.

Vedere anche

Il nome della videocamera corrente, restituito dall'hardaware della videocamera.

Vedere anche

Un array di stringhe che indicano i nomi di tutte le videocamere disponibili senza visualizzare la finestra di dialogo Riservatezza di Flash Player. Questo array ha lo stesso comportamento di qualunque altro array ActionScript e fornisce in modo implicito l'indice a base zero di ogni videocamera e il numero di videocamere presenti nel sistema (per mezzo di names.length). Per ulteriori informazioni, vedere la voce relativa alla classe Array names.

Quando si chiama la proprietà names, viene eseguito un esame esteso dell'hardware e la creazione dell'array può richiedere diversi secondi. Nella maggior parte dei casi è possibile utilizzare semplicemente la videocamera predefinita.

Vedere anche

Il livello di qualità immagine richiesto, determinato dall'entità della compressione applicata a ciascun fotogramma video. I valori accettabili per la qualità sono compresi tra 1 (qualità minima, compressione massima) e 100 (qualità massima, nessuna compressione). Il valore predefinito è 0 e indica che, se necessario, la qualità dell'immagine può variare per evitare di superare l'ampiezza di banda disponibile.

Per impostare questa proprietà, utilizzare il metodo setQuality().

Vedere anche

La larghezza della cattura corrente, espressa in pixel. Per impostare un valore per questa proprietà, utilizzare il metodo setMode().

Vedere anche

Restituisce un riferimento a un oggetto Camera per la cattura del video. Per iniziare l'acquisizione del video, associare l'oggetto Camera a un oggetto Video (vedere Video.attachCamera() ). Per trasmettere il video a Flash Media Server, chiamareNetStream.attachCamera() per associare l'oggetto Camera a un oggetto NetStream.

Più chiamate al metodo getCamera() fanno riferimento allo stesso driver della videocamera. Pertanto, se il codice contiene firstCam:Camera = getCamera() e secondCam:Camera = getCamera(), sia firstCam che secondCam fanno riferimento alla stessa videocamera (predefinita).

In generale, non è necessario passare un valore per il parametro name; è sufficiente utilizzare getCamera() per restituire un riferimento alla videocamera predefinita. Mediante il pannello delle impostazioni Videocamera (descritto più avanti in questa sezione), l'utente può specificare la videocamera predefinita utilizzata da Flash Player.

Quando un file SWF tenta di accedere al dispositivo restituito da getCamera(), viene visualizzata una finestra di dialogo che consente all'utente di scegliere se consentire o negare l'accesso alla videocamera. (Assicurarsi che le dimensioni della finestra dell'applicazione siano almeno di 215 x 138 pixel, ovvero le dimensioni minime richieste da Flash Player per visualizzare la finestra di dialogo.) Quando l'utente risponde a questa finestra di dialogo, Flash Player restituisce un oggetto informazioni nell'evento status che indica la risposta: Camera.muted indica che l'utente ha negato l'accesso a una videocamera; Camera.unmuted indica che l'accesso è stato accordato. Per determinare se l'utente ha negato o consentito l'accesso alla videocamera senza gestire l'evento status, utilizzare la proprietà muted.

L'utente può anche specificare delle impostazioni di riservatezza permanenti per un determinato dominio facendo clic con il pulsante destro del mouse (Windows) o facendo clic tenendo premuto il tasto Ctrl (Macintosh) mentre viene riprodotto un file SWF, selezionando Impostazioni, aprendo la finestra di dialogo relativa alla riservatezza e selezionando Ricorda.

Non è possibile utilizzare ActionScript per impostare il valore di Consenti o Nega per un utente, ma è possibile visualizzare la finestra di dialogo Riservatezza per l'utente specifico mediante Security.showSettings(SecurityPanel.PRIVACY). Se si seleziona Ricorda, all'utente non viene più chiesto se consentire o negare l'accesso alla videocamera dai file SWF del dominio in uso.

Se getCamera() restituisce il valore null significa che la videocamera è attualmente utilizzata da un'altra applicazione o che nel sistema non è installata alcuna videocamera. Per determinare se è installata una videocamera, utilizzare la proprietà names.length. Per visualizzare il pannello delle impostazioni Videocamera di Flash Player che consente all'utente di scegliere la videocamera a cui fa riferimento getCamera(), utilizzare System.showSettings(SecurityPanel.CAMERA).

Il rilevamento delle videocamere nell'hardware è un'operazione che richiede tempo. Quando viene rilevata almeno una videocamera, non viene eseguita un'altra ricerca dell'hardware finché l'istanza del player è in esecuzione. Se invece non vengono rilevate videocamere, la ricerca viene eseguita ogni volta che viene effettuata la chiamata a getCamera. Questa è una funzione utile se l'utente ha dimenticato di collegare la videocamera; se il file SWF è dotato di un pulsante di tipo Riprova che chiama getCamera, è possibile rilevare la videocamera senza che sia necessario chiudere e riaprire il file SWF.

Parametri

Vedere anche

Specifica quali fotogrammi video vengono trasmessi per intero (i fotogrammi chiave) anziché essere interpolati dall'algoritmo di compressione video. Questo metodo si applica solo quando si trasmette il video mediante Flash Media Server.

L'algoritmo di compressione di Flash Video comprime i video trasmettendo solo i dati modificati rispetto all'ultimo fotogramma; queste porzioni sono considerate fotogrammi interpolati. I fotogrammi di un video possono essere interpolati a seconda del contenuto del fotogramma precedente. Un fotogramma chiave è invece un fotogramma video completo che non viene interpolato in funzione dei fotogrammi precedenti.

Per determinare come impostare un valore per il parametro keyFrameInterval, tenere presente sia l'uso dell'ampiezza di banda, sia l'accessibilità della riproduzione video. Ad esempio, se si specifica un valore più alto per keyFrameInterval (invio meno frequente di fotogrammi chiave) l'uso dell'ampiezza di banda si riduce. Questo può tuttavia aumentare il tempo necessario per posizionare l'indicatore di riproduzione in un determinato punto del video; è possibile quindi che sia necessario interpolare un maggior numero di fotogrammi video precedenti prima che possa riprendere la riproduzione.

Al contrario, l'indicazione di un valore più basso per keyFrameInterval (invio più frequente di fotogrammi chiave) aumenta l'uso dell'ampiezza di banda perché vengono trasmessi più spesso fotogrammi video completi, ma può diminuire il tempo necessario per cercare un determinato fotogramma all'interno di un video registrato.

Parametri

Vedere anche

Specifica se deve essere utilizzato uno streaming video compresso per una visualizzazione locale della videocamera. Di solito questo metodo si applica solo quando si trasmette il video mediante Flash Media Server; se compress viene impostato su true è possibile vedere con maggiore precisione come si presenta il video quando viene visualizzato in tempo reale.

Benché sia utile a fini di verifica, ad esempio per visualizzare in anteprima le impostazioni di qualità del video, la compressione dello streaming video è notevolmente dispendiosa in termini di elaborazione perché la visualizzazione locale non viene semplicemente compressa, ma anche montata per la trasmissione come accadrebbe con una connessione dal vivo e quindi decompressa per la visualizzazione locale.

Per impostare l'entità della compressione da utilizzare quando si imposta compress su true, utilizzare Camera.setQuality().

Parametri

Vedere anche

Imposta la videocamera sulla modalità di cattura che soddisfa al meglio i requisiti specificati. Se la videocamera non è dotata di una modalità nativa che soddisfa tutti i parametri passati, viene selezionata una modalità di cattura che sintetizza nel modo più simile possibile la modalità richiesta. Talvolta questa manipolazione comporta il ritaglio dell'immagine e l'eliminazione di alcuni fotogrammi.

Per impostazione predefinita, vengono eliminati dei fotogrammi, se necessario, per mantenere le dimensioni dell'immagine. Per ridurre al minimo il numero di fotogrammi eliminati, e di conseguenza ridurre le dimensioni dell'immagine, passare false per il parametro favorArea.

Quando si seleziona una modalità nativa, Flash Player tenta se possibile di mantenere il rapporto proporzionale richiesto. Ad esempio, se si esegue il comando myCam.setMode(400, 400, 30) e i valori per la larghezza e l'altezza massime della videocamera sono 320 e 288, sia la larghezza che l'altezza vengono impostate su 288; con l'impostazione di queste proprietà sullo stesso valore viene rispettato il rapporto proporzionale richiesto di 1:1.

Per determinare i valori assegnati a queste proprietà dopo che è stata selezionata la modalità più simile ai valori richiesti, utilizzare le proprietà width, height e fps.

Se si utilizza Flash Media Server, è anche possibile acquisire singoli fotogrammi o creare riprese "time-lapse". Per ulteriori informazioni, vedere NetStream.attachCamera().

Parametri

Vedere anche

Specifica la quantità di movimento necessaria per inviare l'evento activity. Imposta facoltativamente il numero di millisecondi che devono trascorrere senza alcuna attività prima che il movimento venga considerato terminato e venga inviato l'evento.

Nota: è possibile visualizzare il video a prescindere dal valore del parametro motionLevel, che determina solo quando e in quali circostanze viene inviato l'evento e non se si sta catturando o visualizzando il video.

Per impedire che la videocamera rilevi qualunque movimento, passare il valore 100 per il parametro motionLevel; in questo modo l'evento activity non viene mai inviato. (Questo valore si utilizza solitamente nelle prove; ad esempio per disabilitare temporaneamente gli eventuali gestori che sarebbero normalmente attivati quando viene inviato l'evento).

Per determinare la quantità di movimento attualmente rilevata dalla videocamera, utilizzare la proprietà activityLevel. I valori della sensibilità al movimento corrispondono direttamente ai valori dell'attività. L'assenza totale di movimento equivale al valore di attività 0. Il moto costante equivale al valore 100. In assenza di movimento, il valore dell'attività è inferiore a quello della sensibilità al movimento; in presenza di movimento, i valori dell'attività superano spesso quelli della sensibilità al movimento.

Questo metodo ha uno scopo simile a quello del metodo Microphone.setSilenceLevel(); entrambi vengono utilizzati per specificare quando deve essere inviato l'evento activity. Tuttavia, questi metodi hanno un impatto decisamente diverso sulla pubblicazione dello streaming:

• Microphone.setSilenceLevel() è studiato per ottimizzare l'ampiezza di banda. Quando uno streaming audio è considerato silenzioso, non viene inviato alcun dato audio. Viene invece inviato un unico messaggio per segnalare che il silenzio è cominciato.
• Camera.setMotionLevel() è studiato per rilevare il movimento e non influisce sull'uso dell'ampiezza di banda. Anche se uno streaming video non rileva alcun movimento, viene comunque inviato il video.

Parametri

Vedere anche

Imposta la quantità massima di ampiezza di banda al secondo o la qualità di immagine richiesta dell'attuale sorgente video in uscita. Di solito questo metodo si applica solo quando si trasmette il video mediante Flash Media Server.

Utilizzare questo metodo per specificare quale elemento della sorgente video in uscita è più importante per l'applicazione tra l'uso dell'ampiezza di banda o la qualità dell'immagine.

• Per indicare che l'ampiezza di banda ha la precedenza, passare un valore per bandwidth e 0 per quality. Il video viene trasmesso con la migliore qualità di immagine possibile per l'ampiezza di banda specificata. Se necessario, la qualità dell'immagine può essere ridotta per evitare di superare l'ampiezza di banda specificata. In generale, con l'aumentare del movimento diminuisce la qualità.
• Per indicare che la qualità ha la precedenza, passare 0 per bandwidth e un valore numerico per quality. Viene utilizzata l'ampiezza di banda necessaria per mantenere la qualità specificata. Se necessario, la frequenza dei fotogrammi viene ridotta per mantenere la qualità dell'immagine. In generale, con l'aumentare del movimento aumenta anche l'uso dell'ampiezza di banda.
• Per specificare che l'ampiezza di banda e la qualità hanno la stessa importanza, passare dei valori numerici per entrambi i parametri. Il video viene trasmesso in modo da raggiungere la qualità specificata e non superare l'ampiezza di banda indicata. Se necessario, la frequenza dei fotogrammi viene ridotta per mantenere la qualità dell'immagine senza superare l'ampiezza di banda specificata.

Parametri

Vedere anche

Inviato quando una videocamera inizia o termina una sessione. Chiamare Camera.setMotionLevel() per specificare la quantità di movimento necessaria per attivare un evento activity con un valore activating di true o il tempo senza attività che deve trascorrere prima dell'attivazione di un evento activity con un valore activating di false.

Questo evento ha le seguenti proprietà:

Inviato quando una videocamera segnala il proprio stato. Se il valore della proprietà code è "Camera.muted" viene impedito al file SWF di accedere alla videocamera dell'utente. Se il valore della proprietà code è "Camera.unmuted" viene consentito al file SWF di accedere alla videocamera dell'utente.

Questo evento ha le seguenti proprietà:

Vedere anche

Nota: per il corretto funzionamento di questo esempio, deve essere collegata una videocamera al computer.

package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.*;
    import flash.media.Camera;
    import flash.media.Video;

    public class CameraExample extends Sprite {
        private var video:Video;
        
        public function CameraExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var camera:Camera = Camera.getCamera();
            
            if (camera != null) {
                camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                video = new Video(camera.width * 2, camera.height * 2);
                video.attachCamera(camera);
                addChild(video);
            } else {
                trace("You need a camera.");
            }
        }
        
        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }
    }
}