triggerLatentServerEvent

Envia um evento ao servidor com banda limitada.

Sintaxe

bool triggerLatentServerEvent ( string nomeDoEvento [, int banda = 5000, bool persistir = false ], element origem [, ... ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
nomeDoEvento	string	—	Evento a disparar no servidor. Um número vira texto.
banda	number	5000	Bytes por segundo que o envio pode usar.
persistir	bool	false	Com false, um envio que não terminou é descartado se o seu resource parar. true deixa ele terminar mesmo assim.
origem	element	—	Elemento de origem, que vira source no manipulador do servidor. Precisa ser um elemento que o servidor conhece.
...	any	—	Argumentos repassados ao manipulador.

Retorno

true quando o envio entra na fila. Um nomeDoEvento, uma banda ou uma origem inválidos registram um aviso e devolvem false. Também devolve false, sem aviso, quando origem é um elemento criado por um script de cliente, ou quando algum argumento é um elemento assim ou outro userdata que não atravessa a rede — dentro de uma tabela, esses valores chegam como nil.

A função não devolve um identificador. Para acompanhar ou cancelar o envio, chame getLatentEventHandles logo em seguida: o envio novo é a última entrada.

Existe uma única fila para o servidor, e os envios saem dela em ordem, um de cada vez, na maior banda entre os que estão esperando (nunca abaixo de 500 bytes por segundo). Um envio é entregue inteiro quando o tempo de transferência dele acaba; no servidor ele então se comporta exatamente como um vindo de triggerServerEvent — o nome precisa ter sido registrado lá com addEvent(nomeDoEvento, true), e a global client aponta quem enviou.

Cuidado

Vale o mesmo aviso de triggerServerEvent: tudo o que chega por aqui, source inclusive, foi escrito por quem controla o cliente.

Exemplo

-- manda uma tabela grande sem travar o tráfego do próprio jogo
triggerLatentServerEvent("onClientRelatorio", 2000, false, localPlayer, dadosDoRelatorio)

Veja também

• triggerServerEvent — Dispara um evento no servidor.
• getLatentEventHandles — Lista os envios latentes ainda na fila para o servidor.
• getLatentEventStatus — Diz até onde chegou um envio latente na fila.
• cancelLatentEvent — Tira um envio latente da fila.