# createVoiceChannel (Servidor)

> Cria um canal de voz. Os jogadores só ouvem uns aos outros pelos canais em que estão.

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

## Sintaxe

```lua
element|false createVoiceChannel(int mode, float maxDistance)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `mode` | `int` | `0`: todos no canal se ouvem em volume cheio. `1`: só quem está até `maxDistance` metros, na mesma dimensão e interior, com o volume caindo com a distância. `3`: como o `1`, e o canal é destruído quando o último jogador sai. |
| `maxDistance` | `float` | Alcance em metros, maior que 0 nos modos `1` e `3`. É obrigatório também no modo `0`, onde é ignorado. |

## Retorno

O elemento `voice-channel` criado, ou `false` se não pôde ser criado.

O canal pertence ao recurso que o criou. Quem está em vários canais é ouvido por todos eles; se um canal sem distância o alcança, o ouvinte o escuta em volume cheio.

## Exemplo

```lua
local proximity = createVoiceChannel(1, 30)

addEventHandler("onPlayerJoin", root, function()
    addPlayerToVoiceChannel(proximity, source)
end)
```

### Vindo do MTA

O MTA não tem canais de voz. Os modos seguem os do FiveM, sem o modo `2`.

### Atenção

Um jogador que não está em nenhum canal não é ouvido por ninguém.

## Veja também

- [addPlayerToVoiceChannel (Servidor)](https://wiki.mymp.gg/pt/addPlayerToVoiceChannel.md): Põe um jogador num canal de voz. A partir daí ele ouve e é ouvido pelos outros do canal.
- [deleteVoiceChannel (Servidor)](https://wiki.mymp.gg/pt/deleteVoiceChannel.md): Destrói um canal de voz. Os jogadores que estavam nele deixam de se ouvir por ele.
- [setPlayerMutedInVoiceChannel (Servidor)](https://wiki.mymp.gg/pt/setPlayerMutedInVoiceChannel.md): Deixa um jogador mudo num canal de voz: ele continua ouvindo o canal, mas ninguém o ouve por ele.