MatchmakingService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
MatchmakingService est responsable de la gestion des attributs de matchmaking personnalisés. Utilisez-le pour lire et écrire des données de matchmaking.
Résumé
Méthodes
Récupère la valeur d'un attribut serveur spécifique.
Initie le schéma d'attribut du serveur et ses valeurs pour les tester dans Studio.
Attribue une valeur à un attribut serveur spécifique.
Propriétés
Méthodes
GetServerAttribute
Récupère la valeur d'un attribut serveur spécifique.
Paramètres
Le nom de l'attribut serveur. Limité à un maximum de 50 caractères.
Retours
Renvoie la valeur d'attribut du serveur si l'attribut est trouvé et si l'erreur est nil .Sinon, renvoie nil pour la valeur de l'attribut et un message d'erreur.
InitializeServerAttributesForStudio
Initie le schéma d'attribut du serveur et ses valeurs pour les tester dans Studio. Cette méthode est facultative et n'a aucun effet lorsqu'elle est exécutée en dehors de Studio.
Paramètres
Un ensemble de paires de noms d'attributs valeur.
Retours
Retourne true si l'appel a réussi. Sinon, retourne false et un message d'erreur.
SetServerAttribute
Attribue une valeur à un attribut serveur spécifique.
Paramètres
Le nom de l'attribut serveur. Limité à un maximum de 50 caractères.
La valeur de l'attribut serveur. Limité à un maximum de 50 caractères.
Retours
Retourne true si l'appel a réussi. Sinon, retourne false et un message d'erreur.
Échantillons de code
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