MessagingService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
MessagingService permite que los servidores de la misma experiencia se comuniquen entre sí en tiempo real (menos de 1 segundo) usando temas. Los temas son cadenas de caracteres de desarrollador (1–80 caracteres) que los servidores usan para enviar y recibir mensajes.
La entrega es el mejor esfuerzo y no está garantizada. Asegúrese de arquitectar su experiencia para que los fallos de entrega no sean críticos.
Mensajería entre servidoresCross-Server Messaging explora cómo comunicarse entre servidores en mayor detalle.
Si desea publicar mensajes ad hoc para los servidores de juegos en vivo, puede usar las API de Open Cloud.
Limitaciones
Tenga en cuenta que estos límites están sujetos a cambios.
| Límite | Máximo |
|---|
Resumo
Métodos
Invoca el código de llamada proporcionado cuando se envía un mensaje al tema.
Empieza a escuchar el tema dado.
Propriedades
Métodos
PublishAsync
Esta función envía el mensaje proporcionado a todos los suscriptores al tema, haciendo que se ejecuten sus llamadas registradas.
Sobresale hasta que se reciba el mensaje por el backend.
Parâmetros
Determina dónde se envía el mensaje.
Los datos para incluir en el mensaje.
Devolução
SubscribeAsync
Esta función registra un llamado para comenzar a escuchar el tema dado. El llamado se invoca cuando un tema recibe un mensaje. Se puede llamar varias veces para el mismo tema.
Devolución
El llamador se invoca con un solo argumento, una tabla con las siguientes entradas:
| Campo | Resumen |
|---|
Solo se muestra hasta que se registre correctamente la suscripción y se devuelva un objeto de conexión.
Para darse de baja, llame a Disconnect() en el objeto devuelto. Una vez llamado, el llamado de vuelta nunca debe ser invocado. Matar el script que contiene las conexiones también hace que la conexión subyacente sea desuscribirse.
También véase MessagingService:PublishAsync() que envía el mensaje proporcionado a todos los suscriptores del tema, para que se ejecuten sus llamadas registradas.
Parâmetros
Determina dónde escuchar los mensajes.
Función para ser invocada cada vez que se reciba un mensaje.
Devolução
Conexión que se puede usar para darse de baja del tema.
Amostras de código
local MessagingService = game:GetService("MessagingService")
local Players = game:GetService("Players")
local function onPlayerAdded(player)
--subscribe to the topic
local topic = "player-" .. player.UserId
local connection = MessagingService:SubscribeAsync(topic, function(message)
print("Received message for", player.Name, message.Data)
end)
player.AncestryChanged:Connect(function()
-- unsubscribe from the topic
connection:Disconnect()
end)
end
Players.PlayerAdded:Connect(onPlayerAdded)