MatchmakingService
MatchmakingService is responsible for managing custom matchmaking attributes. Use it to read and write matchmaking data.
요약
메서드
Retrieves the value of a specific server attribute.
Initiates the server attribute schema and its values to test in Studio.
Assigns a value to a specific server attribute.
속성
메서드
GetServerAttribute
Retrieves the value of a specific server attribute.
매개 변수
The name of the server attribute. Limited to a maximum of 50 characters.
반환
Returns the server attribute value if the attribute is found and if the error is nil. Otherwise, returns nil for the attribute value and an error message.
InitializeServerAttributesForStudio
Initiates the server attribute schema and its values to test in Studio. This method is optional and has no effect when running outside of Studio.
매개 변수
An array of attribute name-value pairs.
반환
Returns true if the call succeeded. Otherwise, returns false and an error message.
SetServerAttribute
Assigns a value to a specific server attribute.
매개 변수
The name of the server attribute. Limited to a maximum of 50 characters.
The value of the server attribute. Limited to a maximum of 50 characters.
반환
Returns true if the call succeeded. Otherwise, returns false and an error message.
코드 샘플
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