TeleportOptions

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Cette classe est un paramètre facultatif à la fonction TeleportService:TeleportAsync() qui permet aux développeurs de fournir des arguments pour le appel de téléportation.

Certains arguments de cette classe ne sont pas compatibles les uns avec les autres et provoquent une erreur lors de leur transmission à TeleportService:TeleportAsync() :

  • ReservedServerAccessCode + ServerInstanceId
  • ShouldReserveServer + ServerInstanceId
  • ShouldReserveServer + code d'accès réservé

Pour plus d'informations sur la façon de téléporter les joueurs entre les serveurs, voir Téléportation entre les lieux .

Résumé

Propriétés

  • Le code d'accès réservé qui indique le serveur réservé auquel le téléport doit appartenir.

  • Lecture parallèle

    Le DataModel.JobId de l'instance de serveur à laquelle vous voulez vous téléporter.

  • Lecture parallèle

    Une valeur de drapeau pour indiquer si un serveur réservé doit être attribué et que les joueurs devraient ensuite être téléportés à cet endroit d'attribution.

Méthodes

Propriétés

ReservedServerAccessCode

Lecture parallèle

Cette propriété indique le code d'accès réservé pour le serveur réservé auquel les utilisateurs devraient être téléportés.

Pour plus d'informations sur la façon de téléporter les joueurs entre les serveurs, voir Téléportation entre les lieux .

ServerInstanceId

Lecture parallèle

Cette propriété indique le DataModel.JobId de l'instance du serveur auquel les utilisateurs devraient être téléportés.

Pour plus d'informations sur la façon de téléporter les joueurs entre les serveurs, voir Téléportation entre les lieux .

ShouldReserveServer

Lecture parallèle

Cette propriété indique si le appel de téléportation doit créer un nouveau serveur réservé. Lorsqu'il est réglé sur vrai, un serveur réservé sera créé et les joueurs seront téléportés sur le nouveau serveur.

Si elle est réglée sur false, le joueur(s) sera(ont) téléporté(s) sur le serveur public avec le TeleportOptions.ServerInstanceId spécifié s'il est fourni. Lorsque TeleportOptions.ServerInstanceId est vide ou n'a pas de serveur correspondant, un nouveau serveur public sera créé pour téléporter les joueur(s) à.

Pour plus d'informations sur la façon de téléporter les joueurs entre les serveurs, voir Téléportation entre les lieux .

Méthodes

GetTeleportData

Variant

Cette fonction renvoie les données de téléportation stockées dans l'instance TeleportOptions par TeleportOptions:SetTeleportData().

Une fois qu'un joueur s'est téléporté, les données de téléportation peuvent être récupérées en utilisant les fonctions Player:GetJoinData() et TeleportService:GetLocalPlayerTeleportData().

Pour plus d'informations sur la façon de téléporter les joueurs entre les serveurs, voir Téléportation entre les lieux .


Retours

Variant

SetTeleportData

void

Ceci est une fonction de réglage pour les données à transmettre au emplacementde destination. Sur le emplacementde destination, ces données peuvent être récupérées en utilisant Player:GetJoinData() ou TeleportService:GetLocalPlayerTeleportData() .

Par exemple, le code suivant envoie le DataModel.PlaceId et DataModel.JobId dans un dictionnaire en utilisant une instance TeleportOptions utilisant 1> Class.TeleportOptions:SetTeleportData()1> :


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

Ces données pourraient ensuite être récupérées en arrivant à l'aide de la fonction GetLocalPlayerTeleportData() comme suivant :


-- Client
local TeleportService = game:GetService("TeleportService")
local teleportData = TeleportService:GetLocalPlayerTeleportData()
if teleportData then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

Si aucun teleportData n'a été défini dans la fonction de téléportation, ce GetLocalPlayerTeleportData() retournera nil.

Pour plus d'informations sur l'envoi et la réception des données de l'utilisateur ainsi que les téléports, voir, voir Téléportation entre les lieux .

Paramètres

teleportData: Variant

Les données à transmettre au emplacementde destination.


Retours

void

Évènements