Packagesekati.ui
Classpublic class MP3Player
InheritanceMP3Player Inheritance AbstractMediaPlayer Inheritance LiquidSprite Inheritance CoreSprite Inheritance flash.display.Sprite

MP3Player provides playback control interface logic to be used with sekati.media.MP3.

To implement pass references to UI controller instances to the MP3Player constructor & instantiate the MP3Player instance.


Example
  var player : MP3Player = new MP3Player( playBtn, progressBar, bufferBar, gutterBar, volumeBtn );
  player.init( 'path/to/my.mp3' );
  

See also

sekati.media.MP3
sekati.events.MediaEvent


Public Properties
 PropertyDefined by
  audio : MP3
[read-only] The MP3 being played.
MP3Player
 InheritedbufferBarPercent : Number
Buffer bar scale percent (0-1).
AbstractMediaPlayer
  currentID3 : Object
[read-only] Returns reference to current ID3 data object.
MP3Player
 Inheritedenabled : Boolean
Enabled property defines whether liquid eventing is available or not.
LiquidSprite
 InheritedinteractiveMode : Boolean
Specifies the mouse cursors modal state in the object as an interactive target via: buttonMode, mouseChildren & tabChildren.
CoreSprite
 Inheritedmedia : IProgressiveMedia
The IProgressiveMedia being played.
AbstractMediaPlayer
 InheritedprogressBarPercent : Number
Progress bar scale percent (0-1).
AbstractMediaPlayer
 Inheritedscale : Number
The scale value.
CoreSprite
  sound : Sound
[read-only] The Sound instance.
MP3Player
Protected Properties
 PropertyDefined by
 Inherited_bufferBar : Sprite
AbstractMediaPlayer
  _defaultPan : Number
MP3Player
  _defaultVolume : Number
MP3Player
 Inherited_gutterBar : Sprite
AbstractMediaPlayer
  _id3 : Object
MP3Player
 Inherited_isBufferPaused : Boolean
AbstractMediaPlayer
 Inherited_isDrag : Boolean
AbstractMediaPlayer
 Inherited_isSeeking : Boolean
AbstractMediaPlayer
 Inherited_media : IProgressiveMedia
AbstractMediaPlayer
 Inherited_playBtn : MovieClip
AbstractMediaPlayer
 Inherited_progressBar : Sprite
AbstractMediaPlayer
 Inherited_volumeBtn : Sprite
AbstractMediaPlayer
 Inherited_wasPlaying : Boolean
AbstractMediaPlayer
Public Methods
 MethodDefined by
  
MP3Player(playBtn:MovieClip, progressBar:Sprite, bufferBar:Sprite, gutterBar:Sprite, volumeBtn:Sprite, volume:Number = 1, pan:Number = 0)
MP3Player Constructor
MP3Player
 Inherited
addChildren(... args):void
Add multiple child DisplayObject's.
CoreSprite
 Inherited
destroy():void
Clean up after thy self.
AbstractMediaPlayer
  
init(url:String, buffer:uint = 4):void
load audio and initialize MP3Player UI and MP3.
MP3Player
 Inherited
pause():void
Pause playback
AbstractMediaPlayer
 Inherited
remove():void
Remove the IProgressiveMedia from player.
AbstractMediaPlayer
 Inherited
reset():void
Reset the interface.
AbstractMediaPlayer
 Inherited
resume():void
Resume playback
AbstractMediaPlayer
 Inherited
setVolume(percent:Number):void
Core video volume driver.
AbstractMediaPlayer
 Inherited
toString():String
Return reflective output.
CoreSprite
Protected Methods
 MethodDefined by
  
Add MediaEvent.PROGRESS & other IProgressiveMedia events.
MP3Player
 Inherited
Add UI listers.
AbstractMediaPlayer
 Inherited
bufferBarDown(e:MouseEvent):void
_bufferBar pressed: being seeking.
AbstractMediaPlayer
 Inherited
bufferBarMove(e:MouseEvent):void
_bufferBar scrubbing: seek.
AbstractMediaPlayer
 Inherited
bufferBarUp(e:MouseEvent):void
_bufferBar released: stop seeking.
AbstractMediaPlayer
 Inherited
When playhead enters area that needs buffering, pause the IProgressiveMedia if playing.
AbstractMediaPlayer
 Inherited
When IProgressiveMedia has finished buffering check to see if media was paused to allow for buffering if it was restart, if not, do nothing.
AbstractMediaPlayer
 Inherited
configListeners(isAdd:Boolean = false):void
Event listener management.
LiquidSprite
  
createMedia():void
Instantiate IProgressiveMedia (stub).
MP3Player
 Inherited
