> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/external-links.md).

# Ligações externas

Ligar a outras cenas ou sites externos

Pode adicionar links da sua cena para outros conteúdos, sejam outras cenas ou sites externos.

## Usar o Scene Editor no Creator Hub

A forma mais fácil de adicionar um link externo ou um teletransporte é usar o Scene Editor. Use o **Teleport** [Smart Item](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para adicionar um teletransporte para outra cena em Genesis City, ou use qualquer um dos **Social Links** smart items para adicionar links para sites externos.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0b3c5ce7dcf74af234c0d02b6adccbd2d401e2f6%2Fsocial-links.webp?alt=media)

## Teletransportes

Para teletransportar um jogador para outra cena, chame a seguinte função e indique as coordenadas para onde quer teletransportar os jogadores.

```ts
import { teleportTo } from "~system/RestrictedActions"

(...)

teleportTo({ worldCoordinates: { x: -51, y: 1 } })
```

É apresentado aos jogadores um ecrã de confirmação antes do teletransporte. Esse ecrã mostra informações do `scene.json file`da cena de destino, incluindo o `name`, `description` e o `navmapThumbnail`. Consulte [metadados da cena](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md) para saber como definir estes dados.

Tenha em atenção que os teletransportes levam os jogadores para uma cena nas coordenadas indicadas, mas não necessariamente para essas mesmas coordenadas dentro da cena. Isto significa que, ao viajar para uma cena com vários parcels, os jogadores podem não chegar às coordenadas especificadas, mas sim a um dos pontos de spawn definidos pelo criador da cena.

Para mover um jogador para outro conjunto de coordenadas dentro da cena atual, use a função `movePlayerTo()` em vez disso. Consulte [Mover um jogador](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/move-player.md).

## Teletransportar para um WORLD

Para enviar um jogador para uma cena que não está publicada no mapa aberto de Genesis City, mas sim para um [WORLD de Decentraland](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds)isolado, passe um `realm` a `teleportTo()`.

```ts
import { teleportTo } from "~system/RestrictedActions"

(...)

teleportTo({ realm: 'mannakia.dcl.eth' })
```

`realm` aceita um nome de World, como `mannakia.dcl.eth`, ou um URL de realm.

Sem `worldCoordinates`, o jogador chega a um dos pontos de spawn do destino. Adicione coordenadas para escolher um parcel específico dentro desse World:

```ts
// Chegar ao parcel 12,34 de um World específico
teleportTo({
	realm: 'mannakia.dcl.eth',
	worldCoordinates: { x: 12, y: 34 },
})
```

É apresentado aos jogadores um ecrã de confirmação antes de mudarem de realm. É-lhes perguntado *"Tem a certeza de que quer entrar neste World?"* e é apresentado o destino (o nome do World ou o anfitrião do URL do realm). O jogador só é transferido se aceitar.

Para enviar um jogador de volta a Genesis City a partir de um world, não inclua o `realm` campo, que tem Genesis City como valor predefinido.

{% hint style="warning" %}
**📔 Nota**: O campo `realm` requer a versão `@dcl/sdk` 7.28.0 ou posterior.
{% endhint %}

### changeRealm está descontinuado

As scenes mais antigas usavam `changeRealm()` para chegar a um world. Continua a funcionar, mas use `teleportTo({ realm })` em vez disso. `changeRealm()` também apresenta um ecrã de confirmação; o campo opcional `message` apenas substitui o texto predefinido da mensagem.

`changeRealm()` é resolvida assim que o jogador aceita a mensagem, não quando o novo realm está efetivamente ativo. Uma chamada a `teleportTo()` imediatamente a seguir seria executada no **antigo** realm e levaria o jogador ao local errado. `teleportTo({ realm })` faz ambos os passos numa só chamada, por isso esse intervalo não existe.

## Ligações externas

Para adicionar uma ligação a um site externo, use o comando `openExternalUrl()` .

```ts
import { openExternalUrl } from '~system/RestrictedActions'

openExternalUrl({ url: 'google.com' })
```

Para evitar qualquer utilização abusiva desta funcionalidade para enviar spam aos jogadores, só é possível chamar `openExternalUrl` a partir de um clique explícito ou de um evento de botão numa entity. Não é possível chamar esta função como resultado de um temporizador, de uma área de colisão ou de um evento de clique global. Consulte [Eventos de botão](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/click-events.md) para saber como o fazer.

Quando `openExternalUrl` é chamada, os jogadores veem um ecrã de confirmação que informa para onde a ligação os levará e onde podem aceitar ou recusar visitar a ligação.

A ligação é aberta num novo separador, mantendo o separador original no Decentraland.

Se os jogadores assinalarem a caixa de seleção *confiar neste domínio* , não lhes será pedida confirmação novamente durante a sessão, desde que a ligação venha da mesma scene e seja para o mesmo domínio.

## Abrir painéis da UI do Explorer

Além de sites externos, a sua scene pode abrir os próprios painéis do Explorer, como o mapa, as definições ou a mochila, com a ação restrita `openExplorerUi()` . A chamada tem de ser uma resposta direta a algo em que o jogador clicou ou que premiu, e as regras para determinar o que é válido não são iguais às anteriores. Consulte [Abrir painéis do Explorer](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/event-listeners.md#open-explorer-panels) para obter a referência completa, incluindo o que conta como uma ação do jogador e como aguardar até que o jogador feche o painel.

## Copiar para a área de transferência

Para copiar uma string para a área de transferência do jogador, use `copyToClipboard()`. Depois disso, quando o jogador *colar* no chat do Decentraland ou em qualquer outra aplicação no computador, estará a colar a sua string.

```ts
import { copyToClipboard } from "~system/RestrictedActions"

copyToClipboard( { text: 'My text to copy' } )
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/external-links.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
