Acciones restringidas

El RestrictedActions módulo permite a las escenas acceder a funcionalidades sensibles (y por tanto restringidas). Está vinculado al sistema de permisos que las escenas usan para solicitar el uso de métodos individuales.

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

Como implementador de World Explorer, tu runtime podría no aplicar ninguna restricción de permisos. Nosotros recomendamos encarecidamente que no lo hagas, ya que pone a los jugadores en peligro.

La mayor parte de la funcionalidad restringida es proporcionada por este módulo, pero también hay funciones globales restringidas.

El módulo contiene los siguientes métodos y tipos:

• function movePlayerTo

• function teleportTo

• function triggerEmote

• function changeRealm

• function openExternalUrl

• function openNftDialog

• function setCommunicationsAdapter

• interface Vector3

Métodos

Cada uno de los métodos abajo está asociado con un sistema de permisos que puede ser solicitado en el manifiesto de la escena.

movePlayerTo

Desplaza al jugador a una nueva posición relativa a la actual, y opcionalmente establece el objetivo de la cámara con vectores.

Requiere el ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE permiso.

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

interface Response {
    // Una vez que el jugador se haya movido a la nueva posición, y si el jugador no interrumpió el movimiento, esto será true.
  success: boolean;
}

function movePlayerTo(Request): Promise<Response>;

teleportTo

Reubica al jugador en una ubicación absoluta del mundo dada por un vectores.

En lugar de requerir un permiso preaprobado, cada llamada a teleportTo debe ser aprobada por el jugador.

interface Request {
  worldPosition: Vector3;
}

interface Response {}

function teleportTo(Request): Promise<Response>;

triggerEmote

Hace que el avatar del jugador muestre una animación de emote, usando uno de los nombres predefinidos.

Requiere el ALLOW_TO_TRIGGER_AVATAR_EMOTE permiso.

interface Request {
  predefinedEmote: string;
}

interface Response {}

function triggerEmote(Request): Promise<Response>;

openExternalUrl

Ofrecer mostrar un sitio web al jugador, usando una UI apropiada (que puede ser otra aplicación).

Requiere el OPEN_EXTERNAL_LINK permiso.

interface Request {
  url: string;
}

interface Response {
  // Si el jugador autorizó abrir el enlace.
  success: boolean;
}

function openExternalUrl(Request): Promise<Response>;

openNftDialog

Mostrar información sobre un NFT al jugador, usando una UI apropiada.

interface Request {
  // El URN del NFT.
  urn: string;
}

interface Response {
  // Si el NFT fue localizado correctamente y se refirió a una imagen o video.
  success: boolean;
}

function openNftDialog(Request): Promise<Response>;

changeRealm

Cambiar el World Explorer a otro servidor de contenido, usando su URL base.

interface Request {
  // La URL del nuevo realm.
  realm: string;

  // Un mensaje opcional para mostrar a los usuarios cuando tengan que aprobar el cambio.
  message?: string;
}

interface Response {
  // Si el cambio de realm fue autorizado y exitoso.
  success: boolean;
}

function changeRealm(Request): Promise<Response>;

Tipos

El único tipo adicional usado por los métodos de este módulo es el Vector3.

Vector3

Contiene una posición 3D relativa o absoluta.

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