fullscreen(e:StageEvent = null):void
Stub: fires when StageDisplay dispatches a FULLSCREEN event.
LiquidSprite
 Inherited
invalidate():void
Request a redraw, use for deferred rendering.
CoreSprite
 Inherited
offStage(e:Event = null):void
Stub: Sprite has been removed from stage.
LiquidSprite
 Inherited
onStage(e:Event = null):void
Stub: Sprite has been added to stage.
LiquidSprite
 Inherited
pauseMemory():void
Pause video in memory and track state.
AbstractMediaPlayer
 Inherited
playBtnClick(e:MouseEvent = null):void
Toggle the framed _playBtn icon and pause/resume playback.
AbstractMediaPlayer
 Inherited
Handle MediaEvent.PROGRESS event: update the buffer and progress bars.
AbstractMediaPlayer
  
Remove MediaEvent.PROGRESS & other IProgressiveMedia events.
MP3Player
 Inherited
Remove UI listers.
AbstractMediaPlayer
 Inherited
resize(e:StageEvent = null):void
Stub: fires when StageDisplay dispatches a RESIZE event.
AbstractMediaPlayer
 Inherited
resizeComplete(e:StageEvent = null):void
Stub: fires when StageDisplay dispatches a RESIZE_COMPLETE event.
LiquidSprite
 Inherited
resumeMemory():void
Resume video from member and release state.
AbstractMediaPlayer
 Inherited
seekUI():void
Use guttBar to prevent seek offset inaccuracy while still buffering.
AbstractMediaPlayer
 Inherited
setPauseIcon():void
Set the _playBtn icon "paused".
AbstractMediaPlayer
 Inherited
setPlayIcon():void
Set the _playBtn icon "played".
AbstractMediaPlayer
  
Handle & re-dispatch the MediaEvent status events (since AbstractMediaPlayer subclasses have the option of being added to stage and bubbling these events unlike IProgressiveMedia classes).
MP3Player
 Inherited
volumeBtnDown(e:MouseEvent):void
_volumeBtn pressed: begin volume control.
AbstractMediaPlayer
 Inherited
volumeBtnMove(e:MouseEvent):void
_volumeBtn scrubbing: change volume.
AbstractMediaPlayer
 Inherited
volumeBtnUp(e:MouseEvent):void
_volumeBtn released: end volume control.
AbstractMediaPlayer
Property detail
audioproperty
audio:MP3  [read-only]

The MP3 being played.

Implementation
    public function get audio():MP3
currentID3property 
currentID3:Object  [read-only]

Returns reference to current ID3 data object.

Implementation
    public function get currentID3():Object
_defaultPanproperty 
protected var _defaultPan:Number
_defaultVolumeproperty 
protected var _defaultVolume:Number
_id3property 
protected var _id3:Object
soundproperty 
sound:Sound  [read-only]

The Sound instance.

Implementation
    public function get sound():Sound
Constructor detail
MP3Player()constructor
public function MP3Player(playBtn:MovieClip, progressBar:Sprite, bufferBar:Sprite, gutterBar:Sprite, volumeBtn:Sprite, volume:Number = 1, pan:Number = 0)

MP3Player Constructor

Parameters
playBtn:MovieClip — reference to play UI control.
 
progressBar:Sprite — reference to progress UI to control.
 
bufferBar:Sprite — reference to buffer UI control.
 
gutterBar:Sprite — reference to gutter UI to control.
 
volumeBtn:Sprite — reference to volume UI to control.
 
volume:Number (default = 1) — of the audio (0 - 1).
 
pan:Number (default = 0) — of the audio(0 = balanced, -1 = left, 1 = right).
Method detail
addMediaListeners()method
protected override function addMediaListeners():void

Add MediaEvent.PROGRESS & other IProgressiveMedia events.

createMedia()method 
protected override function createMedia():void

Instantiate IProgressiveMedia (stub).

init()method 
public override function init(url:String, buffer:uint = 4):void

load audio and initialize MP3Player UI and MP3.

Parameters
url:String — of mp3 file.
 
buffer:uint (default = 4) — in seconds.
removeMediaListeners()method 
protected override function removeMediaListeners():void

Remove MediaEvent.PROGRESS & other IProgressiveMedia events.

statusHandler()method 
protected override function statusHandler(e:MediaEvent):void

Handle & re-dispatch the MediaEvent status events (since AbstractMediaPlayer subclasses have the option of being added to stage and bubbling these events unlike IProgressiveMedia classes).

It is best to implement your own switch/case subclass code for granular event responses.

Parameters
e:MediaEvent