TeleportOptions

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.

Lớp này là một tham số tùy chọn cho chức năng TeleportService:TeleportAsync() cho phép các nhà phát triển cung cấp các tham số cho cuộc gọi dịch chuyển.

Một số tham số trong lớp này không tương thích với nhau và gây ra lỗi khi được chuyển đến TeleportService:TeleportAsync() :

  • ReservedServerAccessCode + ServerInstanceId + ID máy chủ dự trữ
  • ShouldReserveServer + ServerInstanceId
  • ShouldReserveServer + ReservedServerAccessCode

Để biết thêm thông tin về cách dịch chuyển người chơi giữa các máy chủ, xem Dịch chuyển giữa các địa điểm.

Tóm Tắt

Thuộc Tính

Phương Pháp

Thuộc Tính

ReservedServerAccessCode

Đọc Song Song

Thuộc tính này chỉ ra mã truy cập máy chủ dự trữ cho máy chủ dự trữ mà người dùng (c) nên được dịch chuyển.

Để biết thêm thông tin về cách dịch chuyển người chơi giữa các máy chủ, xem Dịch chuyển giữa các địa điểm.

ServerInstanceId

Đọc Song Song

Thuộc tính này chỉ ra DataModel.JobId của server instance mà người dùng (c) nên được dịch chuyển đến.

Để biết thêm thông tin về cách dịch chuyển người chơi giữa các máy chủ, xem Dịch chuyển giữa các địa điểm.

ShouldReserveServer

Đọc Song Song

Tính chất này chỉ ra liệu cuộc gọi dịch chuyển có nên tạo một máy chủ dự trữ mới hay không.Khi đặt thành true, một máy chủ dự trữ sẽ được tạo và người chơi (nếu có) sẽ được dịch chuyển đến máy chủ mới.

Nếu được đặt thành false, người chơi(s) sẽ được dịch chuyển đến máy chủ công cộng với TeleportOptions.ServerInstanceId được chỉ định nếu được cung cấp.Khi TeleportOptions.ServerInstanceId trống hoặc không tìm thấy máy chủ phù hợp, một máy chủ công cộng mới sẽ được tạo để dịch chuyển người chơi (nếu có).

Để biết thêm thông tin về cách dịch chuyển người chơi giữa các máy chủ, xem Dịch chuyển giữa các địa điểm.

Phương Pháp

GetTeleportData

Variant

Chức năng này trả về dữ liệu dịch chuyển được lưu trong instance TeleportOptions bởi TeleportOptions:SetTeleportData().

Một khi một người chơi đã dịch chuyển, dữ liệu dịch chuyển có thể được lấy lại bằng cách sử dụng các chức năng Player:GetJoinData()TeleportService:GetLocalPlayerTeleportData().

Để biết thêm thông tin về cách dịch chuyển người chơi giữa các máy chủ, xem Dịch chuyển giữa các địa điểm.


Lợi Nhuận

Variant

SetTeleportData

()

Đây là chức năng cài đặt cho dữ liệu được chuyển đến nơi địa điểm.Ở nơi địa điểm, dữ liệu này có thể được lấy lại bằng cách sử dụng Player:GetJoinData() hoặc TeleportService:GetLocalPlayerTeleportData() .

Ví dụ, đoạn sau sẽ gửi DataModel.PlaceIdDataModel.JobId trong một từ điển chuyển dữ liệu dịch chuyển trong một TeleportOptions ví dụ sử dụng TeleportOptions:SetTeleportData() :


-- Máy chủ
local teleportOptions = Instance.new("TeleportOptions")
local teleportData = {
placeId = game.PlaceId,
jobId = game.JobId
}
teleportOptions:SetTeleportData(teleportData)
TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)

Dữ liệu này có thể được lấy lại khi đến sử dụng chức năng GetLocalPlayerTeleportData() như sau:


-- Khách hàng
local TeleportService = game:GetService("TeleportService")
local teleportData = TeleportService:GetLocalPlayerTeleportData()
if teleportData then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

Nếu không có teleportData được đặt trong chức năng dịch chuyển, dữ liệu GetLocalPlayerTeleportData() này sẽ trả về nil .

Để biết thêm thông tin về cách gửi và nhận dữ liệu người dùng cùng với dịch chuyển, xem, xem Dịch chuyển giữa các địa điểm.

Tham Số

teleportData: Variant

Dữ liệu sẽ được chuyển đến nơi địa điểm.

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

Lợi Nhuận

()

Sự Kiện