コンテンツにスキップ

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

本ページでは、VketCloudSDKのバージョンを新しいバージョンに更新した際に発生する可能性のある現象と解決策を掲載しております。

もしバージョンアップ作業時に本ページに掲載されていない / 解決できない現象に遭遇した際は、お問い合わせフォームもしくはVket CloudコミュニティDiscordにてお気軽にお問い合わせください。

メニューにVketCloudSDKタブが表示されない

VketCloudSDK更新後、Unityの上部メニューからVketCloudSDKが本来表示されるべき位置に表示されなくなる場合があります。

VersionUpdateTroubleshooting_10

この場合、必須パッケージのバージョンの手動更新が必要な場合があるため、以下の手順で更新します。

  1. Projectウィンドウの任意の箇所にて右クリックして表示されたメニューにて"Show in Explorer"を選択し、現在のプロジェクトをエクスプローラーにて開きます。

    VersionUpdateTroubleshooting_11

  2. Manifest.jsonが格納されているPackagesフォルダまで遷移し、Manifest.jsonを開きます。

    VersionUpdateTroubleshooting_12

  3. Manifest.jsonにて、VketCloudSDKに関するパッケージのバージョンが正しいものか確認します。

    例として、SDK Ver12.3.0ではパッケージが以下のバージョンである必要があります:

    ```

    { "dependencies": { "com.hikky.editortutorialsystem": "1.0.1", "com.hikky.vketcloudsdk": "12.3.0", "com.needle.deeplink": "1.2.1", //省略

    ```

上記にて列挙したSDK付随のパッケージのうち、Deeplinkパッケージがプロジェクトに存在しない現象が発生した場合は手動での導入をお試しください。

また、稀に必須パッケージであるEditorTutorialSystemも自動インポートされない場合があるため、その際はSDK Install Managerと同様の手順で以下のパッケージを導入してください。

項目
Name EditorTutorialSystem
URL https://registry.npmjs.org
Scope(s) com.hikky.editortutorialsystem

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

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

VersionUpdateTroubleshooting_1

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

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

  • VKC Node Rotate Animation/HEOAnimation
  • VKC Node Collider/HEOCollider
  • VKC Node Cylinder Collider/HEOCylinderCollider
  • HEOIblCubeMap
  • VKC Node Blendshape Translator/HEOInfo
  • VKC Node Mesh Collider/HEOMeshCollider
  • VKC Node Mirror/HEOMirror
  • VKC Node Reflection Probe Type/HEOObjectType
  • HEO Reflection Probe
  • VKC Node Shadow/HEOShadow
  • VKC Node LOD Level/HEOLODLevel
  • VKC Node UV Scroller/HEOUVScroller

Note

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

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

HEOWorldSetting_AvatarFileError_1

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

HEOWorldSetting_AvatarFileError_2

Vket Cloud Settingsにおける設定が空欄になっている / 旧バージョンのHEOWorldSettingコンポーネントから要素が引き継がれない

Ver12.3以降、これまでHEOWorldSettingHEOPlayerHEODespawnHeightコンポーネントにて設定していたワールドに関する設定はVketCloudSettingsにて設定されるようになりました。

バージョンアップ時に旧HEOコンポーネントの設定内容は自動でVketCloudSettingsに移植されますが、稀に以下の画像のように正しい設定が移植されず、空欄のままになる場合があります。

VersionUpdateTroubleshooting_8

このとき、該当のVketCloudSettingsコンポーネントの三点リーダー(…)を選択し、「Reset」を選択するとデフォルトの値が入力されます。

VersionUpdateTroubleshooting_9

設定画面でのバージョン表記が旧バージョンのままになっている / 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プロジェクトを再度開き、エラーの解消を確認する