제한된 작업

그 RestrictedActions 모듈은 장면이 민감한(따라서 제한된) 기능에 접근할 수 있게 합니다. 이는 권한 시스템과 연결되어 있으며, 장면은 이를 사용해 개별 메서드의 사용을 요청합니다.

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

World Explorer 구현자로서, 런타임에 권한 강제가 전혀 없을 수도 있습니다. 우리는 강력히 이를 권장하지 않습니다. 플레이어를 위험에 빠뜨리기 때문입니다.

제한된 기능의 대부분은 이 모듈에서 제공되지만, 제한된 전역 함수.

이 모듈에는 다음 메서드와 타입이 포함되어 있습니다:

• function movePlayerTo

• function teleportTo

• function triggerEmote

• function changeRealm

• function openExternalUrl

• function openNftDialog

• function setCommunicationsAdapter

• interface Vector3

메서드

아래 각 메서드는 특정 권한 장면 매니페스트에서 요청할 수 있는 항목과 연결됩니다.

movePlayerTo

플레이어를 현재 위치를 기준으로 한 새 위치로 이동시키고, 필요하면 카메라 타깃을 다음으로 설정합니다: 벡터.

다음이 필요합니다: ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE 권한.

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

인터페이스 Response {
    // 플레이어가 새 위치로 이동한 뒤, 그리고 플레이어가 이동을 중단하지 않았다면 이는 true가 됩니다.
  success: boolean;
}

function movePlayerTo(Request): Promise<Response>;

teleportTo

플레이어를 특정 파셀로 재배치하며, 필요하면 다른 렐름으로 이동할 수 있습니다.

사전에 승인된 권한을 요구하는 대신, 각 호출은 teleportTo 플레이어의 승인을 받아야 합니다.

interface Request {
  // 착지할 파셀입니다. 생략 시: 렐름의 기본 스폰
  // (realm과 함께 사용할 때만 의미가 있습니다).
  worldCoordinates?: Vector2;

  // 파셀이 속한 렐름: 월드 이름(`foo.dcl.eth`) 또는 렐름 URL.
  // 설정하면, 클라이언트는 렐름을 변경하고(완전한 재연결, 플레이어가 이미
  // 해당 렐름에 있더라도) 그런 다음 그곳의 파셀에 착지합니다.
  // 생략 시: 파셀은 플레이어의 현재 렐름에 있습니다.
  realm?: string;
}

interface Response {}

function teleportTo(Request): Promise<Response>;

triggerEmote

미리 정의된 이름 중 하나를 사용해 플레이어의 아바타에 감정 표현 애니메이션을 표시합니다.

다음이 필요합니다: ALLOW_TO_TRIGGER_AVATAR_EMOTE 권한.

interface Request {
  predefinedEmote: string;
}

interface Response {}

function triggerEmote(Request): Promise<Response>;

openExternalUrl

적절한 UI(다른 애플리케이션일 수도 있음)를 사용해 플레이어에게 웹사이트 표시를 제안합니다.

다음이 필요합니다: OPEN_EXTERNAL_LINK 권한.

interface Request {
  url: string;
}

인터페이스 Response {
  // 플레이어가 링크 열기를 승인했는지 여부.
  success: boolean;
}

function openExternalUrl(Request): Promise<Response>;

openNftDialog

적절한 UI를 사용해 플레이어에게 NFT 정보를 표시합니다.

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

인터페이스 Response {
  // NFT를 성공적으로 찾았고 이미지나 비디오로 참조되었는지 여부.
  success: boolean;
}

function openNftDialog(Request): Promise<Response>;

changeRealm (사용 중단됨)

기본 URL을 사용해 World Explorer를 다른 콘텐츠 서버로 전환합니다.

다음의 사용을 권장하며 더 이상 사용되지 않습니다: teleportTo 다음과 함께: 렐름 (그리고 없음 worldCoordinates 렐름의 기본 스폰 위치에 대해). changeRealm 새 렐름이 활성화될 때가 아니라 변경이 승인되는 즉시 resolve되므로, teleportTo 그 직후에 발행된 것은 이전 렐름을 대상으로 실행됩니다.

interface Request {
  // 새 렐름의 URL.
  realm: string;

  // 변경을 승인해야 할 때 사용자에게 표시할 선택적 메시지.
  message?: string;
}

인터페이스 Response {
  // 렐름 변경이 승인되었고 성공했는지 여부.
  success: boolean;
}

function changeRealm(Request): Promise<Response>;

타입

이 모듈의 메서드에서 사용되는 추가 타입은 오직 다음입니다: Vector3.

Vector3

상대적 또는 절대적인 3D 위치를 보관합니다.

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