README-kr.md
| 사용자 매뉴얼 | API 레퍼런스 | 예제 | 블로그 | 포럼 |
PlayCanvas는 WebGL2와 WebGPU 기반의 오픈소스 게임 엔진입니다. 모든 브라우저, 모든 디바이스에서 실행되는 인터랙티브 3D 앱, 게임 및 시각화를 만들 수 있습니다.
npm install playcanvas
또는 create-playcanvas로 몇 초 만에 프로젝트를 생성할 수 있습니다:
npm create playcanvas@latest
여기에 아주 간단한 Hello World의 예가 있습니다 - 회전하는 큐브!
import {
Application,
Color,
Entity,
FILLMODE_FILL_WINDOW,
RESOLUTION_AUTO
} from 'playcanvas';
const canvas = document.createElement('canvas');
document.body.appendChild(canvas);
const app = new Application(canvas);
// fill the available space at full resolution
app.setCanvasFillMode(FILLMODE_FILL_WINDOW);
app.setCanvasResolution(RESOLUTION_AUTO);
// ensure canvas is resized when window changes size
window.addEventListener('resize', () => app.resizeCanvas());
// create box entity
const box = new Entity('cube');
box.addComponent('render', {
type: 'box'
});
app.root.addChild(box);
// create camera entity
const camera = new Entity('camera');
camera.addComponent('camera', {
clearColor: new Color(0.1, 0.2, 0.3)
});
app.root.addChild(camera);
camera.setPosition(0, 0, 3);
// create directional light entity
const light = new Entity('light');
light.addComponent('light');
app.root.addChild(light);
light.setEulerAngles(45, 0, 0);
// rotate the box according to the delta time since the last frame
app.on('update', dt => box.rotate(10 * dt, 20 * dt, 30 * dt));
app.start();
이 코드를 직접 시도하려면 CodePen를 클릭하세요.
PlayCanvas 엔진을 기반으로 하는 로컬 개발 환경 설정에 대한 전체 가이드는 여기에서 찾을 수 있습니다.
PlayCanvas는 완전한 기능의 게임 엔진입니다.
원하는 방식으로 PlayCanvas를 사용하여 개발하세요:
| 패키지 | 설명 |
|---|---|
playcanvas | 코어 엔진 (현재 페이지) |
@playcanvas/react | PlayCanvas용 React 렌더러 |
@playcanvas/web-components | 커스텀 엘리먼트를 통한 선언적 3D |
create-playcanvas | 프로젝트 스캐폴딩 CLI |
| PlayCanvas 에디터 | 브라우저 기반 비주얼 에디터 |
PlayCanvas 엔진을 사용하여 많은 게임과 앱이 공개되어 있습니다. 다음은 그 일부를 소개하겠습니다.
다른 게임은 PlayCanvas 웹사이트에서 볼 수 있습니다.
PlayCanvas는 비디오 게임, 광고, 시각화 분야에서 대기업에 채용되고 있습니다.
Animech, Arm, BMW, Disney, Facebook, Famobi, Funday Factory, IGT, King, Miniclip, Leapfrog, Mojiworks, Mozilla, Nickelodeon, Nordeus, NOWWA, PikPok, PlaySide Studios, Polaris, Product Madness, Samsung, Snap, Spry Fox, Zeptolab, Zynga
Node.js 18+가 설치되어 있는지 확인합니다. 그 다음 필요한 Node.js 종속성을 모두 설치합니다.
npm install
이제 다양한 빌드 옵션을 실행할 수 있습니다.
| 명령어 | 설명 | 출력 위치 |
|---|---|---|
npm run build | 모든 엔진 빌드 대상과 타입 선언을 빌드합니다 | build |
npm run docs | 엔진 API 참조 문서를 빌드합니다 | docs |