View source for PT-BR/getSoundMetaTags

__NOTOC__ 
{{PT-BR/Client_function}}
Essa função retorna os metadados de um elemento de [[sound|áudio]]. Os metadados são informações como o título ou autor.

{{Note| Essa função não funciona com arquivos WAV remotos.}}
{{Note|Se nenhuma informação estiver associada à um metadado, ele não será incluso na [[table|tabela]] de resultados.}}

==Sintaxe== 
<syntaxhighlight lang="lua">table getSoundMetaTags ( element audio [, string tag = "" ] )</syntaxhighlight> 

{{BR/OOP||[[sound|audio]]:getMetaTags}}

===Argumentos necessários=== 
*'''audio:''' um elemento de [[sound|áudio]].

===Argumentos opicionais=== 
{{BR/ArgOpcional}} 
*'''tag:''' uma [[string]] que indica a tag a ser retornada.

===Retorno===
* Retorna uma [[table|tabela]] com todos os metadados disponíveis.
* Retorna uma [[string]] contendo a informação do metadado caso '''tag''' for especificado.
* Retorna ''false'' caso algo deu errado ou a '''tag''' especificada não contém nenhuma informação.

===Tags de metadados===
{{Sound_Meta_Tags}}

==Exemplo== 
<syntaxhighlight lang="lua">
addEventHandler("onClientSoundFinishedDownload", root, function(length)
    local meta = getSoundMetaTags(source)

    outputChatBox("O áudio: " .. meta.title .. " terminou o download em: " .. length .. "ms.")
    outputChatBox("Os metadados são: Artista:"..(meta.artist).." Álbum:"..(meta.album).." Gênero:"..(meta.genre).." Ano:"..(meta.year).." Comentário:"..(meta.comment).." Faixa:"..(meta.track).." Compositor:"..(meta.composer).." Copyright:"..(meta.copyright).." Legenda:"..(meta.subtitle).." Álbum do artista:"..(meta.album_artist)..".")
end)
</syntaxhighlight>

==Veja também==
{{PT-BR/Funcoes_audio_client}}

[[EN:getSoundMetaTags]]
[[HU:getSoundMetaTags]]
[[AR:getSoundMetaTags]]
[[RO:getSoundMetaTags]]