MatchmakingService

Hiển Thị Bản Đã Lỗi Thời

*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.

Không Thể Tạo
Dịch Vụ
Không Sao Chép

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

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ố

name: string

Tên thuộc tính máy chủ. Giới hạn tối đa 50 ký tự.

Giá Trị Mặc Định: ""

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ố

serverAttributes: Dictionary

Một loạt các cặp tên-giá trị thuộc tính.

Giá Trị Mặc Đị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ố

name: string

Tên thuộc tính máy chủ. Giới hạn tối đa 50 ký tự.

Giá Trị Mặc Định: ""
value: Variant

Giá trị của thuộc tính máy chủ. Giới hạn tối đa 50 ký tự.

Giá Trị Mặc Đị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.

Mẫu mã

The following code sample:

MarketplaceService sample

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

Sự Kiện