Below is a list of options that can be used with the latest version of the XSPF MP3 Player
NOTE: You can use ONE or ALL of these options together at the same time but just remember to always start with the "?" character at the beginning only (right after xspf_player.swf in the HTML line ), then followed by the "&" character "option name" then "=" then the value you wish to use, "F3F3F3", "true", "false", "0", "1", etc.
NOTE: Options for the XSPF player can only go in two places and they must be exactly the same in both places (orange highlighted text in text box above). The top one is for Internet Explorer users, and the bottom one is for Firefox plus others. Again the HTML code above is only for MySpace profiles. But the basic rules of XSPF options still apply to all varients of the XSPF HTML code.
Parameters that can be used with THIS VERSION of the XSPF player
album : boolean value to manually disable album area, this is already done automatically when player is resized. alpha : boolean value from 0 - 100, representing how transparent the whole player will look, ghosting effect autoload : boolean value that make the playlist load without the initial user click autoplay : boolean value that make the playlist load and the music start without the initial user click autoresume : boolean value that automatically resumes playback of current track when the player is on many pages bg_color : change player's background color via hex color blend : Make player blend via Multiply or Overlay effect into background picture or color from user's site buffer : seconds to preload audio before playing, if option is off, the player is set to 2 seconds button_color : change player's button color via hex color counter : option for turning off time counter, best if used with Slim Mode gotoany : boolean value that forces travel to unknown URLs info_text : when a track contains a url to a website or music store, the user can change text of "Artist Info" to "Buy CD" etc. main_image : global image url, replaces all playlist images and uses this default parameter menu : disables ability to download tracks from player menu no_continue : boolean value to turn off automatic song changing player_title : the text to replace the players default's playlist_url : the url of the xspf file to load radio_mode : boolean value, if true tells the player that the last track of playlist is in real a new playlist location. more info repeat : boolean value to set repeat repeat_playlist : boolean value to repeat the playlist shuffle : boolean value to set shuffle song_title : the text to replace the players default's song_url : the url of the single mp3 you want to play start_track : track number for beginning track txt_color : change text color, may look funky with blend options activated volume_level : starting volume level, grading system is 1 to 50, with 50 being the Max volume
album
This parameter is used turn off the album area. This is automatically done when a user (via HTML) [see Player Sizes] alters the width or height of the player. If the player is greater than 389 pixels in height the album area will be removed without having to use this parameter, likewise if the player is shorter than 170 pixels in height, or if the player is smaller than 334 in width.
Possible Values:
&album=off
alpha
This parameter is used to adjust the opacity of the entire player. A few examples of opacity adjustment can be seen in the figures below.
Figure 2.1
In the example above, the player has an alpha value of 50 ( &alpha=50 ).
Figure 2.2
In the example above, the player has an alpha value of 50 ( &alpha=50 ) and has been
combined with the bg_color parameter and button_color parameter.
Possible Values:
&alpha=0 (the player will disappear completely)
anything between
&alpha=100 (the player can be seen completely)
autoload
This parameter is used make the playlist load without the initial user clicking on the play button.
Possible Values:
&autoload=1
autoplay
This parameter is used make the playlist load and play the first track in the loaded playlist, automatically.
Possible Values:
&autoplay=1
autoresume
This parameter is used make the player automatically continue playing (from whichever point in the song) if the player is placed on many pages within a site. Autoresume will remember everything such as paused position, repeat & shuffle status, track selected, etc. There will be a slight pause as the player buffers the song in between pages.
Possible Values:
&autoresume=1
bg_color
If you use bg_color by itself as an option, it will alter the button colors automatically to match the new background color. It will darken the text color, but my suggestion is, try using the txt_color option to create a better effect. The example code below shows where your hex color code option might go.
This parameter is used to make the player's skin blend into your pages background pattern, color, photo, etc. There are two options and they can't be used at the same time. The "blend effect " can be used with the bg_color, button_color, and alpha option to create some cool effects. Text colors might not look too good with these blend options (due to the way the player blends these colors). Mix the above color options at your own artistic risk.
Figure 2.3
In the example above, the player is using &blend=1.
Figure 2.4
In the example above, the player using &blend=2.
Possible Values:
&blend=1 (applies the multiply effect to player's skin)
&blend=2 (applies the overlay effect to player's skin)
buffer
This parameter can be used to adjust how much time (in seconds) the player should buffer the audio stream. Default is 0 seconds, but this parameter can go up to 60 seconds.
Possible Values:
&buffery=1
anything between
&buffer=60
button_color
The chart below shows just a fraction of the colors you can use with this player's buttons.
If you use button_color by itself as an option, it will only alter the player's button colors. It will not change text color or background color. The example code below shows where your hex color code option might go.
This parameter allows you disable the play time counter. A good example of when this might be used is if you choose to use the XSPF player in Mini Mode.
Fig 1.1
Notice that the scrolling text can hardly be seen.
Here is the same player with the "counter" option set to off
Fig 1.2
The scrolling text now has more room to be seen.
Possible Values:
&counter=off
gotoany
?
info_text
This parameter replaces the text "Artist Info" in the album cover/info area of the player. Instead of displaying the text "Artist Info" a user can replace it with "Buy CD","Purchase", "More Info", etc. Here is an example of this:
This option will turn off the last.fm image loader, it will disable automatic album cover images.
menu
This parameter is used to disable the right click menu download option. If you want to disable the right click menu completely just put this in the XSPF HTML code like so:
<param name="menu" value="false" />
Possible Values:
&menu=0 ( off )
no_continue
?
player_title
?
playlist_url
This parameter specifies the file the XSPF Mp3 Flash player should use to obtain the playlist data (artist name, song title, info, album cover, etc). This file can be a .xspf file, or a .php file.
The XSPF player above is using the txt_color parameter with a value of FF6600
( &txt_color=FF6600 ) in combination with bg_color.
If you use txt_color by itself as an option, it will only alter the player's text color. It will not change button color or background color. The example code below shows where your hex color code option might go.
