MatchmakingService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
MatchmakingService é responsável por gerenciar atributos de correspondência personalizados. Use-o para ler e escrever dados de correspondência.
Resumo
Métodos
Recupera o valor de um atributo específico do servidor.
Inicia o esquema de atributos do servidor e seus valores para testar no Studio.
Atribui um valor a um atributo de servidor específico.
Propriedades
Métodos
GetServerAttribute
Recupera o valor de um atributo específico do servidor.
Parâmetros
O nome do atributo do servidor. Limitado a um máximo de 50 caracteres.
Devolução
Retorna o valor do atributo do servidor se o atributo for encontrado e se o erro for nil.Caso contrário, retorna nil para o valor do atributo e uma mensagem de erro.
InitializeServerAttributesForStudio
Inicia o esquema de atributos do servidor e seus valores para testar no Studio. Este método é opcional e não tem efeito ao executar fora do Studio.
Parâmetros
Um conjunto de pares de nome e valor de atributo.
Devolução
Retorna true se a chamada tiver sucesso. Caso contrário, retorna false e uma mensagem de erro.
SetServerAttribute
Atribui um valor a um atributo de servidor específico.
Parâmetros
O nome do atributo do servidor. Limitado a um máximo de 50 caracteres.
O valor do atributo do servidor. Limitado a um máximo de 50 caracteres.
Devolução
Retorna true se a chamada tiver sucesso. Caso contrário, retorna false e uma mensagem de erro.
Amostras de código
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