TeleportOptions
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Esta classe é um parâmetro opcional para a função TeleportService:TeleportAsync() que permite que os desenvolvedores forneçam argumentos para a chamada de teletransporte.
Alguns argumentos nesta classe não são compatíveis entre si e causam um erro ao serem passados para TeleportService:TeleportAsync():
- Código de Acesso Reservado ao Servidor + ID de Instância do Servidor
- ShouldReserveServer + ServerInstanceId
- ShouldReserveServer + ReservadoServidorAccessCode
Para mais informações sobre como teletransportar jogadores entre servidores, veja Teletransporte entre locais.
Resumo
Propriedades
O código de acesso ao servidor reservado que indica o servidor reservado para o qual o teletransporte deve ser feito.
O DataModel.JobId da instância do servidor para se teletransportar.
Uma bandeira para indicar se um servidor reservado deve ser alocado e os jogadores devem então ser teletransportados para essa alocação.
Métodos
Retorna os dados de teletransporte armazenados na instância TeleportOptions por TeleportOptions:SetTeleportData() .
Função de definidor para dados a serem passados para o local de destino.
Propriedades
ReservedServerAccessCode
Essa propriedade indica o código de acesso ao servidor reservado para o servidor reservado ao qual o usuário(s) devem ser teletransportados.
Para mais informações sobre como teletransportar jogadores entre servidores, veja Teletransporte entre locais.
ServerInstanceId
Essa propriedade indica o DataModel.JobId da instância do servidor para a qual o usuário(s) devem ser teletransportados.
Para mais informações sobre como teletransportar jogadores entre servidores, veja Teletransporte entre locais.
ShouldReserveServer
Essa propriedade indica se a chamada de teletransporte deve criar um novo servidor reservado.Quando definido como verdadeiro, um servidor reservado será criado e os jogadores(s) serão teletransportados para o novo servidor.
Se definido como falso, o(s) jogador(es) será(ão) teletransportado(s) para o servidor público com o TeleportOptions.ServerInstanceId se fornecido.Quando TeleportOptions.ServerInstanceId está vazio ou nenhum servidor correspondente é encontrado, um novo servidor público será criado para teletransportar o(s) jogador(es).
Para mais informações sobre como teletransportar jogadores entre servidores, veja Teletransporte entre locais.
Métodos
GetTeleportData
Essa função retorna os dados de teletransporte armazenados na instância TeleportOptions por TeleportOptions:SetTeleportData().
Uma vez que um jogador tenha se teletransportado, os dados de teletransporte podem ser recuperados usando as funções Player:GetJoinData() e TeleportService:GetLocalPlayerTeleportData().
Para mais informações sobre como teletransportar jogadores entre servidores, veja Teletransporte entre locais.
Devolução
SetTeleportData
Esta é uma função de definidor para dados a serem passados para o local de destino.No local de destino, esses dados podem ser recuperados usando Player:GetJoinData() ou TeleportService:GetLocalPlayerTeleportData().
Por exemplo, o seguinte trecho enviaria o DataModel.PlaceId e DataModel.JobId em um dicionário que passa os dados de teletransporte em uma instância TeleportOptions usando TeleportOptions:SetTeleportData() :
-- Servidorlocal teleportOptions = Instance.new("TeleportOptions")local teleportData = {placeId = game.PlaceId,jobId = game.JobId}teleportOptions:SetTeleportData(teleportData)TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)
Esses dados podem então ser recuperados na chegada usando a função GetLocalPlayerTeleportData() como segue:
-- Clientelocal TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
Se nenhum teleportData foi definido na função de teletransporte, este GetLocalPlayerTeleportData() retornará nil .
Para mais informações sobre como enviar e receber dados do usuário junto com teletransportes, veja Teletransporte entre locais.
Parâmetros
Dados a serem passados para o local de destino.