MatchmakingService
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
MatchmakingService có trách nhiệm quản lý các thuộc tính matchmaking tùy chỉnh. Sử dụng nó để đọc và viết dữ liệu matchmaking.
Tóm Tắt
Phương Pháp
Lấy giá trị của một thuộc tính máy chủ cụ thể.
Khởi tạo cấu trúc thuộc tính máy chủ và các giá trị của nó để kiểm tra trong Studio.
Gán giá trị cho một thuộc tính máy chủ cụ thể.
Thuộc Tính
Phương Pháp
GetServerAttribute
Lấy giá trị của một thuộc tính máy chủ cụ thể.
Tham Số
Tên thuộc tính máy chủ. Giới hạn tối đa 50 ký tự.
Lợi Nhuận
Trả giá trị thuộc tính máy chủ nếu thuộc tính được tìm thấy và nếu lỗi là nil .Nếu không, trả về nil cho giá trị thuộc tính và một thông tin nhắnlỗi.
InitializeServerAttributesForStudio
Khởi tạo cấu trúc thuộc tính máy chủ và các giá trị của nó để kiểm tra trong Studio. Phương pháp này là tùy chọn và không có hiệu lực khi chạy bên ngoài Studio.
Tham Số
Một loạt các cặp tên-giá trị thuộc tính.
Lợi Nhuận
Trả về true nếu cuộc gọi thành công. Nếu không, trả về false và một thông tin nhắnlỗi.
SetServerAttribute
Gán giá trị cho một thuộc tính máy chủ cụ thể.
Tham Số
Tên thuộc tính máy chủ. Giới hạn tối đa 50 ký tự.
Giá trị của thuộc tính máy chủ. Giới hạn tối đa 50 ký tự.
Lợi Nhuận
Trả về true nếu cuộc gọi thành công. Nếu không, trả về false và một thông tin nhắnlỗi.
Mẫu mã
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