Flash Media Server Developer Documentation

Client.readAccess

clientObject.readAccess

A string of directories containing application resources (shared objects and streams) to which the client has read access. To give a client read access to directories that contain application resources, list the directories in a string delimited by semicolons.

Availability

Flash Communication Server 1

Details

By default, all clients have full read access, and the readAccess property is set to slash (/). To give a client read access, specify a list of access levels (in URI format), delimited by semicolons. Any files or directories within a specified URI are also considered accessible. For example, if myMedia is specified as an access level, any files or directories in the myMedia directory are also accessible (for example, myMedia/mp3s). Similarly, any files or directories in the myMedia/mp3s directory are also accessible, and so on.

Clients with read access to a directory that contains streams can play streams in the specified access levels. Clients with read access to a directory that contains shared objects can subscribe to shared objects in the specified access levels and receive notification of changes in the shared objects.

  • For streams, readAccess controls the streams that the connection can play.
  • For shared objects, readAccess controls whether the connection can listen to shared object changes.

Although you cannot use this property to control access for a particular file, you can create a separate directory for a file if you want to control access to it.

Note: You cannot set this property in the application.onPublish() event.

Example

The following onConnect() function gives a client read access to myMedia/mp3s, myData/notes, and any files or directories within them:

application.onConnect = function(newClient, name){
    newClient.readAccess = "myMedia/mp3s;myData/notes";
};