NetConnection  - AS3

Indica l'oggetto su cui vengono chiamati i metodi di callback. Il valore predefinito è questa istanza NetConnection. Se impostate la proprietà client su un altro oggetto, i metodi di callback vengono chiamati su tale oggetto.

Indica se l'applicazione è connessa a un server tramite una connessione RTMP permanente (true) o meno (false). Se la connessione avviene tramite http, questa proprietà è impostata su false, tranne nel caso in cui ci sia una connessione ai servizi Flash Remoting su un'applicazione server, nel qual caso viene impostata su true.

Tipo di proxy utilizzato per effettuare correttamente una connessione a Flash Media Server. I valori possibili sono "none", "HTTP", "HTTPS" e "CONNECT".

Il valore è "none" se la connessione non è instradata in tunneling o è una connessione SSL nativa.

Il valore è "none" se la connessione è instradata in tunneling via HTTP.

Il valore è "HTTPS" se la connessione è instradata in tunneling via HTTPS.

Il valore è "CONNECT" se la connessione è instradata in tunneling utilizzando il metodo CONNECT tramite un server proxy.

La codifica predefinita per gli oggetti NetConnection. Quando un oggetto viene scritto su dati binari o letto da essi, la proprietà objectEncoding indica quale versione di Action Message Format(AMF) deve essere utilizzata per rendere seriali i dati: il formato ActionScript 3.0 (ObjectEncoding.AMF3) o il formato ActionScript 1.0 o 2.0 (ObjectEncoding.AMF0).

Il valore predefinito è ObjectEncoding.AMF3. La modifica di NetConnection.defaultObjectEncoding non influisce sulle istanze di NetConnection esistenti ma solo su quelle che vengono create successivamente.

