Unity 開発者向け Wonderland Engine

このページでは、Unity から Wonderland Engine へのスクリプティングのマッピングを紹介し、ソリューション構築のための違いをリストアップします。

ビデオ形式を好む場合は、YouTube チャンネルの切り替えガイドをチェックしてみてください。

スクリプティング 

Wonderland Engine はブラウザ上で動作し、JavaScript ランタイムが組み込まれています。これは Web エンジンのスクリプティング言語として最適な選択であり、追加ダウンロードを必要としません。

スクリプトを作成するには、Wonderland Editor のアセットブラウザで右クリックし、新しい JavaScript / TypeScript コンポーネントを作成します。基本的なテンプレートが含まれていますので、すぐに始められます。

JS/TS に適した IDE は Visual Studio Code です。

Wonderland Engine の API と Unity の違いについては、コードセクションをご覧ください。

TypeScript vs JavaScript 

TypeScript は JavaScript に静的型チェックを追加し、C# に非常に近づけます。これにより、IDE のコード補完が大幅に向上します。Unity に慣れた開発者には TypeScript を推奨します。

Wonderland Engine は tsconfig.json の設定を自動的に行います。アセットブラウザから TypeScript コンポーネントを作成するだけで動作します。

パッケージング 

Unity のワークフローでは通常、エディタ内のプレビューが使用されますが、Wonderland Engine ではパッケージングが非常に速いため、ブラウザ内での最終アプリをプレビューとして使用することができます。

パッケージをリロードするたびにページがブラウザで更新されます。Views > Preferences で「Force full page reloads」を無効にすることで、さらに速いライブリロードサイクルを実現することが可能です。

アプリケーションをデプロイするには、プロジェクトの deploy フォルダの内容をウェブサーバーにアップロードするだけです。または、Views > Plugins でアクティベートできる “Wonderland Cloud Publish” プラグインを使用してアップロードすることも可能です。

複数のシーン 

Wonderland Engine では、multiple project files(.wlp) で作成された複数のシーンを切り替えることができます。シーン切り替えチュートリアルをご覧ください。

また、ランタイム中にシーンの一部をストリームすることも可能です。Streaming .bin Files チュートリアルをご覧ください。

プレハブ 

Wonderland Engine にはプレハブに相当する機能はまだありませんが、シーンでプロトタイプを設定し、object.clone() でその階層とすべてのコンポーネントを複製することができます。

あるいは、プレハブオブジェクトを別のシーンに移動し、ランタイム中に engine.loadPrefab(…) を使用してロードし、インスタンス化することができます。

アセットのインポート 

Wonderland Engine では、シーンファイルをインポートすると（アセットブラウザから Scene View または Scene Outline へドラッグ＆ドロップするか、画像ファイルをマテリアルのテクスチャスロットにドラッグすることで）、リンクされ、変更が監視されます。シーンファイルで見つかったリソースはプロジェクト内で使用可能になり、「Resources」ビューで確認できます。

アセットブラウザからインポートされるまでは、プロジェクトで利用できません。「アセットブラウザ」は、Unity のものとは異なるファイルブラウザと考えられます。

アセットの最適化 

インポートされたアセットはさらに最適化されます：

• メッシュは頂点数を削減するために自動デシメートが行われます
• メッシュは均一にスケーリングできます
• 画像は自動圧縮されます
• 画像は縮小可能です

これらの設定は「Resources」ビューで行います。

ディレクトリ 

• deploy にはパッケージングの最終結果が含まれています。
• static には、そのままデプロイされるファイルが含まれています。
• cache はキャッシュされたアセットコンパイル結果を含みます。通常、削除しても問題ありませんが、再生成には時間がかかります。

これらの設定は「Resources」ビューで行います。

アニメーション 

アニメーションは animation コンポーネントタイプを使用して再生されます。スキンアニメーションは、retarget チェックボックスを使ってターゲットスキンの骨/ジョイントの1つにコンポーネントをアタッチする必要があります。

キーフレーム編集および「Custom Event」キーフレームは Animation Editor でサポートされています（Views > Animation Editor を参照）。トラックブレンディングはまだサポートされていません。

物理演算 

リジッドボディは physx コンポーネントタイプを使用して作成されます。シーンはエディタ内で Debug > Simulate Physics (Shift + Alt + S) を使用してシミュレーションできます。

ネットワーキング 

ピアツーピアネットワーキングは、コミュニティサポートによる Wonderland Engine PeerJS Networking で実現可能です。

WebRTC を使用し、規模に応じてデフォルトの PeerJS サーバーインフラを利用できます。

また、コミュニティはマルチユーザーのために Colyseus を統合しています。

UI 

ユーザーインターフェースは、cursor、cursor-target、および collider コンポーネントを使用して手動でセットアップされます。

以下の HTML5 Canvas ベースの 2D UI はコミュニティによって維持されています：Lazy Widgets project。

用語 

コード 

以下に一般的なコードパターンと、Wonderland Engine での対応例を示します。

カスタムビヘイビア 

