You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.
This shows you the differences between two versions of the page.
|
functions:llsay [2014-01-05 04:46 SLT] sei Additions/corrections |
functions:llsay [2016-11-12 15:33 SLT] (current) sei Add note |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | $nav | ||
| ===== Function: llSay ===== | ===== Function: llSay ===== | ||
| Line 9: | Line 10: | ||
| === channel === | === channel === | ||
| - | Determines the channel that message will be sent on. | + | Determines the channel that message will be sent on. Channel can be any integer, positive or negative. Channel 0 is open chat (also known as $lct[PUBLIC CHANNEL]). Channel $lct[DEBUG_CHANNEL] will send the message to the //Script Warning/Error window//. |
| - | Channel can be any integer, positive or negative. | + | |
| - | Channel 0 is open chat (also known as [[constants/PUBLIC CHANNEL]]) | + | |
| - | Channel [[constants/DEBUG_CHANNEL]] will send the message to the Script Warning/Error window. | + | |
| === message === | === message === | ||
| - | Contains the text to be said | + | Contains the text to be said. |
| ===== Notes ===== | ===== Notes ===== | ||
| - | * Text said via llSay can be heard up to 20 metres away from the PRIM the script is in. | + | * Text said via llSay can be heard up to 20 metres away from the prim the script is in. |
| - | * Messages sent on channel 0 or the [[constants/DEBUG_CHANNEL]], are throttled to a rate of about 200 every 10 seconds, per region, per owner/user. | + | * Messages sent on channel 0 or on $lct[DEBUG_CHANNEL], are throttled to a rate of about 200 every 10 seconds, per region, per owner/user. |
| - | * **message** can be a maximum of 1024 bytes when translated to [[http://en.wikipedia.org/wiki/UTF-8|UTF-8]]. The allowed number of characters can vary depending on what characters the message contains. For example, it allows: | + | * $prm[message] can be a maximum of 1024 bytes when translated to [[http://en.wikipedia.org/wiki/UTF-8|UTF-8]]. The allowed number of characters can vary depending on what characters the message contains. For example, it allows: |
| - | * up to 1024 UTF-8 characters in the ASCII range such as A or `$, | + | * up to 1024 UTF-8 characters in the ASCII range such as A or %, |
| * up to 512 two-byte UTF-8 characters such as И or £, | * up to 512 two-byte UTF-8 characters such as И or £, | ||
| * up to 341 three-byte UTF-8 characters such as ツ or €, | * up to 341 three-byte UTF-8 characters such as ツ or €, | ||
| * etc. or a mixture of them. | * etc. or a mixture of them. | ||
| * Negative channels are typically used for inter-object communication. | * Negative channels are typically used for inter-object communication. | ||
| + | * A script cannot hear anything said by any script within the same prim. This avoids recursion problems. It can hear text sent from a script in another prim within the same object, if it's within range. | ||
| + | * Attached objects in avatars can't be heard by other avatars if the avatars can't see nor hear each other due to parcel privacy settings. They still can be heard by other objects, though. | ||
| ===== Short examples ===== | ===== Short examples ===== | ||
| <code lsl2> | <code lsl2> | ||
| - | // Send the text "Hello friends" on channel zero. It will appear | + | // Send the text "Hello, friends" on channel zero. It will appear |
| - | // in the chat window of any avatar within 20 meters. | + | // in the chat window of any avatar within 20 metres. |
| - | llSay(0, "Hello friends"); | + | llSay(0, "Hello, friends"); |
| llSay(PUBLIC_CHANNEL, "Hello friends"); // Variant of the above | llSay(PUBLIC_CHANNEL, "Hello friends"); // Variant of the above | ||
| Line 48: | Line 48: | ||
| { | { | ||
| // Send a message on a specific negative channel | // Send a message on a specific negative channel | ||
| - | // The message will only be received by scripted objects that are listening on that channel | + | // The message will only be received by scripted prims that are listening on that channel |
| + | // and are within 20 metres of this prim. | ||
| llSay(-123456, "I was touched by " + llDetectedName(0)); | llSay(-123456, "I was touched by " + llDetectedName(0)); | ||
| } | } | ||
| Line 56: | Line 57: | ||
| ===== See also ===== | ===== See also ===== | ||
| - | * [[llWhisper]] for a 10 metres range version. | + | * $lfn[llWhisper] for a 10 metres range version. |
| - | * [[llShout]] for a 100 metres range version. | + | * $lfn[llShout] for a 100 metres range version. |
| - | * [[llOwnerSay]] to say something to the owner only. | + | * $lfn[llOwnerSay] to say something to the owner only. |
| - | * [[lRegionSay]] to say something in a certain channel to every avatar/object in the region (but channel 0 is disallowed). | + | * $lfn[lRegionSay] to say something in a certain channel to every avatar/prim in the region (but channel 0 is disallowed). |
| - | * [[llRegionSayTo]] to say something to a specific avatar or object in the region. | + | * $lfn[llRegionSayTo] to say something to a specific avatar or prim in the region. |
| - | * [[llInstantMessage]] to send an instant message to the specified avatar (can be across regions). | + | * $lfn[llInstantMessage] to send an instant message to the specified avatar (can be across regions). |
| + | * $lfn[llListen] to listen to what avatars or scripts say in a certain channel, and the accompanying $lev[listen] event. | ||