Client-Side Communication ActionScript > NetStream.send

NetStream.send

Availability

	Flash Player 6.
	Flash Communication Server MX.

Usage

myStream.send(handlerName [,p1, ...,pN])

Parameters

handlerName A string that identifies the message; also the name of the ActionScript handler to receive the message. The handler name can be only one level deep (that is, it can't be of the form parent/child) and is relative to the stream object.

Note: Do not use a reserved term for a handler name. For example, myStream.send("close") will fail.

p1, ...,pN Optional parameters that can be of any type. They are serialized and sent over the connection, and the receiving handler receives them in the same order. If a parameter is a circular object (for example, a linked list that is circular), the serializer handles the references correctly.

Returns

Nothing.

Description

Method; broadcasts a message on the specified stream to all subscribing clients. This method is available only to the publisher of the specified stream.

To process and respond to the message, create a handler in the format myStream.HandlerName.

The Flash Player does not serialize methods or their data, object prototype variables, or non-enumerable variables. Also, for movie clips, the player serializes the path but none of the data.

The sending client has the following script:

myConnection = new NetConnection();
myConnection.connect("rtmp://myServer.myDomain.com/appName/appInstance");
tStream = new NetStream(myConnection);
tStream.publish("slav", "live");	
tStream.send("Fun", "this is a test");	//Fun is the handler name

The receiving client's script looks something like this:

myConnection = new NetConnection();
myConnection.connect("rtmp://myServer.myDomain.com/appName");
tStream = new NetStream(myConnection);
tStream.play("slav", -1, -1);

tStream.Fun = function(str) { //Fun is the handler name
    trace (str);
}