MatchmakingService
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
MatchmakingService jest odpowiedzialny za zarządzanie niestandardowymi atrybutami matchmakingowymi. Użyj go do odczytu i zapisu danych matchmakingowych.
Podsumowanie
Metody
Zwraca wartość określonego atrybutu serwera.
Inicjuje schemat atrybutów serwera i jego wartości do testowania w Studio.
Przydziela wartość do określonego atrybutu serwera.
Właściwości
Metody
GetServerAttribute
Zwraca wartość określonego atrybutu serwera.
Parametry
Nazwa atrybutu serwera. Ograniczona do maksymalnie 50 znaków.
Zwroty
Zwraca wartość atrybutu serwera, jeśli atrybut został znaleziony i jeśli błąd wynosi nil.W przeciwnym razie zwraca nil dla wartości atrybutu i wiadomośćo błędzie.
InitializeServerAttributesForStudio
Inicjuje schemat atrybutów serwera i jego wartości do testowania w Studio. Ta metoda jest opcjonalna i nie ma wpływu na działanie poza Studio.
Parametry
Zbiór pary nazwy atrybutu i wartości.
Zwroty
Zwraca true jeśli wezwanie powiodło się sukcesem. W przeciwnym razie zwraca false i wiadomośćo błędzie.
SetServerAttribute
Przydziela wartość do określonego atrybutu serwera.
Parametry
Nazwa atrybutu serwera. Ograniczona do maksymalnie 50 znaków.
Wartość atrybutu serwera. Ograniczona do maksymalnie 50 znaków.
Zwroty
Zwraca true jeśli wezwanie powiodło się sukcesem. W przeciwnym razie zwraca false i wiadomośćo błędzie.
Przykłady kodu
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