MessagingService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
MessagingService consente ai server della stessa esperienza di comunicare tra loro in tempo reale (meno di 1 secondo) utilizzando argomenti. Gli argomenti sono stringhe sviluppate dal server (1-80 caratteri) che i server utilizzano per inviare e ricevere messaggi.
La consegna è il miglior sforzo e non è garantita. Assicurati di architettare la tua esperienza in modo che i falliti della consegna non siano critici.
Cross-Server Messaging esplora come comunicare tra i server in modo più dettagliato.
Se vuoi pubblicare messaggi ad hoc per i server di gioco in tempo reale, puoi usare le API aperte del cloud.
Limitazioni
Nota che questi limiti sono soggetti a cambiamento.
| Limite | Massimo |
|---|
Sommario
Proprietà
Metodi
Invoca il richiamo fornito ogni volta che un messaggio viene spedito al topic.
Inizia ad ascoltare il tema dato.
Proprietà
Metodi
PublishAsync
Questa funzione invia il messaggio fornito a tutti gli iscritti al tema, attivando le loro richiami registrati per essere invocati.
Ritira fino a quando il messaggio non viene ricevuto dal backend.
Parametri
Determina dove viene inviato il messaggio.
I dati da includere nel Messaggio.
Restituzioni
SubscribeAsync
Questa funzione registra un callback per iniziare a ascoltare l'argomento fornito. Il callback viene chiamato quando un argomento riceve un Messaggio. Può essere chiamato più volte per lo stesso argomento.
Ritorno
Il callback viene invocato con un solo argomento, una tabella con le seguenti entradne:
| Campo | Panoramica |
|---|
Genera fino a quando la sottoscrizione non è correttamente registrata e restituisce un oggetto di connessione.
Per disiscrivere, chiama Disconnect() sull'oggetto restituito. Una volta chiamato, il callback non dovrebbe mai essere invocato. Uccidere lo script che contiene le connessioni causa anche l'iscrizione alla connessione sottostante.
Vedi anche MessagingService:PublishAsync() che invia il messaggio fornito a tutti gli iscritti al argomento, attivando le loro richiami registrati per essere eseguiti.
Parametri
Determina dove ascoltare i messaggi.
Funzione da invocare ogni volta che viene riceunto un messaggio.
Restituzioni
Connessione che può essere utilizzata per disiscriversi dal topic.
Campioni di codice
This example demonstrates how to use MessagingService:SubscribeAsync() to listen to a topic for cross-server chat within a game universe.
When a player joins, the example subscribes to the topic player-<player.UserId>. When a message is sent with this topic, the connected callback executes and prints Received message for <player.Name">. It also disconnects the connection when the player's ancestry changes.
In order for this to work as expected it must be placed in a server Script.
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)