TeleportOptions
*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.
Le DataModel.JobId de l'instance de serveur à laquelle vous voulez vous téléporter.
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
Renvoie les données de téléportation stockées dans l'instance TeleportOptions par TeleportOptions:SetTeleportData().
Définir la fonction de sélection pour que les données soient envoyées à l'emplacementdestination.
Propriétés
ReservedServerAccessCode
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
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
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
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
SetTeleportData
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> :
-- Serveurlocal 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 :
-- Clientlocal TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
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
Les données à transmettre au emplacementde destination.