Novidade: player invisível!

Há casos em que os players disponíveis podem não atender às suas necessidades e/ou não se encaixar bem no design do seu site. O player invisível serve justamente para isso — por sinal, o próprio site da J-Hero faz uso dele! Assim, você pode montar um player só para o seu site. Pedimos, no entanto, que deixe bem claro que a transmissão do player é da J-Hero para não haver confusões.

Atenção: Você precisa ter conhecimentos avançados de programação JavaScript para usufruir apropriadamente do player invisível, do contrário ele não servirá para nada.

Como usar o player invisível

O player expõe uma variável global chamada jhplayer, que contém toda a funcionalidade necessária para interagir com ele.

Propriedades

• jhplayer.playing — Se o player está tocando, true; caso contrário, false. Somente leitura.

• jhplayer.volume — Define o volume do player como um número de 0 a 1, sendo 1 o volume máximo.

• jhplayer.muted — Define se o player está silenciado (true) ou não (false).

• jhplayer.metadataSrc — URL de onde o player pega periodicamente os metadados (dados de DJ atual, programa atual, música atual etc.). Somente leitura.

Métodos

• jhplayer.play() — Dá play no player.

• jhplayer.pause() — Pausa o player.

• jhplayer.toggle(toggle) — Se o player está pausado, dá play; se estiver tocando, pausa. O parâmetro opcional toggle permite forçar play (se true) ou pausa (se false).

• jhplayer.fetchMetadata() — Força o player a atualizar metadados.

• jhplayer.on(events, callback) — Registra uma função callback a ser executada quando o(s) evento(s) especificado(s) em events acontecer(em) (separe-os com espaços). Mais informações em Eventos.

• jhplayer.off(events, callback) — Cancela o registro da função callback para o(s) evento(s) especificado(s) em events.

Eventos

A função jhplayer.on() permite registrar eventos, isto é, funções a serem executadas em determinados momentos do ciclo de vida do player. A função recebe como parâmetro um objeto com as propriedades type e detail, a primeira contendo o tipo do evento acionado e a segunda podendo conter dados adicionais específicos a tal evento.

• play — Ocorre quando o player começa a emitir som, o que geralmente é diferente de dar play.

• pause — Ocorre quando o player é pausado.

• buffering — Ocorre quando o player está recebendo dados do streaming, mas sem ainda emitir som.

• volumechange — Ocorre quando o volume do player muda.

• gotmetadata — Ocorre quando metadados são recebidos; detail passa a conter um objeto contendo os metadados recebidos.

• error — Ocorre quando o player dá erro; detail passa a conter um objeto Error.

• songprogress — Ocorre continuamente quando o player está tocando uma música da playlist; detail é o número de segundos tocados da música.

Este é o fim da documentação! Caso faça uso desta modalidade de player, não deixe de mostrar para nós como ficou a sua implementação!

Ah, sim: também é possível interagir com os players normais desta mesma forma, e incluir vários players na mesma página é perfeitamente possível: a interface de todos eles estará devidamente sincronizada.