# getSoundMetaTags (Cliente)

> Lê as tags do arquivo de áudio (ID3 do MP3, comentários do OGG e do FLAC, INFO do WAV).

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Som
- **URL**: https://wiki.mymp.gg/pt/getSoundMetaTags

## Sintaxe

```lua
table|string|false getSoundMetaTags(sound sound [, string format = ""])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `sound` | O elemento `sound`, ou um elemento `dui` para o som do navegador. |
| `format` | `string` | Um formato de tags como `%ARTI - %TITL`. Vazio devolve a tabela com todas as tags. *(padrão: `""`)* |

## Retorno

Sem `format`, uma tabela com os campos que o arquivo tem: `title`, `artist`, `album`, `genre`, `year`, `comment`, `track`, `composer`, `copyright`, `subtitle`, `album_artist`. Com `format`, o texto montado. `false` se o texto sai vazio ou o som não foi encontrado.

## Exemplo

```lua
local music = playSound("sounds/track.mp3")
local tags = getSoundMetaTags(music)
outputDebugString(("Tocando agora: %s - %s"):format(tags.artist or "?", tags.title or "?"))
```

## Veja também

- [getSoundLength (Compartilhado)](https://wiki.mymp.gg/pt/getSoundLength.md): Devolve a duração do som.
- [playSound (Cliente)](https://wiki.mymp.gg/pt/playSound-client.md): Toca um som sem posição no mundo, só neste cliente. Dispara onClientSoundStarted com o motivo play.