TeleportOptions

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

このクラスは、TeleportService:TeleportAsync() 関数で、開発者がテレポートコールの引数を提供できるようにします。

このクラスの一部は互換性がありません、および TeleportService:TeleportAsync() にパスするとエラーが発生します:

  • ReservedServerAccessCode + ServerInstanceId
  • ShouldReserveServer + ServerInstanceId
  • ShouldReserveServer + ReservedServerAccessCode

プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。

概要

プロパティ

  • テレポート先の保留サーバーを指す予約サーバーアクセスコード。

  • 並列読み取り

    サーバーインスタンスへテレポートする DataModel.JobId

  • 並列読み取り

    予約されたサーバーが割り当てられるかどうかを示すフラグと、プレイヤーがこの割り当てにテレポートされるかどうかを示すフラグがあります。

方法

プロパティ

ReservedServerAccessCode

並列読み取り

このプロパティは、ユーザーがテレポートする予定のサーバーに対する予約されたサーバーアクセスコードを指します。

プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。

ServerInstanceId

並列読み取り

このプロパティは、ユーザーがテレポートするべきサーバーインスタンスの DataModel.JobId を指します。

プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。

ShouldReserveServer

並列読み取り

このプロパティは、テレポートコールが新しい予約サーバーを作成するかどうかを示します。設定を「 true 」に設定すると、予約サーバーが作成され、プレイヤーが新しいサーバーにテレポートされます。

設定を「 false 」に設定すると、指定の TeleportOptions.ServerInstanceId が指定された公開サーバーにテレポートされます。TeleportOptions.ServerInstanceId が空の場合または一致するサーバーが見つからない場合、新しい公開プレイヤーーバーが作成されます。

プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。

方法

GetTeleportData

Variant

この関数は、TeleportOptions インスタンス内のテレポートデータを TeleportOptions:SetTeleportData() によって返します。

プレイヤーがテレポートされると、Player:GetJoinData()TeleportService:GetLocalPlayerTeleportData() 機能を使用して、データを取得できます。

プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。


戻り値

Variant

SetTeleportData

void

これは、データを目的プレースに移行するための設定機能です。目的プレースでは、 Class.Player:GetJoinData() または Class.TeleportService:GetLocalPlayerTeleportData() を使用して、このデータを取得できます。

たとえば、次のスナップショットは、DataModel.PlaceIdDataModel.JobId をダイクションで送信し、TeleportOptions インスタンスを使用して、2>Class.TeleportOptions:SetTeleportData() を使用しています:


-- サーバー
local teleportOptions = Instance.new("TeleportOptions")
local teleportData = {
placeId = game.PlaceId,
jobId = game.JobId
}
teleportOptions:SetTeleportData(teleportData)
TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)

このデータは、次のように GetLocalPlayerTeleportData() 関数を使用して、到着時に取得できます:


-- クライアント
local TeleportService = game:GetService("TeleportService")
local teleportData = TeleportService:GetLocalPlayerTeleportData()
if teleportData then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

テレポート関数に teleportData が設定されていない場合、この GetLocalPlayerTeleportData() は nil を返します。

ユーザーデータとテレポートを組み合わせて送信および受信する方法については、「場所間テレポート」を参照してください。

パラメータ

teleportData: Variant

データを目的プレースに移行する必要があります。


戻り値

void

イベント