Indica l'oggetto su cui vengono chiamati i metodi di callback. L'oggetto predefinito è this. È possibile impostare la proprietà su un altro oggetto, e i metodi di callback vengono richiamati su tale oggetto.

La raccolta degli attributi assegnati alla proprietà data dell'oggetto; questi attributi possono essere condivisi e memorizzati. Ogni attributo può essere un oggetto di un tipo ActionScript o JavaScript di base: Array, Number, Boolean, ByteArray, XML, e così via. Ad esempio, le righe seguenti assegnano dei valori ai vari aspetti di un oggetto condiviso:

  var items_array:Array = new Array(101, 346, 483);
  var currentUserIsAdmin:Boolean = true;
  var currentUserName:String = "Ramona";
  
  var my_so:SharedObject = SharedObject.getLocal("superfoo");
  my_so.data.itemNumbers = items_array;
  my_so.data.adminPrivileges = currentUserIsAdmin;
  my_so.data.userName = currentUserName;
  
  for (var prop in my_so.data) {
    trace(prop+": "+my_so.data[prop]);
  }
  

Tutti gli attributi della proprietà data di un oggetto condiviso vengono salvati se l'oggetto è persistente, e l'oggetto condiviso contiene le informazioni seguenti:

  userName: Ramona
  adminPrivileges: true
  itemNumbers: 101,346,483
  

