Shortcode de Áudio


O recurso de Áudio permite que você incorpore arquivos de áudio e os reproduza usando um Shortcode simples. Isso foi adicionado a partir do WordPress 3.6 e é usado assim:

[ audio]

Nota: Não coloque espaço entre “[” e “audio”.

Você também pode usar embeds integrados e simplesmente colocar o arquivo de mídia em sua própria linha:

Meu conteúdo legal
http://my.mp3s.com/cool/songs/coolest.mp3
Mais conteúdo legal

Uso

Tenho um post antigo que tem um arquivo de áudio na Biblioteca de Mídia anexado a ele, e quero usar o novo shortcode:

[ audio]

Nota: Não coloque espaço entre “[” e “audio”.

Tenho a URL de um MP3, da Biblioteca de Mídia ou externo, que quero reproduzir:

Tenho uma URL de origem e fallbacks para outros tipos de arquivo suportados por HTML5:

Opções

As seguintes opções básicas são suportadas:

src
(string) (opcional) A origem do seu arquivo de áudio. Se não for incluída, será preenchida automaticamente com o primeiro arquivo de áudio anexado ao post. Você pode usar as seguintes opções para definir tipos de arquivo específicos, permitindo fallbacks graciosos:

  • ‘mp3’, ‘m4a’, ‘ogg’, ‘wav’, ‘wma’

Padrão: Primeiro arquivo de áudio anexado ao post

loop
(string) (opcional) Permite o loop da mídia.

  • “off” – Não repetir a mídia.
  • “on” – A mídia será repetida do início quando terminar e continuará tocando automaticamente.

Padrão: “off”

autoplay
(string) (opcional) Faz com que a mídia seja reproduzida automaticamente assim que o arquivo de mídia estiver pronto.

  • “off” – Não reproduzir a mídia automaticamente.
  • “on” – A mídia será reproduzida assim que estiver pronta.

Padrão: “off”

preload
(string) (opcional) Especifica se e como o áudio deve ser carregado quando a página carrega. O padrão é “none”

  • “none” – O áudio não deve ser carregado quando a página carrega.
  • “auto” – O áudio deve ser carregado inteiramente quando a página carrega.
  • “metadata” – Apenas metadados devem ser carregados quando a página carrega.

Padrão: “none”

Relacionados

Shortcodes do WordPress: vídeolegendaincorporargalerialista de reprodução

Changelog

  • Atualizado em 2021-10-18
    • Changelog adicionado
    • Corrigidos os links para as páginas do codex para os shortcodes de legenda, incorporar, galeria e lista de reprodução