실행

런타임은 장면 일반적인 Node 모듈처럼 취급합니다. 샌드박스가 설정되면(즉, 모든 전역 객체 가 주입되고 모듈을 로드될 준비가 되면), 씬의 코드가 평가되어 다음을 채울 수 있게 됩니다: exports 객체.

호스트는 다음에서 두 메서드를 가져옵니다 exports: onStart (선택 사항) 및 onUpdate (필수).

type Exports = {
  onStart?: () => Promise<void>;
  onUpdate: (deltaSeconds: number) => Promise<void>;
};

씬의 라이프사이클 동안, 런타임은 이러한 메서드에 대한 호출이 동시에 이루어지지 않도록 보장합니다. 반환된 Promise 는 씬이 새 호출을 받기 전에 항상 await됩니다.

Unexpected error with integration mermaid: Integration is not installed on this space

개별 씬과 게임 렌더링 엔진 간의 효과적이고 성능 좋은 동기화는 복잡한 문제입니다. Foundation의 구현에서 얻을 수 있는 교훈은 ADR-148.

onStart

씬의 라이프사이클은 비동기 onStart 메서드로 시작합니다. 첫 번째 호출이 이루어지기 전에 완료되어야 하는 일회성 초기화를 수행하는 곳입니다. onUpdate 가 이루어집니다.

onStart(): Promise<void>

씬은 이 호출을 사용해 런타임에서 미리 존재하는 상태(예: 기본 엔티티)를 요청하고 자체 초기 설정을 수행합니다.

내보내기 onStart 는 모든 씬에 권장되며(SDK를 사용할 때는 자동으로 수행됨), 프로토콜상 필수는 아닙니다. 해당 메서드는 없을 수도 있으며, 즉시 이행되는 Promise.

onUpdate

씬이 활발하게 실행되는 동안, 비동기 onUpdate 메서드는 시간이 흐르는 것을 보고하기 위해 런타임에 의해 주기적으로 호출됩니다. 이것이 씬의 핵심입니다. 각 연속 호출마다 엔티티를 업데이트하고, 입력을 처리하고, 애니메이션을 재생하고, 메시지를 보내고, UI를 표시하는 등의 작업을 할 수 있습니다.

onUpdate(deltaSeconds: number): Promise<void>

이 deltaSeconds 매개변수는 마지막 호출 이후 경과한 초의 소수 값입니다 onUpdate 가 런타임에 의해 시작된 시점부터의 시간입니다(반환된 Promise 가 이행되었는지와 무관하게).

이 값은 실행 중인 각 씬마다 고유합니다. onUpdate 왜냐하면 deltaSeconds 호출이 절대 겹치지 않기 때문에, 다음의 순서는 일관된 타임라인을 만듭니다.

이상적인 상황에서는, 씬은 실행될 기회를 얻어 onUpdate 각 프레임이 렌더링되기 전에 실행됩니다. 그러나 사용 가능한 리소스에 따라, 작업량이 많은 씬은 그 Promise 다음 프레임까지 제때 이행하지 못할 수 있습니다. 이 점에서 각 씬은 독립적입니다: 다음의 경량 구현은 onUpdate 다른 씬의 하나의 오래 걸리는 호출과 같은 기간 동안 여러 번 호출될 수 있습니다.

참고 ADR-148 자세한 내용은.

여러 씬 실행

World Explorer는 여러 개의 샌드박스화된 씬 실행을 지원해야 할 뿐만 아니라, 항상 그렇게 동작해야 합니다. 이유는 두 가지입니다:

첫째, 플레이어가 월드를 탐험할 때 그들의 시야는 서 있는 씬의 지리적 경계를 넘어섭니다. 플레이어가 볼 수 있어야 하는 콘텐츠를 생성하려면 근처의 씬(임의 또는 구성 가능한 거리까지)이 실행 중이어야 합니다.

둘째, 씬은 서로 겹치지 않는 자신만의 경계 안에서만 실행되는 것이 아닙니다. 서로 위에 겹쳐질 수도 있으며, 플레이어 주변 영역에 영향을 주면서도 서로 다른 기능을 제공합니다.

특히 두 종류의 씬에서 그렇습니다: 아바타 씬과 휴대형 경험입니다.

아바타 씬

플레이어가 월드에 들어서는 순간부터, 다른 플레이어의 아바타를 렌더링하는 역할을 맡은 전역 씬이 실행되기 시작합니다.

이 씬은 지리적 경계의 제한을 받지 않으며, 플레이어의 위치와 관계없이 해당 엔티티(및 소통을 위한 UI 위젯)를 표시할 수 있습니다.

휴대형 경험

Decentraland에서는 웨어러블이 자체 동작을 가질 수 있으며, 이는 자체 씬 컨텍스트에서 실행됩니다. 이러한 씬은 플레이어를 중심으로 하며, 엔티티를 추가하거나 UI 위젯을 표시하여 경험을 풍부하게 할 수 있습니다.

이들은 웨어러블이 착용되면 실행을 시작하고, 제거되면 중지됩니다.

이전전역 변수

다음권한

마지막 업데이트 10개월 전