addPlayerToVoiceChannel

Coloca um jogador em um canal.

Sintaxe

bool addPlayerToVoiceChannel ( voice-channel oCanal, player oJogador )

Parâmetros

Nome	Tipo	Padrão	Descrição
oCanal	voice-channel	—	O canal em que ele entra.
oJogador	player	—	O jogador que está entrando.

Retorno

true se entrou, false se algum argumento for do tipo errado, se a voz não estiver disponível, ou se ele já era membro.

A participação decide os dois sentidos de uma vez: quem é membro ouve tudo que é enviado ao canal, e é o único tipo de jogador de quem o servidor aceita uma transmissão para aquele canal. Um cliente que pede para falar num canal do qual não faz parte tem o pedido inteiro recusado — veja setVoiceChannelTransmitting.

A participação é descartada quando o jogador sai do servidor.

addEventHandler("onPlayerJoin", root, function()
    local central = getVoiceChannel("central")
    if central then
        addPlayerToVoiceChannel(central, source)
    end
end)

Trinta canais por ouvinte

Cada ouvinte recebe um slot por canal, e existem 30 deles. Passando do trigésimo, o jogador continua ouvindo o canal, mas o áudio chega sem a marcação de canal — e aí setVoiceChannelVolume deixa de valer para ele. Mantenha a contagem de canais de cada jogador bem abaixo de 30.

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.
• createVoiceChannel — Cria um canal de voz: um grupo de rádio cujo áudio ignora a distância.
• destroyVoiceChannel — Destrói um canal de voz e tira todo mundo de dentro dele.