BuckyRadio-3.0

[the Radio was updated to 3.1.1 November 21st, 2009]

Introduction

BuckyRadio 3.1.1 is an audio stream tuner for SecondLife. This version is a formal reintroduction of the radio. The update picks up some of the ideas I have used in WebMon, VidMon, and Slider.

Configuring and Using BuckyRadio

  1. Add stations to notecard
  2. Handle any permissions issues (group deeding)
  3. Using Menu Items
    1. The Help Submenu
  4. Prims for Previous and Next
  5. The Picture Prim
  6. Chat Commands
  7. Other Configuration Capabilities
    1. HoverText
    2. Labels
    3. Giving A Folder Of Notes
    4. Giving A Copy Of Your Stations

BuckyRadio gives a menu of internet audio streams. The menu enables easy browsing and picking from many stations. It is also easy to search for one, based on name or link.

BuckyRadio is configured by editing the “stations” notecard in the inventory of the object.

1. Add stations to notecard

The format for adding stations to BuckyRadio is:

Some Description = http://someaddress

example:

SomaFM Groove Salad = http://207.200.96.228:8076

Note: You need to use the address that resolves to an audio url. Pointing at a web page which happens to contain a playlist (among many other things) will not work. One strategy is to use iTunes to look at the playlist – do a Get Info on the stream, and look at the URL (in the Summary tab).

2. Handle any permissions issues (group deeding)

Upon rezzing or resetting BuckyRadio, you may get this message:

BuckyRadio 3.0:
You may need to deed this radio to group owned land.
You can do one of three things:
1) ignore this message, you already have a deeded tuner ...
2) ... or deed the BuckyRadio object itself to the group that owns this land ...
3) ... or use the Help menu to rez a tuner object, and deed that

If you dont see this message, you can skip the rest of this section.

The gist of this is: Group Owned Land in Second Life can require objects to be deeded to a specific group, so that the object can change audio or video streams.

BuckyRadio can deal with this in three ways:

  1. talk to an existing BuckyRadioTuner object within the same sim
  2. be deeded as a group object
  3. rez a separate tuner object that can be deeded to the group

Options 1 and 3 are the same idea: BuckyRadio automatically talks to an object in the same sim, which does the actual setting of an audio stream. This allows BuckyRadio itself to be free for editing by people who are not in the same group as the parcel. It also allows a single radio to set the audio stream for several parcels in a sim at the same time (wherever there is a tuner).

Explaining the ins and outs of group membership and deeding is beyond the scope of this document. The gist of it is: you want to set the object to the group that owns the parcel, share it with group, and deed it:

vp-deed.jpg

If you are unsure about this step, you should call upon the parcel owner or group admin to help. Do not forget to thank them!

[The quick thing to note is that you do not have to deed the radio itself. The help menu has an option for rezzing a tuner that gets deeded, and you can put these on more than one parcel (even different groups), and they will all respond to a single radio]

3. Using Menu Items

Here is another look at the default menu:

buckyradio-menu

br-help-menu1

We’ll do a chat command to search for stations with “jazz”:

/77 s jazz

And we get:

br-search11

Note that the user is given instruction on how to go directly to the site via a chat command (one case: “/77 12″)

3.1 The Help Submenu

Pressing the Help button on the main menu (or entering the chat command “/77 Help”) will bring up the Help submenu. It looks like this:

br-help-menu2

4. Prims for Previous and Next

A BuckyRadio can be as simple as one prim. You can link other prims to it with specific names which can add functionality.

Two prims with specific names will allow the user to go forwards and backwards in the list of stations, one at a time:

The buttons may be completely transparent, so that some texture of a UI (such as a nice set of arrows) can be visible.

5. The Picture Prim

As is the case with PrevButton and NextButton, one can link a prim named “Picture”.

The picture prim can change its texture on a per station basis.

The current texture is controlled by matching a station label or position (such as “Secret Agent” or “2”) in the stations notecard with a texture name in the BuckyRadio inventory.

In other words, for station #2, the texture named “2” will be displayed on the “Picture” prim when you select station #2.

You can also use the name of the station. If you call it “Secret Agent” in the stations notecard, and you have a texture named “Secret Agent”, it will display on the “Picture” prim when that station is selected.

If you have a texture named “BG.DEFAULT”, it will be shown on the “Picture” prim whenever there is no match between the current station and a texture name. This allows you to have a default texture (or, you could use a completely transparent tetxure to hide the “Picture” prim when you dont want to show it)

Try to avoid using “+” in a texture name. There may be some future BuckyRadio functionality that will use texture names in the same manner as my Slider object. No promises, but I would like to reserve that character as a flag for many possible capabilities.

A future version of BuckyRadio may use a prim named “Video”. Consider it to be reserved.

6. Chat Commands

BuckyRadio uses chat channel 77 to listen for one of many different chat commands.


7. Other Configuration Capabilities

This section goes into more detail about how the configuration notecard (anything that starts with “stations”) can be used. There is also a mention of how the description field can be used to set descriptive text above the screen.

7.1 – Hovertext

There are two means of adding a floating title to the BuckyRadio object:

  1. Change the object description
  2. Use the titleText option in the urls notecard

Changing the object description looks like this example:
br-description-example12

Note that you can use “\n” to display multiple lines of text.

The other means of setting title text is to use the “titleText” option in the urls notecard. That looks like:

titleText =  My Internet\nRadio Rocks

You also have control over text color, by using “titleColor” to specify the RGB colors:

titleColor = <0,0,255>

Another item you can set is the transparency, via “titleAlpha”:

titleAlpha = 0.9

note that 0 is fully transparent, and 1.0 is opaque. The example is at 90%.

You may not want any floating text. There are a couple of ways of doing away with it:

7.2 Labels

The buttons in the dialog can be changed. You may have a different way of saying “Notes!”, or may want to translate entirely. Here is a sample dialog:

buckyradio-menu

Note the top two rows of buttons. They may all be changed.

A sample change in the urls notecard:

buttonNext =  Forward
buttonPrev = Backward
buttonSearch = Find
buttonGetLinks = Give
buttonNotes = Notes
buttonHelp = Huh?!

Results in:

br-menu-change2

The numbered buttons always correspond to a web address above.

7.3 Giving A Folder Of Notes

You can put one or more notecards into inventory, to be given out when the user clicks on “GiveNotes” (or however you label that button via “buttonNotes”).

For each note to be given out, the name should start with “NOTE.”:

NOTE.example
The user will be given a folder containing the note(s). You can control the name of the folder via the “folderName” option in the urls notecard:

folderName = Some Stations From BuckyRadio

7.4 Giving A Copy Of Your Links

Giving out the stations file simply provides a means for the user to benefit from your collection of stations for some BuckyRadio object. They can certainly see all of your stations by searching on a colon ‘:’ — giving them the actual notecard makes it a little easier to dispense the same information.

To enable this button, put a comment line anywhere in the urls notecard.

# a comment line starts with a hash mark (an octothorpe, or pound sign)
Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: