メインコンテンツまでスキップ

スクリプティング

スクリプトは、PlayCanvas におけるインタラクティブ性の中心です。これは再利用可能なコードのパーツであり、エンティティにアタッチすることで、挙動の定義、ユーザー入力の処理、ゲームロジックの管理など、プロジェクトに命を吹き込みます。

2つのスクリプティングシステム

PlayCanvas では、2つのスクリプト方式をサポートしています:

  • ESMスクリプト.mjsファイル) - クラス構文を使ったモダンなESモジュールベースのスクリプト。新規プロジェクトにはこちらを推奨します。
  • クラシックスクリプト.jsファイル) - プロトタイプベースの構文を使った、元々のPlayCanvasスクリプティングシステム。

両方のシステムは同一プロジェクト内で共存できるため、徐々に移行することも、自分に合った方式を選ぶことも可能です。

クイック例

以下は、エンティティを回転させる簡単なスクリプトです:

import { Script } from 'playcanvas';

export class Rotate extends Script {
static scriptName = 'rotate';

/** @attribute */
speed = 10;

update(dt) {
this.entity.rotate(0, this.speed * dt, 0);
}
}

学べること

基礎知識

すべてのPlayCanvasスクリプトに共通する基本的な概念:

エディタ統合

PlayCanvasエディタ内でのスクリプトの取り扱い:

デバッグ

スクリプトのトラブルシューティングのためのツールと手法:

ヒント

PlayCanvasのスクリプティングが初めてですか? まずははじめにから基本を学び、次にモダンなアプローチであるESMスクリプトを試してみましょう。