llOpenRemoteDataChannel
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llOpenRemoteDataChannel( );254 | Function ID |
1.0 | Forced Delay |
10.0 | Energy |
Creates a channel to listen for XML-RPC calls. Will trigger a remote_data event with channel id once it is available.
Caveats
- This function causes the script to sleep for 1.0 seconds.
- If an object moves from one region to another it must re-open the channel
- The object will get the *same* channel as before, but without re-opening no requests will get through
- Any channel that is not used for 14 days will be cleaned up.
- May be advisable to somewhat regularly (before expected use or on a regular schedule) check that the channel is good and hasn't changed by calling llOpenRemoteDataChannel and comparing to the previous channel.
Examples
default { state_entry() { llOpenRemoteDataChannel(); } changed(integer c) { if(c & (CHANGED_REGION | CHANGED_TELEPORT)) llOpenRemoteDataChannel(); } remote_data( integer event_type, key channel, key message_id, string sender, integer idata, string sdata ) { if (event_type == REMOTE_DATA_CHANNEL) { // channel created } } }