Pacchetto | flash.net |
Classe | public dynamic class NetStreamPlayOptions |
Ereditarietà | NetStreamPlayOptions EventDispatcher Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
NetStream.play2()
. Passate un oggetto NetStreamPlayOptions a play2()
e le diverse opzioni vengono specificate dalle proprietà della classe. L'uso principale di questa classe è l'implementazione delle transizioni dinamiche tra flussi, sia per passare a flussi con diverse velocità di trasferimento e dimensioni che per passare a contenuto diverso in un elenco di riproduzione.
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
len : Number
La durata di riproduzione, in secondi, per il flusso specificato in streamName. | NetStreamPlayOptions | ||
offset : Number
Il tempo di streaming assoluto in corrispondenza del quale il server commuta tra i diversi flussi di bitrate (velocità di trasferimento) per lo streaming dinamico su Flash Media Server. | NetStreamPlayOptions | ||
oldStreamName : String
Il nome del flusso precedente o del flusso da cui effettuare la transizione. | NetStreamPlayOptions | ||
start : Number
Il momento dell'avvio, espresso in secondi, per streamName. | NetStreamPlayOptions | ||
streamName : String
Il nome del nuovo flusso a cui passare o da riprodurre. | NetStreamPlayOptions | ||
transition : String
La modalità con cui viene effettuata la riproduzione di o la transizione a streamName. | NetStreamPlayOptions |
Metodo | Definito da | ||
---|---|---|---|
Crea un oggetto NetStreamPlayOptions per specificare le opzioni che vengono passate al metodo NetStream.play2(). | NetStreamPlayOptions | ||
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 | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
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 | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
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 |
len | proprietà |
public var len:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
La durata di riproduzione, in secondi, per il flusso specificato in streamName
. Il valore predefinito è -1; ciò significa che Flash Player riproduce un flusso dal vivo finché non è più disponibile o un flusso registrato fino alla fine. Se passate 0 per len
, Flash Player riproduce il singolo fotogramma che si trova a start
secondi dall'inizio di un flusso registrato (supponendo che start
sia uguale a o maggiore di 0).
Se passate un numero positivo per len
, Flash Player riproduce un flusso dal vivo per len
secondi dal momento in cui è diventato disponibile oppure riproduce un flusso registrato per len
secondi. (Se un flusso termina prima di len
secondi, la riproduzione termina al termine del flusso).
Se passate un numero negativo diverso da -1 per len
, il valore viene interpretato come -1.
Elementi API correlati
offset | proprietà |
public var offset:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Il tempo di streaming assoluto in corrispondenza del quale il server commuta tra i diversi flussi di bitrate (velocità di trasferimento) per lo streaming dinamico su Flash Media Server. La proprietà offset
viene utilizzata quando effettuate una chiamata a NetStream.play2()
con la modalità di transizione NetStreamPlayTransitions.SWITCH
. Sono disponibili due modalità di commutazione: rapida e standard. Il valore predefinito di offset
è -1
, che corrisponde alla modalità di commutazione rapida. Scrivete istruzioni logiche ActionScript per decidere quando usare la commutazione rapida e quando quella standard.
Commutazione rapida
Nella modalità di commutazione rapida, Flash Media Server commuta sul nuovo flusso senza attendere che vengano riprodotti i dati nel buffer. Tutti i dati bufferizzati del vecchio flusso dopo la posizione offset
vengono scaricati. La commutazione rapida è più veloce di quella standard perché non è necessario riprodurre i dati bufferizzati del flusso precedente.
Il valore predefinito di offset
è -1, che corrisponde alla modalità di commutazione rapida. Quando offset
è -1, la commutazione avviene in corrispondenza del primo fotogramma chiave disponibile dopo netstream.time + 3
, ovvero circa 3 secondi dopo il punto di riproduzione. Potete anche impostare la proprietà offset
su qualsiasi valore maggiore di netstream.time
. Ad esempio, per commutare rapidamente 5 secondi dopo il punto di riproduzione, impostate offset
su netstream.time + 5
. Se il valore di offset
è minore di netstream.time
, viene inviato un evento di stato NetStream.Play.Failed
.
Nota: la proprietà offset
è un valore temporale di streaming assoluto, non un valore sfalsato (offset) rispetto al punto di riproduzione. Ad esempio, per commutare 5 secondi dopo il punto di riproduzione, impostate la proprietà offset
su netstream.time + 5
, non su 5
.
Commutazione standard
Per utilizzare la commutazione standard anziché quella rapida, impostate offset
su un valore maggiore di netstream.time + netstream.bufferLength
.
Utilizzate la commutazione standard quando il client ha una velocità bit elevata nel buffer e vuole passare a un'ampiezza di banda inferiore a causa di un calo dell'ampiezza di banda (e non a causa di problemi della CPU o di una perdita di fotogrammi). Il client potrebbe voler riprodurre i dati alla velocità bit più alta il più a lungo possibile e passare quindi alla velocità bit inferiore alla fine del buffer (come nella commutazione standard).
Per ulteriori informazioni, vedete "Fast switching between streams" (Commutazione rapida tra flussi diversi) nel manuale Adobe Flash Media Server Developer's Guide.
Elementi API correlati
oldStreamName | proprietà |
public var oldStreamName:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Il nome del flusso precedente o del flusso da cui effettuare la transizione. Quando utilizzate NetStream.play2()
per riprodurre semplicemente un flusso (non per eseguire una transizione), il valore di questa proprietà dovrebbe essere null o non definito. Diversamente, specificate il flusso da cui eseguire la transizione.
Elementi API correlati
start | proprietà |
public var start:Number
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Il momento dell'avvio, espresso in secondi, per streamName
. I valori validi sono -2, -1 e 0.
Il valore predefinito per start
è -2; ciò significa che Flash Player tenterà prima di tutto di eseguire il flusso dal vivo specificato in streamName
. Se non viene trovato un flusso dal vivo con il nome specificato, viene riprodotto automaticamente il flusso registrato specificato in streamName
. Se non viene trovato un flusso dal vivo né uno registrato, viene aperto automaticamente un flusso dal vivo con nome streamName
, anche se non è la destinazione di una pubblicazione. Quando un utente inizia la pubblicazione in tale flusso, ne viene avviata automaticamente la riproduzione.
Se passate -1 per start
, Flash Player riproduce solo il flusso dal vivo specificato in streamName
. Se non viene trovato un flusso dal vivo, Flash Player attende indefinitamente se len
è impostato su -1; se len
è impostato su un valore diverso, Flash Player attende per len
secondi prima di iniziare la riproduzione nell'elemento successivo nell'elenco di riproduzione.
Se passate 0 o un numero positivo per start
, Flash Player riproduce solo un flusso registrato di nome streamName
, iniziando start
secondi dall'inizio del flusso. Se non viene trovato un flusso registrato, Flash Player inizia immediatamente a riprodurre l'elemento successivo nell'elenco di riproduzione.
Se passate un numero negativo diverso da -1 o -2 per start
, il valore viene interpretato come -2.
Elementi API correlati
streamName | proprietà |
public var streamName:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Il nome del nuovo flusso a cui passare o da riprodurre. Quando oldStreamName
è null o undefined, la chiamata a NetStream.play2()
avvia semplicemente la riproduzione di streamName
. Se oldStreamName
è specificato, la chiamata a NetStream.play2()
esegue la transizione di oldStreamName
a streamName
utilizzando la modalità di transizione specificata nella proprietà transition
.
Elementi API correlati
transition | proprietà |
public var transition:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
La modalità con cui viene effettuata la riproduzione di o la transizione a streamName
. I possibili valori sono costanti della classe NetStreamPlayTransitions. A seconda che Netstream.play2()
venga chiamata per la riproduzione o la transizione di un flusso, i comportamenti della modalità di transizione sono diversi. Per ulteriori informazioni sulle modalità di transizione, potete vedere la classe NetStreamPlayTransitions.
Elementi API correlati
NetStreamPlayOptions | () | Funzione di costruzione |
public function NetStreamPlayOptions()
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Crea un oggetto NetStreamPlayOptions per specificare le opzioni che vengono passate al metodo NetStream.play2()
.
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z