getSoundMetaTags

Lê as tags de um arquivo ou de um stream.

Sintaxe

table getSoundMetaTags ( element oSom )
string getSoundMetaTags ( element oSom, string formato )

Parâmetros

Nome	Tipo	Padrão	Descrição
oSom	element	—	Som a consultar.
formato	string	—	Um formato de tag específico. Omitir o argumento — ou passar uma string vazia — devolve a tabela completa.

Retorno

Com formato, o texto da tag pedida, ou false se ela não existir. Sem formato, uma tabela com as chaves abaixo — só entram as que têm conteúdo. Devolve false se o argumento não for um som.

Chave	Formato equivalente
title	"%TITL"
artist	"%ARTI"
album	"%ALBM"
genre	"%GNRE"
year	"%YEAR"
comment	"%CMNT"
track	"%TRCK"
composer	"%COMP"
copyright	"%COPY"
subtitle	"%SUBT"
album_artist	"%AART"
stream_name	"streamName"
stream_title	"streamTitle"

Exemplo

local tags = getSoundMetaTags(musica)
if tags and tags.artist then
    outputDebugString(tags.artist .. " - " .. (tags.title or "?"))
end

-- o título que a rádio anuncia agora
local agora = getSoundMetaTags(radio, "streamTitle")

Veja também

• getSoundFFTData — Devolve o espectro de frequências do som naquele instante.
• getSoundWaveData — Devolve uma janela da forma de onda do som naquele instante.
• getSoundLevelData — Devolve o nível atual de cada canal.
• getSoundBPM — Devolve as batidas por minuto de um som.