TeleportOptions
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
このクラスは、TeleportService:TeleportAsync() 関数で、開発者がテレポートコールの引数を提供できるようにします。
このクラスの一部は互換性がありません、および TeleportService:TeleportAsync() にパスするとエラーが発生します:
- ReservedServerAccessCode + ServerInstanceId
- ShouldReserveServer + ServerInstanceId
- ShouldReserveServer + ReservedServerAccessCode
プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。
概要
プロパティ
テレポート先の保留サーバーを指す予約サーバーアクセスコード。
サーバーインスタンスへテレポートする DataModel.JobId 。
予約されたサーバーが割り当てられるかどうかを示すフラグと、プレイヤーがこの割り当てにテレポートされるかどうかを示すフラグがあります。
方法
Class.TeleportOptions インスタンスに保存されたテレポートデータを TeleportOptions:SetTeleportData() で返します。
データを目的プレースに移行するためのセッター関数を設定します。
プロパティ
ReservedServerAccessCode
このプロパティは、ユーザーがテレポートする予定のサーバーに対する予約されたサーバーアクセスコードを指します。
プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。
ServerInstanceId
このプロパティは、ユーザーがテレポートするべきサーバーインスタンスの DataModel.JobId を指します。
プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。
ShouldReserveServer
このプロパティは、テレポートコールが新しい予約サーバーを作成するかどうかを示します。設定を「 true 」に設定すると、予約サーバーが作成され、プレイヤーが新しいサーバーにテレポートされます。
設定を「 false 」に設定すると、指定の TeleportOptions.ServerInstanceId が指定された公開サーバーにテレポートされます。TeleportOptions.ServerInstanceId が空の場合または一致するサーバーが見つからない場合、新しい公開プレイヤーーバーが作成されます。
プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。
方法
GetTeleportData
この関数は、TeleportOptions インスタンス内のテレポートデータを TeleportOptions:SetTeleportData() によって返します。
プレイヤーがテレポートされると、Player:GetJoinData() とTeleportService:GetLocalPlayerTeleportData() 機能を使用して、データを取得できます。
プレイヤー間のテレポートに関する詳細は、「場所間テレポート」を参照してください。
戻り値
SetTeleportData
これは、データを目的プレースに移行するための設定機能です。目的プレースでは、 Class.Player:GetJoinData() または Class.TeleportService:GetLocalPlayerTeleportData() を使用して、このデータを取得できます。
たとえば、次のスナップショットは、DataModel.PlaceId とDataModel.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 thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
テレポート関数に teleportData が設定されていない場合、この GetLocalPlayerTeleportData() は nil を返します。
ユーザーデータとテレポートを組み合わせて送信および受信する方法については、「場所間テレポート」を参照してください。
パラメータ
データを目的プレースに移行する必要があります。