TeleportOptions
*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
Mã truy cập máy chủ dự trữ cho thấy máy chủ dự trữ mà teleport nên đến.
The DataModel.JobId của server instance để dịch chuyển đến.
Một lá cờ để chỉ ra nếu một máy chủ dự trữ nên được gán và người chơi sau đó nên được dịch chuyển đến phần gán này.
Phương Pháp
Trả về dữ liệu dịch chuyển được lưu trong instance TeleportOptions bằng TeleportOptions:SetTeleportData() .
Chức năng cài đặt cho dữ liệu được chuyển đến nơi địa điểm.
Thuộc Tính
ReservedServerAccessCode
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
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
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
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() và 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
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.PlaceId và DataModel.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ànglocal TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
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ố
Dữ liệu sẽ được chuyển đến nơi địa điểm.