よくある質問

1. ウォーターマークと AppKey

原因：SDK v0.5.0 以降、デフォルトで左下にウォーターマークが表示されます。

解決方法：営業担当に連絡して AppKey を取得し、LCCRender.load() のパラメータで appKey を設定してウォーターマークを除去してください。

2. SDK を Babel プロジェクトに統合するとエラーが発生する

原因：SDK はモダンブラウザ構文を使用しています。Babel がこれを古い構文にコンパイルすると、ランタイムエラーやコンパイル失敗が発生する可能性があります。

解決方法：

プロジェクトで Babel が SDK ファイルをコンパイルしないように設定する。
または、<script> タグで SDK ファイルを読み込み、コンパイルをバイパスする：

<script src="./sdk.js"></script>

読み込み後、LCC.LCCRender を使用してロードします。

3. Three.js エンジンで LCC モデルが表示されない

以下の手順で順番に確認してください：

ブラウザコンソールにエラーメッセージ（ファイルが見つからないなど）がないか確認する。
dataPath のファイルが正常にアクセス・ダウンロードできるか確認する。
カメラの far 平面値が十分に大きいか確認する。モデルがカメラの視錐台の外にある可能性があります。
レンダリングループ内で LCCRender.update() が呼び出されているか確認する。

上記すべてを確認しても問題が解決しない場合は、テクニカルサポートに連絡するか、フォーラムで質問してください。

4. CesiumJS で 3D Tile モデルが LCC モデルに遮蔽される

原因：デフォルトでは、LCC モデルは深度バッファに書き込み、深度テスト関数は常にパス（ALWAYS）に設定されています。Pass.CESIUM_3D_TILE レンダリングキューで、3D Tile が LCC モデルより先にロードされた場合、LCC モデルの深度に上書きされます。

解決方法：

LCCRender.load() の成功コールバック内で 3D Tile モデルをロードする。
または、両方のロード完了後に lccObject.lowerToBottom() を呼び出して、LCC モデルのレンダリング順序を最前面に移動する。

5. CesiumJS の旧バージョンへの対応

原因：Cesium v1.102 以降はデフォルトで WebGL2 をサポートしていますが、それ以前のバージョンはデフォルトで WebGL1 を使用します。Web SDK は WebGL1 をサポートしていないため、WebGL2 を強制する必要があります。

解決方法：WebGL2 を強制的に有効にします。最低サポートバージョンは Cesium v1.67 です。

const viewer = new Cesium.Viewer("cesiumContainer", {
    orderIndependentTranslucency: false, // 順序非依存透過を無効化
    useDefaultRenderLoop: true,
    resolutionScale: window.devicePixelRatio,
    contextOptions: {
        webgl2: true, // WebGL 2.0 を強制
        requestWebgl2: true
    }
});

6. 高性能ハードウェアなのに Viewer が遅い

原因：複数の GPU を搭載したコンピュータ（Intel 内蔵 GPU + NVIDIA 専用 GPU など）では、Windows がデフォルトで内蔵 GPU を優先使用する場合があり、レンダリングが遅延します。

解決方法：

コンピュータの電源モードを「高パフォーマンス」に設定する。
NVIDIA コントロールパネルでブラウザに専用 GPU を設定する。
Windows 設定 → ディスプレイ → グラフィックスで、ブラウザに「高パフォーマンス」GPU を指定する。

設定完了後、新しい設定を有効にするためにブラウザを再起動してください。

7. ハードウェア要件を満たしているのにレンダリングが遅い

3DGS レンダリングはリソースを多く消費します。使用中は、3D エディタ、LCC 再構成タスク、高画質ビデオ再生、高速ダウンロードタスク、ビデオストリーミングなどのリソースを大量に消費するアプリケーションを閉じて、必要な計算リソースを確保してください。

同じノートパソコンで異なる時間帯にシーンをナビゲートする際にパフォーマンスが不安定な場合（滑らかな時とカクつく時がある場合）、原因は多くの場合、外部電源が接続されているかどうかに関係しています。バッテリー駆動時は、ノートパソコンが省電力モードを使用して CPU と GPU のパフォーマンスを低下させるため、カクつきが発生する可能性があります。3DGS シーンを閲覧する際は外部電源を使用することを推奨します。