Wonderland Engine では「MonoBehaviour」の代わりに「Component」を使用します。これを書くには、Component クラスを拡張します：

 1using UnityEngine;
 2using System.Collections;
 3
 4public class MainPlayer : MonoBehaviour
 5{
 6  [field: SerializeField]
 7  public string myName;
 8
 9  string privateName;
10
11  void Start()
12  {
13    Debug.Log("My name is", this.myName, this.privateName);
14  }
15
16  void Update()
17  {
18    Debug.Log("Delta time:", Time.deltaTime);
19  }
20}

 1import {Component, Property} from '@wonderlandengine/api';
 2
 3export class MainPlayer extends Component {
 4    static TypeName = 'main-player';
 5
 6    /* プロパティはエディタで公開されます */
 7    static Properties = {
 8        myName: Property.string('Alice'),
 9    };
10
11    privateName = 'Bob';
12
13    start() {
14        console.log('My name is', this.myName, this.privateName);
15    }
16
17    update(dt) {
18        console.log('Delta time:', dt);
19    }
20}

 1import {Component} from '@wonderlandengine/api';
 2import {property} from '@wonderlandengine/api/decorators.js';
 3
 4export class MainPlayer extends Component {
 5    static TypeName = 'main-player';
 6
 7    /* プロパティはエディタで公開されます */
 8    @property.string('Alice')
 9    myName!: string;
10
11    privateName = 'Bob';
12
13    start() {
14        console.log('My name is', this.myName, this.privateName);
15    }
16
17    update(dt: number) {
18        console.log('Delta time:', dt);
19    }
20}

Unity と同様に、いくつかの UI 要素がパラメータのために生成されます。

ゲームオブジェクトにあるコンポーネントを取得 

1gameObject.GetComponent<MyComponent>();

1// 推奨される方法、型が推論されるため
2this.object.getComponent(MyComponent);
3
4// または: 型名で指定
5this.object.getComponent('my-component');

オブジェクトにコンポーネントを追加 

1MyComponent sc = gameObject.AddComponent<MyComponent>();
2sc.property = "set";

1this.object.addComponent(MyComponent, {property: 'set'});
2
3// または: 型名で指定
4this.object.addComponent('my-component', {property: 'set'});
5
6// または: アクティベーションを遅延
7const sc = this.object.addComponent('my-component', {active: false});
8sc.property = 'set';
9sc.active = true;

子オブジェクトを取得 

1
2gameObject.transform.GetChild(0);

1this.object.children[0];

親オブジェクトを取得 

1gameObject.transform.parent

1this.object.parent;

マテリアルプロパティを設定 

色やテクスチャなどのマテリアルプロパティを設定します。

1var mesh = gameObject.GetComponent<MeshRenderer>();
2mesh.material.SetColor("_Color", Color.green);

1const mesh = this.object.getComponent(MeshComponent);
2mesh.material.setDiffuseColor([0.0, 1.0, 0.0, 1.0]);

数学 

JavaScript は operator overloading をサポートしていないため、数学コードに対するアプローチが異なります。

多くの場合、Wonderland Engine の Object3D API には変換を操作するための多くの関数があり、WebAssembly で効率的に実装されています：

1/* オブジェクトを複数の軸に沿って移動します。ベクトルのために一時的なメンバーまたはモジュールスコープ内の定数を使用してください。 */
2this.object.translateWorld([1, 2, 3]);
3
4/* Y 軸を中心にオブジェクトを回転します。 */
5const AxisY = [0, 1, 0];
6this.object.rotateAxisAngleDegLocal(AxisY, 25);

ガベージコレクション 

JavaScript はガベージ収集を行う言語であり、自動ガベージコレクションによる計画外の中断が発生する可能性があります。そのため、メモリにリスト/ベクトルやオブジェクトを追加することを避けるのが最適です。

カスタムコンポーネントのコンストラクタ内またはボディ内で、一時的なベクトルやクォータニオンを作成し再利用するか、あるいは慎重に使用する場合は、モジュールスコープ内にそれらを置くことをお勧めします（クラスの上に）。[0, 1, 0] のような定数ベクトルは、モジュールスコープに const AxisY = [0, 1, 0] として宣言します。

数学ライブラリ 

JavaScript/TypeScript 用の性能とガベージコレクションに配慮した数学ライブラリ glMatrix の使用をお勧めします。これはデフォルトのテンプレートおよびコンポーネントにすでにインストールされているため、自分でインストールする必要はありません。

glMatrix が計算するベクトルやクォータニオンは、新たに割り当てられたベクトルを返さず、最初のパラメータとして結果を格納する場所を指定してください。プリミティブを返す関数は通常通り結果を返します。

glMatrix 数学ライブラリの完全なドキュメントはこちらを参照してください。

1var v = new Vector3(1, 2, 3);
2v.Set(3, 2, 1);

1const v = vec3.fromValues(1, 2, 3);
2vec3.set(v, 3, 2, 1);

1var a = new Vector3(1, 2, 3);
2var b = new Vector3(1, 2, 3);
3
4var v = a + b;
5var a = a * b;
6var a = 2.0*a;

1import {vec3} from 'gl-matrix';
2
3const a = vec3.fromValues(1, 2, 3);
4const b = vec3.fromValues(1, 2, 3);
5
6const v = vec3.add(vec3.create(), a, b);
7vec3.mul(a, a, b);
8vec3.scale(a, a, 2.0);

JavaScript vs C# 

C# から移行する際の特徴的な違いは以下の通りです：

• メンバー変数へアクセスする際は常に this. をプレフィックスにします。
• var は「グローバル」を作成し、現在のスコープに制限されません。最良の方法は let または const を使用してスコープ付き変数を作成することです。