본문으로 건너뛰기

엔진 API 호출 (Calling the Engine API)

OasisW 스크립트를 작성할 때는 OasisW Engine API를 사용합니다. 이 페이지에서는 스크립트에서 가장 자주 사용하게 될 핵심 클래스와 패턴을 다룹니다.

스크립트 작성자를 위한 핵심 클래스​

스크립트 컨텍스트​

모든 스크립트는 이러한 핵심 객체에 접근할 수 있습니다:

this.app        // 메인 애플리케이션 (AppBase)
this.entity     // 이 스크립트가 연결된 엔티티
중요

this.app과 this.entity는 스크립트 인스턴스에서 정의된 메서드(initialize, update 등) 내에서만 유효합니다. JavaScript의 this 키워드에 대해 더 알아보세요.

핵심 클래스​

AppBase - 애플리케이션

// 일반적인 앱 작업
this.app.fire('game:start');
const player = this.app.root.findByName('Player');
const texture = this.app.assets.find('logo', 'texture');

Entity - 씬의 객체

// 일반적인 엔티티 작업
this.entity.setPosition(0, 5, 0);
this.entity.rotate(0, 90, 0);
const child = this.entity.findByName('Weapon');

Component - 엔티티에 기능 추가

// 컴포넌트 접근
const camera = this.entity.camera;
const light = this.entity.light;
const rigidbody = this.entity.rigidbody;
const sound = this.entity.sound;

수학 클래스​

계산과 변환을 위해 이를 가져오세요:

import { Vec3, Quat, Color } from 'playcanvas';

const position = new Vec3(0, 5, 0);
const rotation = new Quat();
const red = new Color(1, 0, 0);

일반적인 스크립트 패턴​

엔티티 찾기​

// 이름으로 (전체 계층 구조 검색)
const player = this.app.root.findByName('Player');

// 태그로 (배열 반환)
const enemies = this.app.root.findByTag('enemy');

// 현재 엔티티를 기준으로
const weapon = this.entity.findByPath('Arms/RightHand/Weapon');

에셋 작업​

// 에셋 찾기 및 로드
const sound = this.app.assets.find('explosion', 'audio');
sound.ready(() => {
    this.entity.sound.play('explosion');
});
this.app.assets.load(sound);

이벤트 및 통신​

// 애플리케이션 이벤트 발생
this.app.fire('player:died', this.entity);

// 이벤트 수신
this.app.on('game:start', this.onGameStart, this);

더 알아보기​