コンテンツにスキップ

バージョンアップ後によくあるトラブル

バージョンアップ後にComponentがMissingとして表示される

SDKのバージョンアップを行った際に、バージョンアップ前のコンポーネントがMissingとして表示される場合があります。

VersionUpdateTroubleshooting_1

Missingになったコンポーネントについては該当のコンポーネントを再度アタッチ・設定し直すことで正常に動きます。
バージョンアップの際はバージョンアップ前の状態を確認できるようにバックアップを行うことを強くおすすめします。

以下のコンポーネントについてMissingになる可能性を確認しております:

  • HEO Animation
  • HEO Collider
  • HEO Cylinder Collider
  • HEO lbl Cube Map
  • HEO Info
  • HEO Mesh Collider
  • HEO Mirror
  • HEO Object Type
  • HEO Reflection Probe
  • HEO Shadow
  • HEO LOD Level
  • HEO UV Scroller

Note

Ver5.4からVer9.3へのアップデート時においてはHEOWorldSetting > Avatars > Avatar Fileの設定が欠落する恐れがあるため、欠落している場合は再設定をお願いいたします。

HEOWorldSetting > Avatars > Avatar Fileにて空欄がある、Avatar Fileが1つも設定されていない場合はビルドエラーが発生したり、初期状態のアバターが表示されない状態となります。

HEOWorldSetting_AvatarFileError_1

SDKでは初期状態のアバターとして用意しているAvatarFileがあるため、バージョンアップ後に空欄が発生している際はこちらをご利用ください。

HEOWorldSetting_AvatarFileError_2

設定画面でのバージョン表記が旧バージョンのままになっている / HeliScript・ギミックが動かない

既存のプロジェクトからバージョンを9.3へアップデートした後、ビルドを行ったワールドにて設定画面の右下に表示されているバージョン表記が旧バージョンのままになっている場合があります。

VersionUpdateTroubleshooting_2

その際はSDKツールバーのVketCloudSDK > Clear Cacheを実行すると解消されます。

VersionUpdateTroubleshooting_3

Note

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

VersionUpdateTroubleshooting_4_jp

ファイルの破損エラーが表示される

新しいバージョンのプロジェクトにて存在しない、もしくは更新されているスクリプトがアタッチされている場合、シーンを開いた際に以下のメッセージが表示される場合があります。

VersionUpdateTroubleshooting_5

本不具合が発生した際は、プロジェクトフォルダのLibraryフォルダ及びTempフォルダを消去した上でプロジェクトを再起動させると解消します。

操作手順

1. Unityプロジェクトを開いている場合は一度閉じる

2. エクスプローラにてSDKが含まれているUnityプロジェクトを開く
※Unity Hubにて該当のプロジェクトを右クリックし、「エクスプローラーで表示」を選択すると表示されます

VersionUpdateTroubleshooting_6_jp

3. Library及びTempフォルダを消去する

VersionUpdateTroubleshooting_7

4. Unityプロジェクトを再度開き、エラーの解消を確認する