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

Indica se Flash Player è connesso 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 chiamata NetConnection.connect() a Flash Media Server: "none", "HTTP", "HTTPS" o "CONNECT". Il valore sarà "none" se non vi è tunneling per la connessione, "HTTP" se il tunneling della connessione viene eseguito tramite HTTP, "HTTPS" se il tunneling della connessione viene eseguito tramite HTTPS, e "CONNECT" se il tunneling della connessione viene eseguito tramite il metodo HTTP CONNECT.

Codifica oggetto predefinita (versione AMF) per tutti gli oggetti NetConnection creati nel file SWF. 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'intero file SWF), impostare la proprietà objectEncoding dell'oggetto NetConnection.

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

Vedere anche

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). Impostare la proprietà objectEncoding per stabilire la versione AMF dell’istanza NetConnection.

È importante comprendere questa proprietà se si desidera che un file SWF di ActionScript 3.0 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 di NetConnection create in questo file SWF utilizzano la serializzazione AMF3, pertanto non è necessario comunicare a Flash Player quale codifica utilizzare.
• Connessione a un server che non supporta AMF3 (per esempio Flash Media Server 2). In questo caso impostare 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, impostare la codifica degli oggetti per ogni singola connessione utilizzando la proprietà objectEncoding. Impostarla su ObjectEncoding.AMF0 per connettersi ai server che utilizzano la codifica AMF0, quali e Flash Media Server 2, e su ObjectEncoding.AMF3 per connettersi 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 si utilizza la codifica sbagliata per connettersi a un server, Flash Player 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.

Vedere anche

Determina quali metodi di riserva vengono provati se non riesce il tentativo di connessione iniziale al server. È necessario impostare la proprietà proxyType prima di chiamare il metodo NetConnection.connect().

I valori accettati sono "none", "HTTP", "CONNECT" e "best".

In Flash Player 9, il valore predefinito per questa proprietà è "none"; se non si modifica questo valore, Flash Player utilizza il tunneling HTTPS per RTMPS. Se la proprietà è impostata su "best", il client tenterà di connettersi utilizzando l’SSL nativo. Se la connessione non riesce, vengono provati altri metodi di connessione. Se la proprietà è impostata su "HTTP" e una connessione diretta non riesce, 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.

In Flash Player 9, questa proprietà è applicabile solo quando si utilizza RTMP, RTMPS o RTMPT. Il metodo CONNECT è applicabile solo per gli utenti che sono connessi alla rete tramite un server proxy.

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. Chiamare connect() per effettuare una connessione.

Se il file SWF deve comunicare con dei server realizzati prima di Flash Player 9, è possibile regolare la proprietà objectEncoding dell'oggetto NetConnection.

Vedere anche

Aggiunge un'intestazione contestuale alla struttura dei pacchetti Action Message Format (AMF). Questa intestazione viene inviata con ogni pacchetto AMF futuro. Se si chiama 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

Richiama un comando o un metodo sul Flash Media Server o su un’applicazione server che utilizza Flash Remoting. Per connettersi al server è necessario richiamare NetConnection.connect() prima di richiamare NetConnection.call(). È necessario creare una funzione lato server da passare a questo metodo.

Parametri

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, utilizzare NetStream.close()). Se si chiude la connessione e si desidera successivamente crearne un’altra, è necessario 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 è necessario ricreare l'oggetto condiviso per riconnettersi, è 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 aver ristabilito una connessione all'oggetto condiviso.

Con Flash Media Server, l’operazione più pratica da effettuare è quella di richiamare close() nel momento in cui il client non ha più bisogno della connessione al server. Richiamare close() è il modo più veloce per eliminare le connessioni inutilizzate. Come operazione di back-up, è possibile configurare il server in modo che chiuda tutte le connessioni inattive. Per maggiori informazioni consultare la Guida alla configurazione e amministrazione Flash Media Server.

Vedere anche

Crea una connessione bidirezionale tra Flash Player e un’applicazione Flash Media Server. L’oggetto NetConnection funziona come canale di collegamento tra il client e il server. Utilizzare degli oggetti NetStream per inviare dei flussi di dati lungo questo canale. Per informazioni riguardo ai codec supportati e i formati di file supportati da Flash Media Server, consultare la documentazione Flash Media Server.

Se non si ha a disposizione Flash Media Server, richiamare NetConnection.connect() per eseguire file video e MP3 da un computer locale o da un server web. Per informazioni riguardo ai codec supportati e i formati di file supportati consultare il sito http://www.adobe.com/go/hardware_scaling_it.

Crea una connessione bidirezionale tra Flash Player e un’applicazione server che utilizza il servizio Flash Remoting. Utilizzare la classe NetServices per richiamare funzioni sull’applicazione server e per restituire dei risultati sulla stessa riguardanti un oggetto NetConnection. Per maggiori informazioni consultare la documentazione Flash Remoting .

Quando si utilizza questo metodo, considerare il modello di sicurezza di Flash Player nonché le seguenti considerazioni:

• Per impostazione predefinita, Flash Player nega l'accesso tra le sandbox. L'accesso a una risorsa sul sito Web è consentito mediante un file dei criteri per i domini.
• L’applicazione potrebbe negare l’accesso a una risorsa situata sul server. In un’applicazione server Flash Media è necessario aggiungere un codice dal lato server per negare l’accesso. Per maggiori dettagli consultare la documentazione Flash Media Server.
• Non è possibile utilizzare NetConnection.connect() se il file SWF chiamante si trova nella sandbox locale con file system.
• È possibile impedire che un file SWF utilizzi questo metodo impostando il parametro allowNetworking dei tag object ed embed nella pagina HTML che include il contenuto SWF.

Per ulteriori informazioni, vedere i seguenti riferimenti:

• Il capitolo Sicurezza di Flash Player nel volume Programmazione in ActionScript 3.0 e i commenti più recenti in LiveDocs
• Il White paper sulla sicurezza per Flash Player 9

Parametri

Vedere anche

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à:

Vedere anche

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à:

Vedere anche

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 aNetStream.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 = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        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 {
            stream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
    }
}

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);
    }
}