TeleportOptions

非推奨を表示

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

このクラスは、開発者がテレポート呼び出しの引数を提供できるようにする TeleportService:TeleportAsync() 関数のオプションパラメータです。

このクラスの特定の引数は互いに対応しておらず、TeleportService:TeleportAsync() にパスされるとエラーが発生します：

  • 予約サーバーアクセスコード + ServerInstanceId
  • ShouldReserveServer + サーバーInstanceId
  • ShouldReserveServer + ReservedServerアクセスコード + ReservedServerAccessCode

サーバー間でプレイヤーをテレポートする方法に関する詳細は、場所間テレポート を参照してください。

概要

プロパティ

  • ReservedServerAccessCode:string
    並列読み取り

    テレポートする予定のサーバーを示す予約済みサーバーアクセスコード。

  • ServerInstanceId:string
    並列読み取り

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

  • ShouldReserveServer:boolean
    並列読み取り

    予約済みのサーバーが割り当てられるかどうかを示すフラグ、そしてプレイヤーはこの割り当てにテレポートする必要があります。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

プロパティ

ReservedServerAccessCode

string
並列読み取り

このプロパティは、ユーザー(たち)がテレポートする予定の保留サーバーの予約サーバーへのアクセスコードを示します。

サーバー間でプレイヤーをテレポートする方法に関する詳細は、場所間テレポート を参照してください。

ServerInstanceId

string
並列読み取り

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

サーバー間でプレイヤーをテレポートする方法に関する詳細は、場所間テレポート を参照してください。

ShouldReserveServer

boolean
並列読み取り

このプロパティは、テレポート呼び出しが新しい予約サーバーを作成する必要があるかどうかを示します。真に設定されると、予約済みのサーバーが作成され、プレイヤー(たち)が新しいサーバーにテレポートされます。

[偽] に設定すると、指定された TeleportOptions.ServerInstanceId を持つ公開サーバーにプレイヤー(複数)がテレポートされます。When TeleportOptions.ServerInstanceId が空白であるか、一致するサーバーが見つからない場合、プレイヤー(たち)をテレポートするための新しい公開サーバーが作成されます。

サーバー間でプレイヤーをテレポートする方法に関する詳細は、場所間テレポート を参照してください。

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

方法

GetTeleportData

Variant

この関数は、TeleportOptions インスタンスに保存されたテレポートデータを TeleportOptions:SetTeleportData() で返します。

プレイヤーがテレポートした後、テレポートデータは Player:GetJoinData() および TeleportService:GetLocalPlayerTeleportData() 関数を使用して回収できます。

サーバー間でプレイヤーをテレポートする方法に関する詳細は、場所間テレポート を参照してください。


戻り値

Variant

SetTeleportData

()

これは、データをターゲットプレースにパスするためのセッター関数です。目的地の場所では、Player:GetJoinData() または TeleportService:GetLocalPlayerTeleportData() を使用してこのデータを取得できます。

たとえば、次のスニペットは、テレポートデータを DataModel.PlaceId と DataModel.JobId に送信し、TeleportOptions インスタンスで 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

目的プレースに送信されるデータ。

既定値: ""

戻り値

()
Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示

イベント

Instance から継承されたものをすべて表示
Object から継承されたものをすべて表示