llParcelMediaCommandList

From Second Life Wiki
Jump to navigation Jump to search

Summary

Function: llParcelMediaCommandList( list commandList );

Controls the playback of movies and other multimedia resources on a parcel or for an agent.

• list commandList A list of integer PARCEL_MEDIA_COMMAND_* flags and their parameters

Constant Parameter Description
0 PARCEL_MEDIA_COMMAND_STOP Stop the media stream and go back to the first frame.
1 PARCEL_MEDIA_COMMAND_PAUSE Pause the media stream (stop playing but stay on current frame).
2 PARCEL_MEDIA_COMMAND_PLAY Start the media stream playing from the current frame and stop when the end is reached.
3 PARCEL_MEDIA_COMMAND_LOOP Start the media stream playing from the current frame. When the end is reached, loop to the beginning and continue.
4 PARCEL_MEDIA_COMMAND_TEXTURE key uuid Used to get or set the parcel's media texture.
5 PARCEL_MEDIA_COMMAND_URL string url Used to get or set the parcel's media url.
6 PARCEL_MEDIA_COMMAND_TIME float time Move a media stream to a specific time in (floating point) seconds.
7 PARCEL_MEDIA_COMMAND_AGENT key uuid Applies the media command to the specified agent only.
8 PARCEL_MEDIA_COMMAND_UNLOAD Used to unload the movie and restores the original texture.
9 PARCEL_MEDIA_COMMAND_AUTO_ALIGN integer boolean Used to set the parcel option 'Auto scale content'.
10 PARCEL_MEDIA_COMMAND_TYPE string mime_type Used to get or set the parcel media MIME type (e.g. "text/html"). (1.19.1 RC0 or later)
11 PARCEL_MEDIA_COMMAND_SIZE integer x, integer y Used to get or set the parcel media pixel resolution. (1.19.1 RC0 or later)
12 PARCEL_MEDIA_COMMAND_DESC string desc Used to get or set the parcel media description. (1.19.1 RC0 or later)
13 PARCEL_MEDIA_COMMAND_LOOP_SET float loop Used to get or set the parcel's media loop duration. (1.19.1 RC0 or later)

Caveats

  • This function causes the script to sleep for 2.0 seconds.
  • This script's object must be owned by the landowner or the function will silently fail.
  • If the script's object is over group owned land, then the object must be deeded to that group.
  • If the PARCEL_MEDIA_COMMAND_URL value is greater than 254 characters, the command will silently fail.
  • If using PARCEL_MEDIA_COMMAND_URL and PARCEL_MEDIA_COMMAND_AGENT, make sure the Media URL in the About Land ... dialog is unset. See SVC-4478.

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   Using PARCEL_MEDIA_COMMAND_AGENT with llParcelMediaCommandList() when parcel's media URL is set causes previous video replay

Examples

key myTexture = llGetTexture(0);
llParcelMediaCommandList([PARCEL_MEDIA_COMMAND_TEXTURE,myTexture,PARCEL_MEDIA_COMMAND_PLAY]);

See Also

Functions

•  llParcelMediaQuery
•  llSetTextureAnim
•  llSetTexture

Deep Notes

All Issues

~ Search JIRA for related Issues
   Setting parcel media for a single agent was broken with new media functionality in release candidates of 1.19.1
   Using PARCEL_MEDIA_COMMAND_AGENT with llParcelMediaCommandList() when parcel's media URL is set causes previous video replay

Signature

function void llParcelMediaCommandList( list commandList );