Nota: non assegnare direttamente dei valori alla proprietà data di un oggetto condiviso (come in so.data = someValue poiché Flash ignora tali assegnazioni.

Per eliminare gli attributi degli oggetti condivisi locali, utilizzare un codice simile a delete so.data.attributeName; se si imposta l'attributo di un oggetto locale condiviso su null o undefined, l'attributo non viene eliminato.

Per creare valori private per un oggetto condiviso (ovvero valori disponibili solo per l'istanza del client mentre l'oggetto è in uso e che non vengono memorizzati quando viene chiuso), memorizzarli creando proprietà con nomi diversi da data, come nell'esempio seguente:

  var my_so:SharedObject = SharedObject.getLocal("superfoo");
  my_so.favoriteColor = "blue";
  my_so.favoriteNightClub = "The Bluenote Tavern";
  my_so.favoriteSong = "My World is Blue";
  
  for (var prop in my_so) {
    trace(prop+": "+my_so[prop]);
  }
  

L'oggetto condiviso contiene i dati seguenti:

  favoriteSong: My World is Blue
  favoriteNightClub: The Bluenote Tavern
  favoriteColor: blue
  data: [object Object]
  

Per gli oggetti condivisi remoti utilizzati in un server, tutti gli attributi della proprietà data sono disponibili per tutti I client connesso all’oggetto condiviso e tutti gli attributi vengono salvati se l’oggetto è permanente. Se un client modifica il valore di un attributo, tutti i client possono immediatamente vedere quel nuovo valore.

Vedere anche

La codifica oggetto predefinita (versione AMF) per tutti gli oggetti condivisi locali creati nel file SWF. Quando gli oggetti condivisi locali vengono scritti su disco, la proprietà SharedObject.defaultObjectEncoding indica quale versione di Action Message Format deve essere utilizzata: il formato ActionScript 3.0 (AMF3) o il formato ActionScript 1.0 o 2.0 (AMF0).

Per ulteriori informazioni sulla codifica degli oggetti, compresa la differenza tra la codifica degli oggetti condivisi locali e remoti, vedere la descrizione della proprietà objectEncoding.

Il valore predefinito di SharedObject.defaultObjectEncoding è impostato per utilizzare il formato ActionScript 3.0, AMF3. Se è necessario scrivere oggetti condivisi locali che siano leggibili dai file SWF in ActionScript 2.0 o 1.0, impostare SharedObject.defaultObjectEncoding affinché utilizzi il formato ActionScript 1.0 o ActionScript 2.0, flash.net.ObjectEncoding.AMF0, all'inizio dello script, prima di creare qualunque oggetto condiviso locale. Tutti gli oggetti condivisi locali creati successivamente utilizzeranno la codifica AMF0 e potranno interagire con contenuti di versioni precedenti. Non è possibile modificare il valore objectEncoding degli oggetti condivisi locali esistenti impostando SharedObject.defaultObjectEncoding dopo che sono stati creati gli oggetti condivisi locali.

Per impostare la codifica oggetto in base al singolo oggetto anziché per tutti gli oggetti condivisi creati dal file SWF, impostare la proprietà objectEncoding dell'oggetto condiviso locale.

Vedere anche

Specifica il numero di volte al secondo per cui le modifiche di un client a un oggetto condiviso vengono inviate al server.

Utilizzare questo metodo per controllare la quantità di traffico tra il client e il server. Ad esempio, se la connessione tra il client e il server è relativamente lenta, è possibile impostare fps su un valore relativamente basso. Al contrario, se il client è connesso a un'applicazione multiutente in cui i tempi sono importanti, è possibile impostare fps su un valore relativamente alto.

Se si imposta fps, verrà attivato l'evento sync e verranno aggiornate tutte le modifiche sul server. Se si desidera aggiornare solo il server manualmente, impostare fps su 0.

Le modifiche non vengono inviate al server finché non è stato inviato l'evento sync. In altre parole, se il tempo di risposta da parte del server è lento, è possibile che gli aggiornamenti vengano inviati al server con minore frequenza rispetto al valore specificato in questa proprietà.

La codifica oggetto (versione AMF) per questo oggetto condiviso. Quando gli oggetti condivisi locali vengono scritti su disco, la proprietà objectEncoding indica quale versione di Action Message Format deve essere utilizzata: il formato ActionScript 3.0 (AMF3) o il formato ActionScript 1.0 o 2.0 (AMF0).

La codifica dell'oggetto viene gestita in modo diverso a seconda che l'oggetto condiviso sia locale o remoto.

• Oggetti condivisi locali. È possibile ottenere o impostare il valore della proprietà objectEncoding per gli oggetti condivisi locali. Il valore di objectEncoding influisce sulla formattazione utilizzata per scrivere questo oggetto condiviso locale. Se questo oggetto condiviso locale deve essere leggibile dai file SWF in ActionScript 2.0 o 1.0, impostare objectEncoding su ObjectEncoding.AMF0. Anche se la codifica dell'oggetto è impostata per scrivere in formato AMF3, Flash Player è sempre in grado di leggere gli oggetti condivisi locali in formato AMF0. In altre parole, se si utilizza il valore predefinito di questa proprietà, ObjectEncoding.AMF3, il file SWF è ancora in grado di leggere gli oggetti condivisi creati dai file SWF in ActionScript 2.0 o 1.0.
• Oggetti condivisi remoti. Quando è connesso al server, un oggetto condiviso remoto eredita le impostazioni di objectEncoding dall'istanza NetConnection associata (l'istanza utilizzata per connettersi all'oggetto condiviso remoto). Quando non è connesso al server, un oggetto condiviso remoto eredita l'impostazione di defaultObjectEncoding dall'istanza NetConnection associata. Dal momento che il valore della proprietà objectEncoding di un oggetto condiviso remoto è determinato dall'istanza NetConnection, per gli oggetti condivisi remoti questa proprietà è di sola lettura.

Vedere anche

Le dimensioni correnti dell'oggetto condiviso, espresse in byte.

Flash calcola le dimensioni di un oggetto condiviso scorrendone tutte le proprietà data; maggiore è il numero di proprietà data dell'oggetto, maggiore è il tempo richiesto per stimarne le dimensioni. La stima delle dimensioni di un oggetto può richiedere un tempo di elaborazione significativo, pertanto è consigliabile evitare di utilizzare questo metodo se non è specificamente necessario.

Vedere anche

import flash.net.SharedObject;

// if these get copied or not
var mySo:SharedObject = SharedObject.getLocal("thehobbit");
mySo.data.username = "bilbobaggins";
trace(mySo.size); // 55

Per gli oggetti condivisi locali, tutti i dati vengono scaricati e l'oggetto condiviso viene eliminato dal disco. Il riferimento all'oggetto condiviso è ancora attivo, ma tutte le relative proprietà data vengono eliminate.

Per gli oggetti condivisi remoti utilizzati con Flash Media Server, clear() disconnette l’oggetto e rimuove tutti i dati. Se l’oggetto condiviso è permanente in locale questo metodo elimina l’oggetto condiviso anche dal disco. Il riferimento all'oggetto condiviso è ancora attivo, ma tutte le relative proprietà data vengono eliminate.

package {
    import flash.net.SharedObject;

    public class SharedObject_clear {
        private var hostName:String = "yourDomain";
        private var username:String = "yourUsername";

        public function SharedObject_clear() {
            var mySo:SharedObject = SharedObject.getLocal(hostName);
            if(mySo.data.username == null) {
                mySo.data.username = username;
                trace("set: " + mySo.data.username); // yourUsername
            }
            else {
                mySo.clear();
                trace("cleared: " + mySo.data.username); // undefined
            }
        }
    }
}

Chiude la connessione tra un oggetto condiviso remoto e il server. Se un oggetto condiviso remoto è permanente a livello locale, l'utente può apportare delle modifiche alla copia locale dell'oggetto dopo che è stato chiamato questo metodo. Tutte le modifiche apportate all'oggetto locale vengono inviate al server alla successiva connessione all'oggetto condiviso remoto da parte dell'utente.

Si connette a un oggetto condiviso remoto sul server utilizzando l’oggetto NetConnection specificato. Utilizzare questo metodo dopo aver richiamato getRemote(). Quando la connessione avviene correttamente viene inviato l’evento sync.

Prima di provare a lavorare con un oggetto condiviso remoto, controllare eventuali errori utilizzando try.catch..Dichiarazione finally. Quindi ascoltare e gestire l’evento sync prima di effettuare modifiche all’oggetto condiviso. Qualsiasi modifica effettuata localmente prima che l’evento sync venga inviato, potrebbe essere persa.

Richiamare il metodo connect() per connettersi a un oggetto condiviso remoto, per esempio:

  var myRemoteSO:SharedObject = SharedObject.getRemote("mo", myNC.uri, false);
  myRemoteSO.connect(myNC);
  

Parametri

Vedere anche

Scrive immediatamente in un file locale un oggetto condiviso persistente a livello locale. Se non si utilizza questo metodo, l'oggetto condiviso viene scritto in un file quando termina la sessione corrispondente, ovvero quando viene chiuso il file SWF, quando l'oggetto condiviso viene spostato nel Cestino perché non esistono più riferimenti ad esso oppure quando si effettua la chiamata a SharedObject.clear() o SharedObject.close().

Se questo metodo restituisce il valore SharedObjectFlushStatus.PENDING, Flash Player visualizza una finestra di dialogo che richiede all'utente di aumentare la quantità di spazio disponibile su disco per gli oggetti di questo dominio. Per allocare spazio entro cui potranno aumentare le dimensioni dell'oggetto condiviso con i successivi salvataggi ed evitare quindi che venga restituito il valore PENDING, passare un valore per minDiskSpace. Quando Flash Player tenta di scrivere il file, viene effettuata la ricerca del numero di byte passati a minDiskSpace anziché la verifica dello spazio libero sufficiente per salvare l'oggetto condiviso con le dimensioni effettive.

Ad esempio, se si prevede che un oggetto condiviso raggiunga dimensioni massime di 500 byte anche se all'inizio ha dimensioni più ridotte, passare 500 per minDiskSpace. In tal caso, all'utente viene richiesto di assegnare 500 byte di spazio su disco per l'oggetto condiviso. Una volta che l'utente ha allocato la quantità di spazio richiesta, non sarà più necessario richiedere altro spazio in occasione dei successivi tentativi di scaricare l'oggetto (fintanto che le dimensioni dell'oggetto non superano i 500 byte).

