XML MP3000 documentation
 
 
UPDATE

The help documentation will be updated and improved with customer feedback.

* Before starting, check to see if you should download the latest readme.htm file from the server and replace this one (version on right top)
* Check the latest FAQ, tips and help topics on the FORUM

> TOP <

 
Quick Start

When you receive the product you will receive a .zip file. The zip file will contain the following files

  • XML_MP3000_large.fla
    XML_MP3000_small.fla
    XML_MP3000_medium.fla
    XML_MP3000_micro.fla
    XML_MP3000_minimal1a.fla
    XML_MP3000_minimal1b.fla
    XML_MP3000_minimal2.fla
  • swf files of same file names as above
  • music.xml
  • /classes/player.as
  • Readme.htm
  • /caurina/
  • life-is-creative-patrick-jansen.mp3

Do the following steps to start using XML MP3000 ;

  1. Unzip the .zip file
  2. Open Flash CS3
  3. Open any of the MP3000 .fla files
  4. copy he MP3000 .fla Library contents to your .fla Library
  5. copy the component from the MP3000 .fla stage to your own .fla file
  6. In the unzipped directory (folder), copy the /classes/ folder and /caurina/ folder and music.xml to the directory (folder) of your own .fla file
  7. In your .fla select the XML MP3000 component on stage and open [Component Inspector], make changes to parameters if you need (see Parameters section in this Readme.
  8. Make changes to the Component library items and change it's assets to create the visual you like.
  9. Change the music.xml to the tracks you want it to play

> TOP <

 
Component Parameters.
When you place the XML MP3000 component on stage, you will have a number of parameters you can modify to suit the menu to your needs. Below are detailed explanations about what every parameter does or customizes.

xmlmusicdatafile
The name of the .xml file. The component i will include a sample "music.xml" file which you can use as startpoint or template for your own .xml file. In this xml file you define which song/tracks the player will load.

addprogress
If set to true, a progress bar will be added to the player

addtime
If set to true, a time display will be added to the player

addtitledisplay
If set to true, a moving title display will be added to the player

addlist
If set to true, a scrollable music/track list will be added to the player

addspectrum
If set to true, a sound spectrum animation will be added to the player

autonext
If set to true, when finishing a track/song it will automatically go to the next song in the list. If set to false, it will keep repeating the current track

spoolspeed
Speed of rewinding or fastforward-ing a track

manualfont_time
Use a manual (embed) font fo the time display.

internfont_time_pixelfonttype
If manualfont_time set to false, select 1for pixelfont and 0 for dottet font to be used for text characters in the time display

title_add_album
If set to true, the album name will be added to the scrolling title display track title text

title_add_artist
If set to true, the artist name will be added to the scrolling title display track title text

manualfont_title
Use a manual (embed) font fo the scrolling title display

internfont_title_pixelfonttype
If manualfont_time set to false, select 1for pixelfont and 0 for dottet font to be used for text characters in the scolling title display

spectrumtype
Animation type for the sound spectrum, from 1 to 12

spectrumfr
Visual strength of the spectrum animation.

addspectrumbuttonst
If set to true, 12 spectrum change buttons will be added to the spectrum animation in the player

dorandomspectrum
If set to true, the player will randomly choose a spectrum animation type for each song

listmaintype
What to display in the "main" items in the track list. These are intended for category (artist/album) seperation. These are "divider" items
// 0 = show album and artist
// 1 = show album
// 2 = show artist

listsubtype
What to display in the not-"main" items in the track list. These are the actual song listings.
// 0 = show title and album and artist
// 1 = show title and album
// 2 = show title and artist

showlistheader
Show the texts "title", "album" and "artist" in the song list header, (which purpose is to drag the song list around on stage)

startvolume
Between 0 and 1, the start volume for the player to start with.

spectrumXscale
Horizontal scale of the spectrum animation, will include rescaling of he 12 buttons

spectrumYscale
Vertical scale of the spectrum animation, will include rescaling of he 12 buttons


> TOP <

 
Overriding specific properties of xml node entries

Item options
The following tag can be included into xml <musicitem> nodes

  • main="true" (only include this to make a listitem a "divider" listmaintype item)

The following nodes can be included into xml <musicitem> node.

  • <itemname> (filename of the mp3 file)
  • <title> (name of title which wil appear in player)
  • <artist> (name of artist which wil appear in player)
  • <album> (name of ablbum which wil appear in player)
  • <link> (html link of the icon next to items in the music list)
  • <startpoint> (point where to start the track - format minutes - seconds - miliseconds split by "dots")
  • <endpoint> (point where to stop the track - format minutes - seconds - miliseconds split by "dots")

> TOP <