MatchmakingService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
MatchmakingService bertanggung jawab untuk mengelola atribut matchmaking khusus. Gunakan untuk membaca dan menulis data matchmaking.
Rangkuman
Metode
Mengambil nilai atribut server tertentu.
Memulai skema atribut server dan nilainya untuk diuji di Studio.
Menugaskan nilai ke atribut server tertentu.
Properti
Metode
GetServerAttribute
Mengambil nilai atribut server tertentu.
Parameter
Nama atribut server. Terbatas pada maksimal 50 karakter.
Memberikan nilai
Kembalikan nilai atribut server jika atribut ditemukan dan jika kesalahan adalah nil .Jika tidak, mengembalikan nil untuk nilai atribut dan pesan kesalahan.
InitializeServerAttributesForStudio
Memulai skema atribut server dan nilainya untuk diuji di Studio. Metode ini opsional dan tidak berpengaruh saat dijalankan di luar Studio.
Parameter
Sebuah array pasangan nama-nilai atribut.
Memberikan nilai
Kembali true jika panggilan berhasil. Jika tidak, kembalikan false dan pesan kesalahan.
SetServerAttribute
Menugaskan nilai ke atribut server tertentu.
Parameter
Nama atribut server. Terbatas pada maksimal 50 karakter.
Nilai atribut server. Terbatas pada maksimal 50 karakter.
Memberikan nilai
Kembali true jika panggilan berhasil. Jika tidak, kembalikan false dan pesan kesalahan.
Contoh Kode
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