Ações Restritas

O RestrictedActions módulo permite que cenas acessem funcionalidades sensíveis (e portanto restritas). Está ligado ao permission sistema, que as cenas usam para solicitar o uso de métodos individuais.

const RestrictedActions = require("~system/RestrictedActions");

Como implementador do World Explorer, seu runtime pode não aplicar permissões. Nós fortemente aconselhamos contra isso, pois coloca os jogadores em perigo.

A maior parte da funcionalidade restrita é fornecida por este módulo, mas também existem global functions.

O módulo contém os seguintes métodos e tipos:

• function movePlayerTo

• function teleportTo

• function triggerEmote

• function changeRealm

• function openExternalUrl

• function openNftDialog

• function setCommunicationsAdapter

• interface Vector3

Methods

Cada um dos métodos abaixo está associado a uma permission que pode ser solicitada no manifesto da cena.

movePlayerTo

Desloca o jogador para uma nova posição relativa à atual e, opcionalmente, define o alvo da câmera com vectors.

Exige a ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE permission.

interface Request {
  newRelativePosition: Vector3;
  cameraTarget?: Vector3;
}

interface Response {
    // Uma vez que o jogador tenha se movido para a nova posição, e se o jogador não interrompeu o movimento, isto será verdadeiro.
  success: boolean;
}

function movePlayerTo(Request): Promise<Response>;

teleportTo

Reposiciona o jogador para uma localização absoluta no mundo dada por um vectors.

Em vez de exigir uma permissão pré-aprovada, cada chamada a teleportTo deve ser aprovada pelo jogador.

interface Request {
  worldPosition: Vector3;
}

interface Response {}

function teleportTo(Request): Promise<Response>;

triggerEmote

Faz o avatar do jogador exibir uma animação de emote, usando um dos nomes predefinidos.

Exige a ALLOW_TO_TRIGGER_AVATAR_EMOTE permission.

interface Request {
  predefinedEmote: string;
}

interface Response {}

function triggerEmote(Request): Promise<Response>;

openExternalUrl

Oferece mostrar um site ao jogador, usando uma UI apropriada (que pode ser outra aplicação).

Exige a OPEN_EXTERNAL_LINK permission.

interface Request {
  url: string;
}

interface Response {
  // Se o jogador autorizou a abertura do link.
  success: boolean;
}

function openExternalUrl(Request): Promise<Response>;

openNftDialog

Mostra informações sobre um NFT ao jogador, usando uma UI apropriada.

interface Request {
  // O URN do NFT.
  urn: string;
}

interface Response {
  // Se o NFT foi localizado com sucesso e referenciou uma imagem ou vídeo.
  success: boolean;
}

function openNftDialog(Request): Promise<Response>;

changeRealm

Altera o World Explorer para outro servidor de conteúdo, usando sua URL base.

interface Request {
  // A URL do novo realm.
  realm: string;

  // Uma mensagem opcional para mostrar aos usuários quando eles tiverem que aprovar a mudança.
  message?: string;
}

interface Response {
  // Se a mudança de realm foi autorizada e bem-sucedida.
  success: boolean;
}

function changeRealm(Request): Promise<Response>;

Types

O único tipo adicional usado pelos métodos deste módulo é o Vector3.

Vector3

Mantém uma posição 3D relativa ou absoluta.

interface Vector3 {
  x: number;
  y: number;
  z: number;
}