Dopo che l’utente risponde alla finestra di dialogo, questo metodo viene nuovamente richiamato. Viene inviato un evento netStatus con la proprietà code impostata su SharedObject.Flush.Success o SharedObject.Flush.Failed.

Parametri

Vedere anche

package {
    import flash.net.SharedObject;

    public class SharedObject_flush {
        private var hostName:String = "yourDomain";
        private var username:String = "yourUsername";

        public function SharedObject_flush() {
            var mySo:SharedObject = SharedObject.getLocal(hostName);
            mySo.data.username = username;
            var flushResult:Object = mySo.flush();
            trace("flushResult: " + flushResult);
            trace(mySo.data.username); // yourUsername
        }
    }
}

Restituisce un riferimento a un oggetto condiviso permanente a livello locale che è disponibile solo per il client corrente. Se l'oggetto condiviso non esiste, il metodo lo crea. Se qualcuno dei valori passati a getLocal() non è valido o se la chiamata non riesce, Flash Player genera un'eccezione.

Il codice seguente mostra come assegnare a una variabile il riferimento all'oggetto condiviso restituito:

var so:SharedObject = SharedObject.getLocal("savedData");

Nota: se l'utente ha scelto di non consentire mai la memorizzazione locale per questo dominio, l'oggetto non viene salvato a livello locale, anche se è specificato un valore per localPath. L'eccezione a questa regola è il contenuto locale. I contenuti locali possono sempre scrivere sul disco oggetti condivisi di domini di terze parti (ovvero di domini diversi da quello correntemente visualizzato nella barra degli indirizzi del browser), anche se la scrittura su disco di oggetti condivisi di terze parti non è consentita.

