createVoiceChannel

Cria um canal de voz: um grupo de rádio cujo áudio ignora a distância.

Sintaxe

voice-channel createVoiceChannel ( string chave )

Parâmetros

Nome	Tipo	Padrão	Descrição
chave	string	—	Um nome para o canal, único no servidor. Entre 1 e 64 bytes.

Retorno

O novo elemento voice-channel, ou nil se chave não for string, estiver vazia ou passar de 64 bytes, já estiver em uso, ou se a voz não estiver disponível.

O canal é um elemento de verdade: fica pendurado na raiz do servidor, é replicado para todos os clientes — então getVoiceChannel o resolve nos dois lados — e getElementType devolve "voice-channel" para ele. Criar um canal não coloca ninguém dentro: veja addPlayerToVoiceChannel.

addEventHandler("onResourceStart", resourceRoot, function()
    createVoiceChannel("policia")
    createVoiceChannel("central")
end)

Nota

A tabela de roteamento comporta no máximo 256 canais. Passando disso o elemento continua sendo criado, mas nunca entra no roteamento — trate 256 como o teto.

Veja também

• setPlayerVoiceBroadcastTo — Define quem pode ouvir um jogador.
• setPlayerVoiceIgnoreFrom — Define de quem um jogador não ouve a voz.
• setVoiceMaxDistance — Altera a que distância um jogador é ouvido, para o servidor inteiro.
• getVoiceMaxDistance — Devolve a distância em vigor no momento.
• setVoiceNoiseSuppression — Define o quanto o supressor de ruído atua em todos os microfones.
• getVoiceNoiseSuppression — Devolve a intensidade do supressor em vigor.
• destroyVoiceChannel — Destrói um canal de voz e tira todo mundo de dentro dele.
• addPlayerToVoiceChannel — Coloca um jogador em um canal.