RemoteFunction
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Das RemoteFunction-Objekt ermöglicht die synchronisierte Zwei-Weg-Kommunikation über die Client-Server-Grenze. Sie können es verwenden, um eine benutzerdefinierte Rückruffunktion zu definieren und sie manuell durch Aufrufen von RemoteFunction:InvokeClient() oder 2> Class.RemoteFunction:ExecuteServer()2> zu r
Damit sowohl der Server als auch die Clients auf eine RemoteFunction Instanz zugreifen können, muss sie in einem Ort sein, an dem beide Seiten sie sehen können, wie z. B. ReplicatedStorage, obwohl es in einigen Fällen sinnvoll ist, ihn in Workspace oder innerhalb eines 1> Class.Arbeitsbereich1> zu speichern.
Wenn das Ergebnis nicht benötigt wird, wird empfohlen, dass Sie stattdessen ein RemoteEvent verwenden, da sein Aufruf asynchron ist und keine Antwort auf die Fortführung der Ausführung erfordert. Siehe Remote-Ereignisse und Aufrufe für Code-Beispiele und weitere Details über 1> Class.RemoteFunction1> .
Übertragungsverfügbarkeitsprüfung
Beachten Sie, dass, wenn ein aufgerufener RemoteFunction eine Instanz
Limitierungen der Parameter
Jeder Roblox-Objekt wie ein Enum , Instance oder anderes kann als ein Parallel-Parameter übergeben werden, wenn ein RemoteFunction aufgerufen wird, sowie Luau-Typen wie Zahlen, Strings und Booleans, obwohl Sie die 1>Einschränkungen1> sorgfältig erkunden sollten.
Zusammenfassung
Methoden
Ruft die RemoteFunction auf, die wiederum den OnClientInvoke Callback.
Ruft die RemoteFunction auf, die wiederum den OnServerInvoke -Callback aufruft.
Callbacks
Eigenschaften
Methoden
InvokeClient
Ruft die Class.RemoteFunction auf, die wiederum den Class.RemoteFunction.OnClientHandle|OnClientHandle Callbackaufruft. Da diese Methode verwendet wird, um vom Server zu einem Client zu kommunizieren, wird sie nur funktionieren, wenn sie in einem Class.Script verwendet wird.
Jeder Roblox-Objekt wie ein Enum , Instance oder anderes kann als ein Parameter an Class.RemoteFunction:ExecuteClient()|ExecuteClient() übergeben werden, sowie Luau-Typen wie Zahlen, Strings und Booleans, obwohl Sie die 1> Einschränkungen1> sorgfältig erkunden sollten.
Siehe Remote-Ereignisse und Rückrufe für Code-Beispiele und weitere Details auf RemoteFunction.
Warnung
In der Praxis ruft der Server nicht oft den Client auf, da Clients normalerweise keine Informationen haben, die der Server nicht hat, und Aktionen, die nur ein Client ausführen kann, wie das Anzeigen einer grafische Benutzeroberfläche, benötigen in der Regel keine Callback. Als solches wird RemoteEvent:FireClient() empfohlen als asynchrones Methode, die nicht auf eine Antwort warten muss, um die Ausführung fortzusetzen.
Wenn Sie einen Client vom Server legitim einladen müssen, beachten Sie die folgenden Risiken:
- Wenn der Client einen Fehler gewinnt, der Server einen Fehler gewinnt auch.
- Wenn der Client abbricht, während er ausgeführt wird, InvokeClient() gibt einen Fehler an.
- Wenn der Client keine Werte zurückgibt, gibt der Server für immer zurück.
Parameter
Werte, die an den OnClientInvoke-Callback weitergegeben werden.
Rückgaben
Werte, die vom OnClientInvoke-Callback zurückgegeben werden.
InvokeServer
Ruft die Class.RemoteFunction auf, die wiederum den Class.RemoteFunction.OnServerExecute|OnServerExecute -Callback aufruft. Da diese Methode verwendet wird, um von einem Client zum Server zu kommunizieren, wird sie nur funktionieren, wenn sie in einem Class.LocalScript verwendet wird.
Wenn ein zurückgegebenes Ergebnis nicht benötigt wird, wird empfohlen, RemoteEvent:FireServer() anstelle dessen zu verwenden, da sein Anruf asynchron ist und keine Antwort auf die Fortsetzung der Ausführung erfordert.
Jeder Roblox-Objekt wie ein Enum , Instance oder anderes kann als ein Parameter an Class.RemoteFunction:ExecuteServer()|ExecuteServer() übergeben werden, sowie Luau-Typen wie Zahlen, Strings und Booleans, obwohl Sie die 1> Einschränkungen1> sorgfältig erkunden sollten.
Siehe Remote-Ereignisse und Rückrufe für Code-Beispiele und weitere Details auf RemoteFunction.
Parameter
Werte, die an den OnServerInvoke-Callback weitergegeben werden.
Rückgaben
Werte, die vom OnServerInvoke-Callback zurückgegeben werden.