Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > sendMessage()

 

sendMessage()

Syntax

whichServerMovie.sendMessage( string/listRecipient, "system.script.subject", messageContents {, errorCode {, protocolFlag {, stringSenderID}}} )

whichServerGroup.sendMessage( string/listRecipient, "system.script.subject", messageContents {, errorCode {, protocolFlag {, stringSenderID}}} )

whichServerUser.sendMessage( "system.script.subject", messageContents {, errorCode {, protocolFlag {, stringSenderID}}})

Description

Multiuser Server server-side command; sends a message from within a server-side script to the specified movie, group, or user.

When sending messages to a movie, the protocolFlag, errorCode, and stringSenderID are optional, but when used must be appear together and in the correct order. The protocolFlag is intended for future enhancements to the server and should be set to FALSE.

When sending a message to a user with the third syntax shown, the recipient parameter is omitted, since the specified user is the recipient.

The subject must begin with "system.script." to ensure that responses to the message are sent back to the server-side script.

This command is similar to sendNetMessage(), which is used in client movies.

Example

The following statement sends a message from the server-side script to the user Bob in the movie ChessMovie informing him that his opponent's rook has moved three squares forward. The error code is 0, the protocolFlag is FALSE and the senderID is the opponent whose name is John.

errCode = ChessMovie.sendMessage("Bob", "system.script.movePiece", ["Rook", 3, 0], 0, FALSE, "John")

See also

sendNetMessage()