ローカル環境でのビルドと実行

作られたワールドのテスト・デバッグを行うには、ローカル環境にてワールドのビルドと実行を行う必要があります。

ビルドを行う方法 / ビルドのオプションについて

VketCloudSDKでシーンをビルドするには、必要コンポーネントを配置したことを確認し、VketCloudSDK > Build And Run からビルドを実行してください。

ビルドが出来ない場合

さまざまな要因でビルドに失敗している可能性があります。エラー事例をまとめたトラブルシューティングをご覧ください。

エラーが起きた場合は

HeliScriptがワールドロード中あるいは呼び出しによって実行された際にエラーが起きた場合はデバッグログとブラウザのコンソールに表示されます。
初期状態ではデバッグログは非表示になっているため、表示するにはデバッグモードを有効にしてください。
なお、ワールドロード時にデバッグログは非表示になるため、ロードが停止した際はブラウザのコンソールをご確認ください。

ログインやAPI連携はローカルビルドでは動作しない

ローカル環境では、ログイン機能とAPI連携機能は動作しないのが仕様です。
APIとの接続が必要な機能の場合は、ワールドをアップロードして確認してください。

ビルドオプションについて

VketCloudSDK > Settingsより設定ウィンドウを開き、「Build」タブを選択するとビルド時のテクスチャの自動圧縮などのオプションを設定出来ます。
詳細はビルド時のオプションをご参照ください。

ビルドが成功したら、自動的にブラウザに遷移します。シーンの内容が反映されているかテストしてください。

キャッシュクリアについて

VketCloudSDKのビルド時に発生するキャッシュは、基本的にはビルド毎に上書きされるため消去は不要です。
SDKのバージョンアップ直後などにおいて稀にキャッシュが原因のビルドエラーが発生するため、その際は以下より手動でのキャッシュクリアをお試しください。
- VketCloudSDK > キャッシュクリア
また、 - VketCloudSDK > Build Option > Auto Clear Cache にチェックを入れることでビルド毎にキャッシュクリアするように設定出来ますが、通常のビルド時には有効にしなくても問題ございません。

「ビルドと実行」で起きること

Build and Runを押すと、VKC Item Fieldコンポーネントが付いたオブジェクトとそのすべての子オブジェクトが.heoファイルに変換されます。「.heo」はVketCloudの描画エンジンで使われている専用の3Dフォーマットです。

ビルドされたファイルは[プロジェクト名]\release\dataフォルダにコピーされます。これにより、3Dワールドをブラウザで動かすのに必要なアセットがすべてこのフォルダに入ります。

releaseフォルダの中身

場所	ファイル	説明
\release	main.html	このhtmlをブラウザで開いて3Dワールドを起動
\release\data\Field[ワールド名]\ [オブジェクト名]	[オブジェクト名].heo	ワールドの3Dオブジェクト
\release\data\Scene	[ワールド名].json	ワールド構成を記述したシーンデータ

なお、releaseフォルダの中身を直接書き換えたものをアップロードする行為はライセンス規約で固くお断りしています。あくまで、デバッグ手段の一つとしてご利用ください。