For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ligações externas

Ligar a outras cenas ou sites externos

Pode adicionar links a partir da sua scene para outro conteúdo, quer para outras scenes quer para websites externos.

Use o Scene Editor no Creator Hub

A maneira mais fácil de adicionar um link externo ou um teleport é usar o Scene Editor. Use o Teletransportar Smart Item para adicionar um teleport para outra scene em Genesis City, ou use qualquer um dos Links Sociais smart items para adicionar links para sites externos.



Teletransportes

Para teletransportar um jogador para outra scene, chame a seguinte função, indicando as coordenadas para onde quer que os jogadores sejam teleportados.

Os jogadores veem um ecrã de confirmação antes de serem teleportados; este ecrã apresenta informações do ficheiro scene.json, incluindo a scene name, description e navmapThumbnail. Veja metadados da cena para mais detalhes sobre como definir estes dados.

Tenha em mente que os teleports levam-no para uma scene nas coordenadas indicadas, mas não necessariamente para essas mesmas coordenadas. Isto significa que, ao viajar para uma scene com vários parcels, os jogadores podem não aterrar nas mesmas coordenadas especificadas, mas sim num dos spawn points designados pelo criador da scene.

Para mover um jogador para outro conjunto de coordenadas dentro da scene atual, use o movePlayerTo() função em vez disso. Veja Mover um Jogador.

Teleportar para um WORLD

Para enviar um jogador para uma scene que não está publicada no mapa aberto de Genesis City, mas sim para um Decentraland WORLD, passe um realm como teleportTo().

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

Sem worldCoordinates, o jogador aterra num dos spawn points do destino. Adicione coordenadas para escolher um Parcel específico dentro desse World:

Os jogadores veem um ecrã de confirmação antes de mudarem de realm. Ele pergunta "Tem a certeza de que quer entrar neste World?" e mostra o destino (o nome do World, ou o host da URL do realm). O jogador só é movido se aceitar.

Para enviar um jogador de volta para Genesis City a partir de um world, não inclua o realm campo, que por omissão aponta para Genesis City.

changeRealm está obsoleto

Scenes mais antigas usavam changeRealm() para chegar a um world. Ainda funciona, mas use teleportTo({ realm }) em vez disso. changeRealm() também mostra um ecrã de confirmação; o seu message campo apenas substitui o texto padrão do aviso.

changeRealm() é resolvido assim que o jogador aceita o aviso, não quando o novo realm está realmente ativo. Uma teleportTo() chamada logo a seguir iria ser executada no realm antigo e colocaria o jogador no lugar errado. teleportTo({ realm }) faz as duas etapas numa única chamada, por isso essa lacuna não existe.

Para adicionar um link para um site externo, use o openExternalUrl() comando.

Para impedir qualquer utilização abusiva desta funcionalidade para enviar spam aos jogadores, só é possível chamar o 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 timer, de uma collision area, ou de um global click event. Veja Eventos de botão para mais detalhes sobre como fazer isto.

Quando openExternalUrl é chamada, os jogadores veem um ecrã de confirmação, onde são informados de para onde o link os levará e onde podem aceitar ou recusar visitar o link.

O link é aberto num novo separador, mantendo o separador original no Decentraland.

Se os jogadores assinalarem a confiar neste domínio caixa de verificação, não voltarão a ser avisados durante a sessão, desde que o link venha da mesma scene e seja para o mesmo domínio.

Copiar para a área de transferência

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

Atualizado