Uma poderosa e leve Classe AS3 para MP3Player

Versão: 2.0
Data de publicação: 25/08/2009
Bugfix: Barras de Progresso / Novos Getters


Você precisa fazer o download do Flash Player para visualizar este conteúdo.

Uma poderosa e leve Classe AS3 para MP3Player que inclui:

  • Controle total de reprodução (play, pause, stop, anterior, próximo, volume, repeat, shuffling, first, last)
  • Informação completa de tempo (tempo decorrido, tempo total, barra de progresso, barra de procura)
  • Suporta informação ID3(nome do artista e da música)
  • Suporta formatação da Playlist padrão e Playlist personalizada
  • Suporte controle de Eventos e muito mais

Novos Métodos

  • toggleMute()
  • toggleRepeating()
  • toggleShuffling()
  • last()
  • first()
  • e muitos outros

Novas propriedades

  • getActualTimeNumber
  • getActualTimeString
  • getArtistName
  • getBytesLoaded
  • getExecutionPercentage
  • getStatus
  • e muitos outros

Adição da Nova Classe: MP3EVENT

Com a adição da nova classe é possível estabelecer ações para eventos disparados pela classe, como por exemplo ao selecionar uma música na playlist ou ao repetir uma música, ao resumir, são vários eventos:

  • ON_PLAY
  • ON_PAUSE
  • ON_RESUME
  • ON_STOP
  • ON_REPEAT
  • ON_SHUFFLE
  • ON_NEXT
  • ON_PREVIOUS
  • e muitos outros

O formato da playlist continua o mesmo, o que diminui em muito a necessidade de modifcação do código antigo, usado na mp3lite 1.x.

Ao mesmo tempo, com a adição dos novos métodos e eventos é possível inserir mais e mais informações na sua playlist e tornar o player cada vez mais poderoso.

Novo formato e nova documentação

Agora a classe conta com um novo formato e uma nova documentação.
Seguindo os padrões adotados por developers em todo mundo a classe agora pertence a um pacote:
br.ederlima

Utilizando a Mp3Lite

Então, o método básico para fazer funcionar a Mp3Lite 2 agora é:

import br.ederlima.Mp3Lite;
var myplayer:Mp3Lite = new Mp3Lite();
myplayer.setXMLList("myplaylist.xml");
myplayer.start();

Adicionando eventos

import br.ederlima.Mp3Lite;
import br.ederlima.Mp3Event;
var player:Mp3Lite = new Mp3Lite();
player.setXMLList("playlist.xml");
player.addEventListener(Mp3Event.ON_START,  myStartFunction);
player.start(5, 2000); //inicia da sexta música da playlist com buffertime de 2 segundos
function myStartFunction(e:Mp3Event):void
{
trace("player has started");
}

Tocando uma música única

import br.ederlima.Mp3Lite;
import br.ederlima.Mp3Event;
var player:Mp3Lite = new Mp3Lite();
player.uniqueSound("mysound.mp3");
player.addEventListener(Mp3Event.ON_START,  myStartFunction);
player.start(0, 2000); //inicia a reprodução com buffertime de 2 segundos
function myStartFunction(e:Mp3Event):void
{
trace("player has started");
}

Layout XML

<?xml version="1.0" encoding="utf-8" ?>
<mp3list>
<songs>
<song url="song.mp3" name="Song Name"></song>
<song url="othersong.mp3" name="Song Name"></song>
</songs>
</mp3list>

Observação importante, sobre fontes e playlist
Quando utilizado o método setPlaylist é necessário adicionar a fonte utilizada na biblioteca, para permitir que o flash compile a fonte, uma vez que essa playlist é configurada com embedFonts via as.
Para adicionar a fonte a biblioteca, pressione f11 e com o botão direito escolhe “New Font”, em seguida selecione a Fonte e configure os nomes de exibição conforme utilizados na variável do tipo TextFormat.
Exemplo:
Fonte na biblioteca

E ainda no padrão mundialmente adotado, a classe possui documentação no formato ASDoc, o que facilita em muito a consulta e uso da Classe.

PARA LER A DOCUMENTAÇÃO, CLIQUE AQUI

Agora é muito mais fácil e versátil utilizar a Mp3Lite.

Em breve a versão 3.0 com ainda mais adições de métodos e funcionalidades.
Em breve a documentação em inglês.

;)