RemoteEvent
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
O objeto Evento Remoto facilita a comunicação assíncrona, de um para um, através da fronteira cliente-servidor sem renunciar a uma resposta.Esta comunicação pode ser direcionada de um cliente para o servidor, do servidor para um cliente específico ou do servidor para todos os clientes.
Para que tanto o servidor quanto os clientes acessem uma instância RemoteEvent , deve estar em um lugar onde ambas as partes possam vê-la, como ReplicatedStorage , embora, em alguns casos, seja apropriado armazená-la em Workspace ou dentro de um Tool .
Se você precisar do resultado da chamada, deve usar um RemoteFunction em vez disso.Caso contrário, um evento remoto é recomendado, pois minimizará o tráfego de rede/latência e não fará com que o script espere por uma resposta.
Veja Eventos e chamadas remotas para amostras de código e mais detalhes sobre RemoteEvent .
Limitações de Parâmetros
Qualquer tipo de objeto Roblox, como um Enum, Instance ou outros, pode ser passado como um parâmetro quando um RemoteEvent for disparado, assim como tipos Luau, como números, strings e booleanos, embora você deva explorar cuidadosamente as limitações .
Resumo
Métodos
Dispara o evento OnClientEvent para cada cliente conectado ao mesmo RemoteEvent.
Dispara o evento OnClientEvent para um cliente específico conectado ao mesmo RemoteEvent.
Dispara o evento OnServerEvent no servidor a partir de um cliente conectado ao mesmo RemoteEvent.
Eventos
Incêndios de um LocalScript quando FireClient() ou FireAllClients() for chamado na mesma instância RemoteEvent de um Script .
Incêndios de um Script quando FireServer() é chamado na mesma RemoteEvent instância de um LocalScript .
Propriedades
Métodos
FireAllClients
Dispara o evento OnClientEvent para cada cliente conectado ao mesmo RemoteEvent.Ao contrário de FireClient(), este evento não toma um alvo Player como o primeiro argumento, pois dispara para vários clientes.Como este método é usado para se comunicar do servidor aos clientes, ele só funcionará quando usado em um Script .
Qualquer tipo de objeto Roblox, como um , ou outros, pode ser passado como um parâmetro para , bem como tipos Luau como números, strings e booleanos, embora você deva explorar cuidadosamente as limitações de .
Veja Eventos e chamadas remotas para amostras de código e mais detalhes sobre RemoteEvent .
Parâmetros
Valores a serem passados a todos os OnClientEvent conectados ao mesmo RemoteEvent.
Devolução
FireClient
Dispara o evento OnClientEvent de um cliente conectado especificado pelo argumento necessário Player.Como este método é usado para se comunicar do servidor para um cliente, ele só funcionará quando usado em um Script .
Qualquer tipo de objeto Roblox, como um , ou outros, pode ser passado como um parâmetro para , bem como tipos Luau como números, strings e booleanos, embora você deva explorar cuidadosamente as limitações de .
Veja Eventos e chamadas remotas para amostras de código e mais detalhes sobre RemoteEvent .Veja também FireAllClients() que funciona de forma semelhante, mas dispara o evento para cada cliente conectado ao mesmo RemoteEvent.
Parâmetros
Valores a serem passados a OnClientEvent eventos conectados ao mesmo RemoteEvent.
Devolução
FireServer
Dispara o evento OnServerEvent no servidor a partir de um cliente.Eventos conectados recebem o argumento Player do cliente de disparo.Como este método é usado para se comunicar de um cliente para o servidor, ele só funcionará quando usado em um LocalScript .
Qualquer tipo de objeto Roblox, como um , ou outros, pode ser passado como um parâmetro para , bem como tipos Luau como números, strings e booleanos, embora você deva explorar cuidadosamente as limitações de .
Veja Eventos e chamadas remotas para amostras de código e mais detalhes sobre RemoteEvent .
Parâmetros
Valores a serem passados a OnServerEvent eventos conectados ao mesmo RemoteEvent.
Devolução
Eventos
OnClientEvent
Incêndios de um LocalScript quando FireClient() ou FireAllClients() for chamado na mesma instância RemoteEvent de um Script .
Veja Eventos e chamadas remotas para amostras de código e mais detalhes sobre OnClientEvent .
Parâmetros
Os parâmetros enviados através de FireClient() ou FireAllClients().
OnServerEvent
Incêndios de um Script quando FireServer() é chamado na mesma RemoteEvent instância de um LocalScript .
Veja Eventos e chamadas remotas para amostras de código e mais detalhes sobre OnServerEvent .
Parâmetros
O Player associado ao cliente de onde a chamada FireServer() se origina.
Os parâmetros enviados através de FireServer() .