Macromedia flash media server 2-client-side actionscript language reference for flash media server 2 ユーザーズマニュアル

SharedObject class

133

Parameters

  An array of objects; each object contains properties that describe the changed 

members of a remote shared object. 

Returns

Nothing.

Description

Event handler; initially invoked when the client and server shared object are synchronized 
after a successful call to 

, and later invoked whenever any client 

changes the attributes of the 

data

 property of the remote shared object. You must create a 

function to override this handler and process the information object sent by this event 
handler. The properties of each object are 

code

, 

name

, and 

oldValue

. 

When you initially connect to a remote shared object that is persistent locally and/or on the 
server, all the properties of this object are set to empty strings. Otherwise, Flash sets 

code

 to

 

"clear"

, 

"success"

, 

"reject"

, 

"change"

, 

or "delete".

 

■

A value of 

"clear"

 means either that you have successfully connected to a remote shared 

object that is not persistent on the server or the client, or that all the properties of the 
object have been deleted—for example, when the client and server copies of the object are 
so far out of sync that Flash resynchronizes the client object with the server object. In the 
latter case, 

 is invoked again, this time with the value of 

code

 set 

to 

"change"

.

■

A value of 

"success"

 means the client changed the shared object. 

■

A value of 

"reject"

 means the client tried unsuccessfully to change the object; instead, 

another client changed the object. 

■

A value of 

"change"

 means another client changed the object or the server resynchronized 

the object. 

■

A value of 

"delete"

 means the attribute was deleted. 

The 

name

 property contains the name of the property that has been changed.

The 

oldValue

 property contains the former value of the changed property. This parameter is 

null

 unless 

code

 has a value of 

"reject"

 or 

"change"

.