Acciones restringidas

El RestrictedActions el módulo permite que las scenes accedan a funcionalidades sensibles (y por tanto restringidas). Está vinculado al permission system, que las scenes usan para solicitar el uso de métodos individuales.

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

Como implementador de World Explorer, tu runtime podría no hacer cumplir permisos. Nosotros strongly desaconsejamos esto, ya que pone en peligro a los jugadores.

La mayor parte de la funcionalidad restringida la proporciona este módulo, pero también existen global functions.

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 permission que puede solicitarse en el scene manifest.

movePlayerTo

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

Requiere el ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE permission.

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

interface Response {}

function movePlayerTo(Request): Promise<Response>;

teleportTo

Reubica al jugador a una ubicación absoluta del mundo dada por un vectors.

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 permission.

interface Request {
  predefinedEmote: string;
}

interface Response {}

function triggerEmote(Request): Promise<Response>;

openExternalUrl

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

Requiere el OPEN_EXTERNAL_LINK permission.

interface Request {
  url: string;
}

interface Response {
  // Whether the player authorized opening the link.
  success: boolean;
}

function openExternalUrl(Request): Promise<Response>;

openNftDialog

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

interface Request {
  // The URN of the NFT.
  urn: string;
}

interface Response {
  // Whether the NFT was successfully located and referred to an image or video.
  success: boolean;
}

function openNftDialog(Request): Promise<Response>;

changeRealm

Cambia el World Explorer a otro content server, usando su URL base.

interface Request {
  // The URL of the new realm.
  realm: string;

  // An optional message to show users when they have to approve the change.
  message?: string;
}

interface Response {
  // Whether the realm change was authorized and successful.
  success: boolean;
}

function changeRealm(Request): Promise<Response>;

Tipos

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

Vector3

Contiene una posición 3D relativa o absoluta.

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