MatchmakingService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
MatchmakingService ist verantwortlich für die Verwaltung benutzerdefinierter Matchmaking-Attributen. Verwende es, um Matchmaking-Daten zu lesen und zu schreiben.
Zusammenfassung
Methoden
Ruft den Wert eines bestimmten Serverattributs ab.
Startet das Serverattribut-Schema und seine Werte, um sie in Studio zu testen.
Weist einem bestimmten Serverattribut einen Wert zu.
Eigenschaften
Methoden
GetServerAttribute
Ruft den Wert eines bestimmten Serverattributs ab.
Parameter
Der Name des Serverattributs. Beschränkt auf ein Maximum von 50 Zeichen.
Rückgaben
Gibt den Serverattributswert zurück, wenn das Attribut gefunden wird und wenn der Fehler nil ist.Andernfalls gibt es nil für den Attributwert und eine Nachrichtzurück.
InitializeServerAttributesForStudio
Startet das Serverattribut-Schema und seine Werte zum Testen in Studio. Diese Methode ist optional und hat keine Auswirkungen, wenn sie außerhalb von Studio ausgeführt wird.
Parameter
Ein Array von Attribut-Namens-Werten.
Rückgaben
Gibt true zurück, wenn der Anruf erfolgreich war. Andernfalls gibt es false und eine Nachrichtzurück.
SetServerAttribute
Weist einem bestimmten Serverattribut einen Wert zu.
Parameter
Der Name des Serverattributs. Beschränkt auf ein Maximum von 50 Zeichen.
Der Wert des Serverattributs. Begrenzt auf ein Maximum von 50 Zeichen.
Rückgaben
Gibt true zurück, wenn der Anruf erfolgreich war. Andernfalls gibt es false und eine Nachrichtzurück.
Code-Beispiele
The following code sample:
- Tests the hard-coded Level, Elo, and TrainingMode attributes in Studio with InitializeServerAttributesForStudio.
- Gets the Level attribute with GetServerAttribute.
- Updates the player's Level attribute with SetServerAttribute.
local MatchmakingService = game::GetService("MatchmakingService")
local RunService = game:GetService("RunService")
if RunService:IsStudio() then
-- Sets up initial attributes and schema for testing
MatchmakingService:InitializeServerAttributesForStudio(
{
Level = "Advanced",
Elo = 123.456,
TrainingMode = true
})
end
-- Retrieves the Level attribute
local currentLevel, error = MatchmakingService:GetServerAttribute("Level")
if error then
print(error)
else
print("Current level: " .. currentLevel)
end
-- Updates the Level attribute value to Advanced
local success, error = MatchmakingService:SetServerAttribute("Level", "Advanced")
if not success then
print("Failed to update server attribute [Level] to [Advanced] due to error: " .. error)
else
print("Successfully set [Level] to [Advanced]")
end