TeleportOptions

Mostrar obsoleto

*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

Métodos

Propriedades

ReservedServerAccessCode

Ler Parallel

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

Ler Parallel

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

Ler Parallel

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

Variant

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

Variant

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() :


-- Servidor
local 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:


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

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

teleportData: Variant

Dados a serem passados para o local de destino.

Valor Padrão: ""

Devolução

()

Eventos