Per impostare la codifica di un oggetto separatamente (anziché impostarla per l'intera applicazione), impostate la proprietà objectEncoding dell'oggetto NetConnection.

Per ulteriori informazioni, vedete la descrizione della proprietà objectEncoding.

Elementi API correlati

L'identificatore dell'istanza di Flash Media Server a cui questa istanza di Flash Player o Adobe AIR è connessa. Questa proprietà è significativa solo per le connessioni RTMFP. Il valore di questa proprietà è disponibile solo dopo che è stata stabilita una connessione RTMFP.

Elementi API correlati

Un valore scelto sostanzialmente da Flash Media Server, specifico di questa connessione. Questo valore viene visualizzato sul server come valore client.nearNonce. Questo valore viene definito solo per le connessioni RTMFP, RTMPE e RTMPTE.

L'intervallo di attesa, in millisecondi, per una risposta HTTP. Il valore predefinito è zero.

• Il valore httpIdleTimeout è un numero.
• Quando usate una connessione HTTP, un valore positivo indica il numero di millisecondi durante i quali una connessione inattiva dovrà rimanere aperta.
• Una valore pari a zero indica che dovrà essere utilizzato il valore predefinito del timeout di inattività della rete per la piattaforma.
• Un valore negativo restituirà un RangeError.
• Se il valore httpIdleTimeout viene superato, verrà inviato un evento netStatus.
• Questa proprietà ha effetto solo sugli oggetti NetConnection creati con le connessioni HTTP. Gli oggetti NetConnection creati con RTMP, RTMFP o altri canali HTTP non vengono modificati da questa proprietà.

    //Set the timeout to 5 seconds
    connection = new NetConnection();
    connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
    connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
    connection.httpIdleTimeout = 5000;
    

Il numero totale di connessioni peer in entrata e in uscita consentite da questa istanza di Flash Player o Adobe AIR. Il valore predefinito è 8.

Questo valore non fa distinzione tra connessioni di publisher e subscriber. Se questo valore viene ridotto mentre sono presenti connessioni peer, il nuovo valore ha effetto solo sulle nuove connessioni in entrata. Le connessioni esistenti non vengono eliminate.

L'identificatore di questa istanza di Flash Player o Adobe AIR per questa istanza NetConnection. Questa proprietà è significativa solo per le connessioni RTMFP.

Ogni istanza NetConnection ha una proprietà nearID univoca. Lo stesso identificatore non è condiviso da alcuna istanza di Flash Player o Adobe AIR o NetConnection.

Altre istanze di Flash Player o Adobe AIR utilizzano questo identificatore come peerID per le nuove connessioni NetStream a questo client. Successivamente, questo identificatore rappresenta farID di qualsiasi NetStream peer che si connette a questa istanza.

Elementi API correlati

Un valore scelto sostanzialmente da questa istanza di Flash Player o Adobe AIR, specifico di questa connessione. Questo valore viene visualizzato sul server come valore nearNonce. Questo valore viene definito solo per le connessioni RTMFP, RTMPE e RTMPTE.

Codifica oggetto per questa istanza NetConnection.

Quando un oggetto viene scritto su dati binari o letto da essi, la proprietà objectEncoding indica quale versione di Action Message Format(AMF) deve essere utilizzata per rendere seriali i dati: il formato ActionScript 3.0 (ObjectEncoding.AMF3) o il formato ActionScript 1.0 o 2.0 (ObjectEncoding.AMF0). Impostate la proprietà objectEncoding per stabilire la versione AMF dell'istanza NetConnection.

È importante comprendere questa proprietà se si desidera che un'applicazione comunichi con i server rilasciati prima di Flash Player 9. Sono possibili i tre seguenti casi:

• Connessione a un server che supporta AMF3 (per esempio Flex Data Services 2 o Flash Media Server 3). Il valore predefinito di defaultObjectEncoding è ObjectEncoding.AMF3. Tutte le istanze NetConnection create in questo file utilizzano la serializzazione AMF3, pertanto non è necessario impostare la proprietà objectEncoding.
• Connessione a un server che non supporta AMF3 (per esempio Flash Media Server 2). In questo caso impostate la proprietà statica NetConnection.defaultObjectEncoding su ObjectEncoding.AMF0. Tutte le istanze di NetConnection create in questo file SWF utilizzano la serializzazione AMF0. Non è necessario impostare la proprietà objectEncoding.
• La connessione a più server che utilizzano versioni di codifica diverse. Anziché utilizzare defaultObjectEncoding, impostate la codifica degli oggetti per ogni singola connessione utilizzando la proprietà objectEncoding. Impostatela su ObjectEncoding.AMF0 per connettervi ai server che utilizzano la codifica AMF0, quali e Flash Media Server 2, e su ObjectEncoding.AMF3 per connettervi ai server che utilizzano la codifica AMF3, quale Flex 2.

Una volta connessa l'istanza NetConnection, la proprietà objectEncoding dell'istanza è di sola lettura.

Se utilizzate la codifica sbagliata per connettervi a un server, l'oggetto NetConnection invia l'evento netStatus. La proprietà NetStatusEvent.info contiene un oggetto informazione con la proprietà code impostata su NetConnection.Connect.Failed e una descrizione che indica che la codifica oggetto non è corretta.

Elementi API correlati

Il protocollo utilizzato per stabilire la connessione. Questa proprietà è pertinente quando utilizzate Flash Media Server. I valori possibili sono:

• "rtmp": Real-Time Messaging Protocol (RTMP)
• "rtmpe": Encrypted RTMP
• "rtmpt": HTTP tunneling RTMP
• "rtmpte": HTTP tunneling encrypted RTMP
• "rtmps": RTMP basato su HTTPS
• "rtmfp": Real-Time Media Flow Protocol (RTMFP)

Determina quali metodi di riserva vengono provati se non riesce il tentativo iniziale di connessione a Flash Media Server. Impostate la proprietà proxyType prima di chiamare il metodo NetConnection.connect().

I valori accettati sono "none", "HTTP", "CONNECTOnly", "CONNECT" e"best". Il valore predefinito è "none".

Per utilizzare l'SSL nativo, impostate la proprietà su "best". Se il lettore non può stabilire una connessione diretta con il server (sulla porta predefinita 443 o su un'altra porta che avete specificato) ed è presente un server proxy, il lettore tenta di utilizzare il metodo CONNECT. Se il tentativo fallisce, il lettore esegue il tunneling via HTTPS.

