Stores contextual cache data in the SCI stack that will be sent in any future BIOS_SCI_STARTED call until the program is terminated.
By default, the cache value is a random UUID for each program invocation on the SCI stack. Programs can use this system call to overwrite the cache value with up to 64 characters of custom data, if desired.
This data should be used by programs attempting to be multi-context aware by detecting two different cache values for different invocations by the SCI in the stack. See BIOS_SCI_MULTI and the SCI documentation for more information on mutli-context aware programs.
This system call should only be used by multi-context aware programs. It should not generally be used by programs that do not send BIOS_SCI_MULTI, and it cannot be used for services or libraries.
llMessageLinked(LINK_ROOT, 0, "BIOS_SCI_CACHE", [script_name] + "|" + [cache_data]);
| • target | LINK_ROOT |
| • integer | n/a |
| • key | [script_name]|[cache_data] |
| Parameter | Description |
|---|---|
[script_name] |
String. Must be a blank string, or the name of the LSL script in inventory to store the cache data for. If a blank string is used, the cache for the currently running program will be modified. This is most likely the behavior you want. If the name of a program LSL script suspended in the background is used, the cache for that program will be modified. This will only modify the cache for the first instance of the program in the stack. |
[cache_data] |
String. Must be a string up to 64 characters to store in cache. By default, the cache data is a random UUID generated for each program instance on the stack and is sent in the first BIOS_SCI_STARTED call for each time the script is started at a new position on the stack. If the program is restarted from a suspended background instance, BIOS_SCI_STARTED will resend the cache data for that instance. The BIOS_SCI_CACHE call overwrites the UUID (or whatever other custom data has been entered) with new custom data if the program prefers to store a different instance identifier or some additional data for that instance. |