Table des matières

• Presentation
  • Why an other flash plugin ?
  • Future dev
• Download
• User documentation
  • Some screen shots
  • To use
  • Configuration
    • Definitions
    • Color
    • Size
    • URLSecret
• Developper documentation
  • Introduction
  • The content of zip file
  • To compile

Presentation

Why an other flash plugin ?

• OpenSource : when you get the applet you get the source, you can modify it and include new functions

• You can change by a XML file the color and size of the applet. You can use it with the color of your website

• The applet is designed to read MP3 or FLV file (FLV is a video format from Adobe, and you can transform mpeg or avi file in FLV by OpenSource other programs)

• the applet is designed without any bitmap you can change size without any problem

• you can play only 60 sec or 2 mn of a mp3 or FLV file

• you don't need any flash server, the files are loaded from url

Future dev

Multiplayer flash applet is designed to be include in Tikiwiki opensource CMS.

I plan to make theses developpement :

- allow to record a message with microphone to present yourselft on a page (to be ported on tikiwiki CMS)

- allow to record a video clip with webcam to present yourselft on a page (to be ported on tikiwiki CMS)

Download

You can download the last release of multiplayer in swf (flash) format here

Inside the zip file you have to get :

• multiplayer.swf
• multiplayer.xml

In src directory you have the sources of flash applet in haxe language

User documentation

Some screen shots

To use

• copy the multiplayer.swf in your flash directory on http server
• copy the multiplayer.xml in the same directory

Load the flash with arg : multiplayer.swf?URL=file.mp3

Configuration

Definitions

The configuration is given by an simple xml file :


<interface name="default">
<Color>
<ProgressBarPlay>0xFF8D41</ProgressBarPlay>
<ProgressBarLoad>0xA7A7A7</ProgressBarLoad>
<ProgressBarButton>0xFF0000</ProgressBarButton>
<ProgressBar>0xC3C3C3</ProgressBar>
<VolumeOn>0x21AC2A</VolumeOn>
<VolumeOff>0x8EFF8A</VolumeOff>
<VolumeButton>0</VolumeButton>
<Button>0x555555</Button>
<ButtonPressed>0xFF00FF</ButtonPressed>
<ButtonOver>0xB3B3B3</ButtonOver>
<ButtonInfo>#C3C3C3</ButtonInfo>
<ButtonInfoPressed>0x555555</ButtonInfoPressed>
<ButtonInfoOver>0xFF8D41</ButtonInfoOver>
<ButtonInfoText>0xFFFFFF</ButtonInfoText>
<ID3>0x6CDCEB</ID3>
<PlayTime>0x00FF00</PlayTime>
<TotalTime>0xFF2020</TotalTime>
<PanelDisplay>0x555555</PanelDisplay>
<AlertMesg>0x00FFFF</AlertMesg>
</Color>
<Value>
<PreloadDelay>4</PreloadDelay>
</Value>
</interface>
<interface name="Black">
<Color>
<ProgressBarPlay>0xFFFFFF</ProgressBarPlay>
</Color>
<Text>
<URLAppend>http://www.lesjetesdelencre.com/tiki-download_file.php?fileId=</URLAppend>
<LimitedMsg>You are limited to 1 minute. Please visit the artist site if you love him!</LimitedMsg>
</Text>
<Value>
<MaxPlay>60</MaxPlay>
</Value>
</interface>

You can have many definitions of interface. Only default is used

You have three types of records :

• Color : to customize the colors
• Value : to change sizes and values
• Text : change text values

Color

Color define in Hexadecimal notation (OxFFFFFF is white) some colors :

• ProgressBarPlay
• ProgressBarLoad
• ProgressBarButton
• ProgressBar
• VolumeOn
• VolumeOff
• VolumeButton
• Button
• ButtonPressed
• ButtonOver
• ButtonInfo : is the color of the button named i displayed when ID3 tags are detected in the mp3 file
• ButtonInfoPressed : color of the button when it is pressed
• ButtonInfoOver: color of the same button when the mouse is over
• ButtonInfoText : color "i" symbol on the button
• D3 : color of ID3 informations
• PlayTime : color of counter in h mn sec
• TotalTime : color of total time
• PanelDisplay : color of the background of pannel
• AlertMesg : color of alert messages

Size

• PreloadDelay : a delay to preload file before playing in second
• MaxPlay : max time allowed to play a song (for demo mp3)

URLSecret

• URLAppend : a string appened to all the URL.
• LimitedMsg : a message to display when Max play time is played

Exemple multiplayer.swf?URL=4

with URLAppend=http://site.com/wiki/flash=

will load http://site.com/wiki/flash=4

Developper documentation

Introduction

The applet is developped with Haxe a langage to produce flash or Ajax or client servers applications. The applet run with flash9 reader.

The content of zip file

In the zip file you will find :

• license.txt : licence file. The Applet is in LGPL
• versions.txt : list of all the version and changelog
• Player.hx : the main program
• compile.hxml : the compilation program
• ignu/MediaButton.hx : the design of buttons (stop and start button)
• ignu/Slider.hx : the slider mecanism in a class
• ignu/PanelText.hx : class to display text in the panel

To compile

To compile the player.hx program, you need to have haxe installed. Haxe is an open source language, it is for me the main revolution since Perl.

On the Haxe site you will find a free compiler for MacOS, Linux and Windows and good installers.

When haxe is installed type :

---