Se la proprietà è impostata su "CONNECTOnly", il lettore prova ad utilizzare per primo il metodo CONNECT. Se questo non funziona, non è presente alcun metodo di riserva.

Se la proprietà è impostata su "HTTP" e una connessione diretta ha esito negativo, viene utilizzato il metodo di tunneling HTTP. Se la proprietà è impostata su "CONNECT" e una connessione diretta non riesce, viene utilizzato il metodo di tunneling CONNECT. Se anche questo metodo dà esito negativo, per la connessione non viene utilizzato il tunneling HTTP come alternativa.

Questa proprietà è applicabile solo quando si utilizza RTMP, RTMPS o RTMPT. I metodi CONNECT e CONNECTOnly sono applicabili solo per gli utenti connessi alla rete tramite un server proxy.

Un oggetto che contiene tutti gli oggetti NetStream di sottoscrizione del peer non associati agli oggetti NetStream di pubblicazione. Gli oggetti NetStream di sottoscrizione associati agli oggetti NetStream di pubblicazione sono contenuti nell'array NetStream.peerStreams.

Elementi API correlati

L'URI è trasmesso al metodo NetConnection.connect(). Se non è stata ancora effettuata la chiamata a NetConnection.connect() o se non è stato trasmesso alcun URI, questa proprietà è undefined.

Indica se è stata effettuata una connessione di sicurezza mediante Transport Layer Security (TLS) anziché HTTPS. Questa proprietà è valida solo quando è connesso un oggetto NetConnection.

Crea un oggetto NetConnection. Chiamate il metodo connect() per effettuare una connessione.

Se un'applicazione deve comunicare con server rilasciati prima di Flash Player 9, impostate la proprietà objectEncoding dell'oggetto NetConnection.

Il codice seguente crea uno oggetto NetConnection.

     var nc:NetConnection = new NetConnection();
     

Elementi API correlati

Aggiunge un'intestazione contestuale alla struttura dei pacchetti Action Message Format (AMF). Questa intestazione viene inviata con ogni pacchetto AMF futuro. Se chiamate NetConnection.addHeader() utilizzando lo stesso nome, la nuova intestazione sostituisce quella esistente e permane per la durata dell'oggetto NetConnection. È possibile rimuovere un'intestazione chiamando NetConnection.addHeader() con il nome dell'intestazione per rimuovere un oggetto undefined.

Parametri

Chiama un comando o un metodo sul Flash Media Server o su un'applicazione server che utilizza Flash Remoting. Prima di chiamare NetConnection.call(), dovete chiamare NetConnection.connect() per connettervi al server. È necessario creare una funzione lato server da passare a questo metodo.

Non potete collegarvi alle porte comunemente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.

Parametri

Elementi API correlati

Chiude la connessione che è stata aperta a livello locale o con il server e invia l'evento netStatus con la proprietà code di NetConnection.Connect.Closed.

Questo metodo disconnette tutti gli oggetti NetStream in esecuzione sulla connessione. Tutti i dati in coda che non sono stati spediti vengono eliminati. (Per terminare gli streaming local or server senza chiudere la connessione, utilizzate NetStream.close()). Se chiudete la connessione e desiderate successivamente crearne un'altra, dovete creare un nuovo oggetto NetConnection e richiamare nuovamente il metodo connect().

Il metodo close() disconnette inoltre tutti gli oggetti condivisi remoti in esecuzione sulla connessione. Tuttavia, non dovete ricreare l'oggetto condiviso per riconnettervi, è sufficiente chiamare SharedObject.connect() per ristabilire la connessione all'oggetto condiviso. Inoltre, tutti i dati nell'oggetto condiviso che sono stati messi in coda al momento dell'emissione di NetConnection.close() vengono inviati dopo che avete ristabilito una connessione all'oggetto condiviso.

