ビルドエラー / ワールドが動かないときは

ビルドエラー

Build And Runでブラウザが起動しますが、稀にエラーによってコンテンツが表示されない場合があります。

この原因には、いくつかのケースが考えられますが、よくある原因は以下の通りです。

原因	対策
アバターリストが空になっている	最低1体以上、アバターを登録してください
HEOWorldSettings/BasicInfo/HeliScriptの中身が空になっている	NoneあるいはMissingとなっている項目を削除してください
.heoファイルの出力に失敗している	Unityのコンソールあるいはデバッグコンソールにエラー（赤文字）が出ていないか確認してください
Unity側のキャッシュによる不具合	VketCloudSDK --> Clear Cache からキャッシュをクリアしてください
ブラウザのキャッシュによる不具合	使用しているブラウザのキャッシュをクリアしてください
必要なファイルが見つからない(404)	後述の方法するエラーログから、404なファイルを確認し、Vket Cloudがサポートしないファイルなら変更してください
Unityプロジェクトが配置されたディレクトリ、配置されたファイル名にスペースや二バイト文字が含まれている	スペースや二バイト文字を抜いてください

変更が更新されない・ギミックが動かない場合

Unityで編集した / SDKをアップデートしたにもかかわらず、その変更がブラウザに反映されないケースがあります。
多くの場合、キャッシュが残っているため、前の内容が表示されてしまっていることが原因です。

原因	対策
ブラウザにキャッシュが残っている	Ctrl + Shift + R で、スーパーリロードを実行する

Unity側のキャッシュはSDKツールバーのVketCloudSDK > Clear Cacheを実行すると消去されます。

ブラウザ側のキャッシュが原因でHeliScript・ギミックが動かない場合があります。
該当の現象が発生した際はブラウザのキャッシュクリアをお試しください。

エラーログを確認する

ビルドエラーの原因を調べるには、お使いのブラウザのコンソールをチェックします。

ブラウザによって方法は異なりますが、Google Chromeの場合は、右上の三点リーダーから その他のツール > デベロッパーツール を開きます。

必ずしもコンソールに出ている内容が、VketCloudのビルドエラーに直結しているとは限りませんが、赤字でエラーが出ている場合はその内容がビルドエラーの原因になっている可能性があります。

インポートしたライブラリを確認する

Package Managerなどからインポートしたライブラリまたはスクリプトによってエラーの原因になっている可能性があります。

このケースでは後から追加した対象のライブラリをインポートし直すことで解消される場合があります。

Note

稀に必須パッケージであるEditorTutorialSystemが自動インポートされず、ビルドエラーの原因となる場合があるため、その際は[Package Manager](../AboutVketCloudSDK/SetupSDK_external.md)を通じて該当のパッケージを導入してください。

デバッグコンソール / DebugModeを使用する

デバッグのためのSDKのツールとして、Unityエディタ―上ではデバッグコンソールを、ブラウザではデバッグモードを使用して問題解決ができます。 詳細はそれぞれのページをご確認ください。

デバッグコンソール

デバッグモード

ブラウザウィンドウが暗転したまま動かない

ワールド入場時にブラウザウィンドウが暗転したまま動かない場合は、以下の点をチェックしてみてください。

原因	対策
ブラウザのハードウェアアクセラレーションが無効になっている	ブラウザの設定から「ハードウェアアクセラレーション」を有効にしてください
PCにゲームパッドが接続されている	該当のゲームパッドの接続を切断してください
ビルドエラーが発生している	ビルドエラーの有無を確認してください

例として、Chromeを使用している場合は設定ページの「システム」から「ハードウェアアクセラレーションが使用可能な場合は使用する」を有効にすることでワールド入場時の暗転が解消される場合があります。