FLASH® LITE™ 2.x - Adobe Help and Support

■ A Flash application can be used as a user interface for a service that allows users to search
for music reviews. The application lets users store information about their favorite
albums. The information can be stored on the remote server, but this causes problems if
the application cannot connect to the service. Also, retrieving the data from a remote
service can be slow and detract from the user experience. Shared objects enable the
application to store information about the albums to the device and load it quickly when
needed.
Note: Because space is limited on mobile devices, the data is not completely persistent; in
some situations, the platform could delete the oldest data from the device.
To create a local shared object, use the following syntax:
var so:shared object = shared object.getLocal("mySharedObject");
Reading and writing data on a handset can be slow. To ensure that data is immediately
available when the application requests it from the device, Flash Lite 2.0 requires you to set up
a listener. The player invokes the listener when the device has loaded the shared object's data.
Methods that access the SharedObject instance returned by the call to getLocal() should
wait until the listener is invoked before attempting any operations.
Example
In the following example, a SWF file creates a listener function named Prefs and then creates
a shared object. The player calls the loadCompletePrefs function when the data is available.
function loadCompletePrefs (mySO:SharedObject) {
if (0 == mySO.getSize() )
{
// If the size is 0, we need to initialize the data:
mySO.data.name = "Sigismund";
mySO.data.email = "siggy@macromedia.com";
}
else
{
// Trace all the data in mySO:
trace( "Prefs:" );
for (var idx in mySO.data) {
trace( " " + idx +": " + mySO.data[idx] );
}
}
}
SharedObject.addListener( "Prefs", loadCompletePrefs );
// We can now create the shared object:
var Prefs:SharedObject = SharedObject.getLocal("Prefs");
552 ActionScript classes