Per evitare conflitti tra i nomi, viene cercata la posizione del file SWF che sta creando l'oggetto condiviso. Ad esempio, se un file SWF all'indirizzo www.myCompany.com/apps/stockwatcher.swf crea un oggetto condiviso di nome portfolio, tale oggetto condiviso non entra in conflitto con un altro oggetto di nome portfolio creato da un file SWF all'indirizzo www.yourCompany.com/photoshoot.swf poiché i due file SWF si trovano in directory diverse.

Benché il parametro localPath sia opzionale, è consigliabile valutarne attentamente l'uso, specialmente se si prevede che i file SWF possano accedere all'oggetto condiviso. Se i dati dell'oggetto condiviso sono specifici di un file SWF che non si prevede di spostare in un'altra posizione, può essere opportuno utilizzare il valore predefinito. Se è necessario che altri file SWF accedano all'oggetto condiviso o se si prevede di spostare il file SWF che crea l'oggetto condiviso, il valore di questo parametro può incidere sulla possibilità di accedere all'oggetto condiviso. Ad esempio, se si crea un oggetto condiviso impostando localPath sul valore predefinito del percorso completo del file SWF, nessun altro file SWF può accedere all'oggetto condiviso. Se successivamente si sposta il file SWF originale in un'altra posizione, nemmeno il file SWF originale sarà in grado di accedere ai dati già memorizzati nell'oggetto condiviso.

Per evitare di limitare inavvertitamente l'accesso a un oggetto condiviso, utilizzare il parametro localpath. L'approccio più permissivo consiste nell'impostare il parametro localPath su / (barra), che rende l'oggetto condiviso disponibile per tutti i file SWF del dominio, ma aumenta la probabilità di conflitto con i nomi di altri oggetti condivisi presenti nel dominio. Un approccio più restrittivo consiste nell'aggiungere a localPath i nomi di cartella che si trovano nel percorso completo del file SWF. Ad esempio, per un oggetto condiviso portfolio creato dal file SWF all'indirizzo www.myCompany.com/apps/stockwatcher.swf, è possibile impostare il parametro localPath su /, /apps o /apps/stockwatcher.swf. È necessario determinare quale approccio fornisce il livello ottimale di flessibilità per l'applicazione utilizzata.

Quando si utilizza questo metodo, considerare il modello di sicurezza di Flash Player:

• Non è possibile accedere agli oggetti condivisi tramite i limiti sandbox.
• Gli utenti possono limitare l'accesso agli oggetti condivisi tramite la finestra di dialogo Impostazioni o Gestione impostazioni di Flash Player. Per impostazione predefinita, un'applicazione può creare oggetti condivisi fino a 100 KB di dati per dominio. Gli amministratori e i normali utenti possono anche limitare la possibilità di scrivere sul file system.

Si supponga di pubblicare dei file SWF da riprodurre come file locali (sia file SWF installati localmente o file EXE) e che sia necessario accedere a uno specifico oggetto condiviso da più di un file SWF locale. In tale situazione, è opportuno considerare che per i file locali è possibile utilizzare due posizioni diverse per memorizzare gli oggetti condivisi. Il dominio utilizzato dipende dalle autorizzazioni di sicurezza concesse al file locale che ha creato l'oggetto condiviso. I file locali possono avere tre diversi livelli di autorizzazione:

1. Accesso solo al file system locale.
2. Accesso solo alla rete.
3. Accesso sia al file system locale che alla rete.

I file locali con accesso al file system locale (livello 1 o 3) memorizzano i relativi oggetti condivisi in una posizione. I file locali senza l'accesso al file system locale (livello 2) memorizzano i relativi oggetti condivisi in un'altra posizione.

