# playSFX3D (Cliente)

> Toca um som dos bancos de áudio do GTA San Andreas numa posição do mundo.

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

## Sintaxe

```lua
sound|false playSFX3D(string container, int bank, int audio, float x, y, z [, bool looped = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `container` | `string` | Contêiner de áudio do SA: `feet`, `genrl`, `pain_a`, `script`, `spc_ea`, `spc_fa`, `spc_ga`, `spc_na` ou `spc_pa`. |
| `bank` | `int` | Número do banco dentro do contêiner. |
| `audio` | `int` | Número do som dentro do banco. |
| `x, y, z` | `float` | Posição do som no mundo, em três números ou um `vec3`. |
| `looped` | `bool` | Repetir o som quando ele chega ao fim. *(padrão: `false`)* |

## Retorno

O elemento `sound` criado, ou `false` se o banco ou o som não existem.

## Exemplo

```lua
local pos = getElementPosition(localPlayer)
playSFX3D("genrl", 75, 0, pos)
```

### Vindo do MTA

O contêiner `radio` não é aceito: a função avisa e devolve `false`.

## Veja também

- [playSFX (Cliente)](https://wiki.mymp.gg/pt/playSFX.md): Toca um som dos bancos de áudio do GTA San Andreas, sem posição no mundo.
- [getSFXStatus (Cliente)](https://wiki.mymp.gg/pt/getSFXStatus.md): Diz se um contêiner de áudio do GTA San Andreas está disponível para playSFX e playSFX3D.
- [playSound3D (Cliente)](https://wiki.mymp.gg/pt/playSound3D-client.md): Toca um som numa posição do mundo, só neste cliente. O volume cai com a distância entre setSoundMinDistance (5 m) e setSoundMaxDistance (20 m). Dispara onClientSoundStarted com play.