Difference between revisions of "LlGetParcelMusicURL"

From Second Life Wiki
Jump to navigation Jump to search
(added example)
m (and that gets us 1/3 of the way thru Category:LSL_Functions whee.)
 
(2 intermediate revisions by 2 users not shown)
Line 7: Line 7:
|func_desc|spec|caveats
|func_desc|spec|caveats
|examples=
|examples=
<lsl>
<source lang="lsl2">
string parcel_music_url()
string parcel_music_url()
{
{
Line 14: Line 14:
     if (parcelMusicURL != "")
     if (parcelMusicURL != "")
         return parcelMusicURL;
         return parcelMusicURL;
 
//  else
    return "Sorry, could not retrieve parcel's music URL.\n"
        return "Sorry, could not retrieve parcel's music URL.\n"
        + "You'll either need to be the land owner or able to deed me.";
            + "You'll either need to be the land owner or able to deed me.";


}
}
Line 28: Line 28:
     }
     }
}
}
</lsl>
</source>
|helpers|related|also
|helpers|related
|also_functions=
{{LSL DefineRow||[[llSetParcelMusicURL]]|Sets the music stream URL for the parcel object is on}}
|deepnotes=*With this function, music display boards can learn the URL that the parcel is tuned to.
|deepnotes=*With this function, music display boards can learn the URL that the parcel is tuned to.
|history=
|history=

Latest revision as of 01:27, 22 January 2015

Summary

Function: string llGetParcelMusicURL( );

Returns a string containing the parcel streaming audio URL.

The object owner must also be the land owner. If the land is deeded to a group the object will need to be deeded to the same group for this function to work.

Examples

string parcel_music_url()
{
    string parcelMusicURL = llGetParcelMusicURL();

    if (parcelMusicURL != "")
        return parcelMusicURL;
//  else
        return "Sorry, could not retrieve parcel's music URL.\n"
            + "You'll either need to be the land owner or able to deed me.";

}

default
{
    touch_start(integer num_detected)
    {
        // PUBLIC_CHANNEL has the integer value 0
        llSay(PUBLIC_CHANNEL, parcel_music_url() );
    }
}

See Also

Functions

•  llSetParcelMusicURL Sets the music stream URL for the parcel object is on

Deep Notes

  • With this function, music display boards can learn the URL that the parcel is tuned to.

History

  • Suggested: SCR-31
  • Server release notes for 11.12.03.246118 on the main channel indicate that this function was added. Testing on the main release on 19-Dec-2011 has this function compiling without error but the output is empty.
  • Tests OK on main channel as of January 22 2012

Signature

function string llGetParcelMusicURL();