È 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

	name:String — Il nome dell'oggetto. Il nome può includere caratteri barra (/), ad esempio lavoro/indirizzi è un nome valido. Nel nome di un oggetto condiviso non sono consentiti spazi, né i caratteri seguenti: ~ % & \ ; : " ' , < > ? #
	localPath:String (default = null) — Il percorso completo o parziale del file SWF che ha creato l'oggetto condiviso e che determina la posizione di memorizzazione locale dell'oggetto. Se non si specifica questo parametro, viene utilizzato il percorso completo.
	secure:Boolean (default = false) — Specifica se l'accesso all'oggetto condiviso è limitato per i file SWF distribuiti tramite una connessione HTTPS. Se il file SWF viene distribuito tramite HTTPS, il valore di questo parametro produce gli effetti seguenti: Se il parametro viene impostato su true, Flash Player crea un nuovo oggetto condiviso protetto oppure acquisisce un riferimento all'oggetto condiviso protetto esistente. Questo oggetto condiviso protetto può essere letto o scritto solo da/su file SWF distribuiti tramite HTTPS che chiamano SharedObject.getLocal() con il parametrosecure impostato su true. Se il parametro viene impostato su false, Flash Player crea un nuovo oggetto condiviso oppure ottiene un riferimento a un oggetto condiviso esistente che può essere letto o scritto dai file SWF distribuiti mediante connessioni non HTTPS. Se il file SWF viene distribuito tramite una connessione non HTTPS e si tenta di impostare il parametro su true, il nuovo oggetto condiviso (oppure l'accesso a un oggetto condiviso protetto esistente) non viene creato e viene restituito null. Indipendentemente dal valore di questo parametro, gli oggetti condivisi creati vengono presi in considerazione per il conteggio dello spazio totale su disco concesso al dominio. Il seguente diagramma mostra come usare il parametro secure:

Vedere anche

Restituisce un riferimento a un oggetto condiviso sul Flash Media Server accessibile da parte di più client. Se l'oggetto condiviso non esiste, il metodo lo crea.

Per creare un oggetto condiviso remoto richiamare getRemote() e quindi connect() per connettere l’oggetto condiviso remoto al server come di seguito illustrato:

     var nc:NetConnection = new NetConnection();
     nc.connect("rtmp://somedomain.com/applicationName");
     var myRemoteSO:SharedObject = SharedObject.getRemote("mo", nc.uri, false);
     myRemoteSO.connect(nc);
     

Per confermare che le copie locale e remota dell'oggetto condiviso sono sincronizzate, ascoltate e gestite utilizzare l'evento sync. Tutti i client che desiderano condividere questo oggetto devono passare gli stessi valori per i parametri name e remotePath.

Per creare un oggetto condiviso che sia disponibile solo per il client corrente, utilizzare SharedObject.getLocal().

Parametri

 ~ % & \ ; : " ' , > ? ? #

Vedere anche

Trasmette un messaggio a tutti i client connessi ad un oggetto condiviso remoto, compreso il client che ha inviato il messaggio. Per elaborare il messaggio e rispondere a esso, creare una funzione callback allegata all'oggetto condiviso.

Parametri

Indica al server che il valore di una proprietà nell'oggetto condiviso è cambiato. Questo metodo segna le proprietà come dirty, cioè modificate.

Richiama SharedObject.setProperty() per creare delle proprietà per un oggetto condiviso.

Il metodo SharedObject.setProperty() implementa setDirty(). Nella maggior parte dei casi, ad esempio quando il valore di una proprietà è di tipo di base come String o Number, è possibile utilizzare setProperty() invece di richiamare setDirty(). Tuttavia, quando il valore di una proprietà è un oggetto che contiene a propria volta delle proprietà, occorre utilizzare setDirty() per indicare quando un valore all'interno dell'oggetto è cambiato.

Parametri

Vedere anche

Aggiorna il valore di una proprietà in un oggetto condiviso e indica al server che il valore della proprietà è cambiato. Il metodo setProperty() segna esplicitamente le proprietà come modificate o dirty.

Per ulteriori informazioni sugli oggetti condivisi remoti, consultare la documentazione di Flash Media Server.

Nota: il metodo SharedObject.setProperty() implementa il metodo setDirty(). Nella maggior parte dei casi, ad esempio quando il valore di una proprietà è di tipo di base come String o Number, si utilizza setProperty() anziché setDirty. Tuttavia, quando il valore di una proprietà è un oggetto che contiene a propria volta delle proprietà, utilizzare setDirty() per indicare quando un valore all'interno dell'oggetto è cambiato. In linea generale, è consigliabile chiamare setProperty() anziché setDirty(), poiché setProperty() aggiorna il valore di una proprietà solo quando il valore è cambiato, pertantosetDirty() impone la sincronizzazione a tutti i client che hanno effettuato il subscribing.

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 un'istanza SharedObject 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 se l'oggetto condiviso è stato scritto correttamente sul disco locale.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando un oggetto condiviso remoto è stato aggiornato dal server.

Questo evento ha le seguenti proprietà:

Vedere anche