Con Flash Media Server, l'operazione più pratica da effettuare è quella di chiamare close() nel momento in cui il client non ha più bisogno della connessione al server. La chiamata di close() è il modo più veloce per eliminare le connessioni inutilizzate. Come misura di sicurezza, potete configurare il server in modo che chiuda tutte le connessioni inattive. Per ulteriori informazioni, vedete la Flash Media Server Configuration and Administration Guide (Guida alla configurazione e alla gestione di Flash Media Server).

Elementi API correlati

Crea una connessione bidirezionale con un'applicazione su Flash Media Server o Flash Remoting, oppure crea un endpoint di rete bidirezionale adatto alla comunicazione di gruppo peer-to-peer RTMFP. Per segnalare il proprio stato o una condizione di errore, una chiamata a NetConnection.connect() invia un evento netStatus.

Chiamate NetConnection.connect() per:

• Passate "null" per riprodurre video e file MP3 da un file system locale o da un server Web.
• Passate un URL "http" per connettervi a un server applicazioni che esegue Flash Remoting. Utilizzate la classe NetServices per richiamare funzioni sull'applicazione server e per restituire dei risultati sulla stessa riguardanti un oggetto NetConnection. Per ulteriori informazioni, vedete la documentazione di Flash Remoting.
• Passate un URL "rtmp/e/s" per connettervi a un'applicazione Flash Media Server.
• Passate un URL "rtmfp" per creare un endpoint di rete bidirezionale per la comunicazione client-server RTMFP, peer-to-peer e IP Multicast.
• Passate la stringa "rtmfp:" per creare un endpoint di rete bidirezionale serverless per la comunicazione IP multicast RTMFP.

Considerate il seguente modello di sicurezza:

• Per impostazione predefinita, Flash Player o AIR nega l'accesso tra le sandbox. L'accesso a una risorsa su un sito Web è consentito mediante l'utilizzo di un file dei criteri per gli URL.
• L'applicazione potrebbe negare l'accesso a una risorsa situata sul server. In un'applicazione Flash Media Server utilizzate codice ActionScript lato server per negare l'accesso. Per maggiori dettagli, vedete la documentazione di Flash Media Server.
• Non è possibile chiamare NetConnection.connect() se il file chiamante si trova nella sandbox locale con file system.
• Non potete collegarvi alle porte comunemente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.
• Per impedire che un file SWF utilizzi questo metodo, impostate il parametro allowNetworking dei tag object e embed nella pagina HTML che include il contenuto SWF.

Tuttavia, in Adobe AIR, il contenuto della funzione di sicurezza sandbox dell'applicazione (contenuto installato con l'applicazione AIR) non è interessato da queste limitazioni di sicurezza.

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Adobe Flash Player

Parametri

Elementi API correlati

Inviato quando viene generata un'eccezione in modo asincrono, cioè da un codice asincrono nativo.

Questo evento ha le seguenti proprietà:

Inviato quando si verifica un errore di input o di output che impedisce l'operazione di rete.

Questo evento ha le seguenti proprietà:

Inviato quando un oggetto NetConnection segnala il proprio stato o una condizione di errore. L'evento netStatus contiene una proprietà info, che è un oggetto informazione contenente informazioni specifiche sull'evento, ad esempio se un tentativo di connessione è riuscito o fallito.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato se una chiamata a NetConnection.call() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante.

Questo evento ha le seguenti proprietà:

Elementi API correlati

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.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

    public class NetConnectionExample extends Sprite {
        private var videoURL:String = "http://www.helpexamples.com/flash/video/cuepoints.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var video:Video = new Video();        

        public function NetConnectionExample() {
            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("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function connectStream():void {
            addChild(video);
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            video.attachNetStream(stream);
            stream.play(videoURL);
        }
    }
}

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}