Cesium for Unity クイックスタート

これは MIERUNE AdventCalendar 2022　１９日目の記事です。
昨日は @satoshi7190 さんによる MapLibre GL JSで魔法陣を出現させる でした。

結構最近Cesium for Unityがリリースされたので

Cesium for Unityのクイックスタートをやっていきます

英語が読める方は公式の方が詳しいと思いますのでおすすめです

前提条件

• Unity2021.3.2f1以降のバージョンがインストールされていること
• Cesium ionのアカウントを持っていること（これは地物のデータを参照するのに必要とのこと）

プロジェクトを新規作成してCesium for Unityパッケージをインポートする

1. UnityHubを起動して新しいプロジェクトを作ります

2. この時、3D(URP)のテンプレートを選択します

   • HDRPでも動作するようですが、標準の3Dテンプレートではレンダリングが正しく機能しないとのことです
     

3. メニューの[Edit] > [Project Settings...]に移動してプロジェクト設定を開きます。

4. Package Manaerを開きます
   

5. 以下の設定で新しくスコープレジストリを追加します

• Name:Cesium
• URL: https://unity.pkg.cesium.com
• Scope(s):com.cesium.unity
  

1. 次にメニューの[Window] > [Package Manager] でパッケージマネージャーを開きます
2. Package ManagerでPackagesのドロップダウンリストからMy Resistriesを選択します
3. Cesium for Unityが表示されるので、installします
   
4. TextMeshProのインストールを促すダイアログが出る場合はインストールします
5. TextMeshProのインストールについては割愛します

Cesium ionに接続する

1. メニューにCesiumが増えていますので、[Cesium] →　[Cesium]でCesiumのウインドウを開きます
   
2. Connect to Cesium ionのボタンを押下します
3. ブラウザで認証するURLなどが書かれているので接続すると下記のような画面になります
   
4. Allowボタンを押すと認証され、Cesiumウインドウが以下のようになります
   
5. 次にプロジェクトのアクセストークンを作成します
6. Tokenのボタンを押して、トークンのウインドウを開き、「Create New Project Default Token」のボタンを押すと、新しいトークンが生成され、Cesium ionのアカウントに追加されます

地形をシーンに追加する

1. Cesiumウインドウの「Cesium World Terrain + Bing Maps Aerial　imagery」の横にある＋ボタンを押下します
2. するとHierarchyウインドウにCesiumGeoreferenceオブジェクトおよび、Cesium World Terrainが追加されます
   
   

メインカメラの設定

1. メインカメラのデフォルトの設定だと、あまり遠くのオブジェクトを見るように設定されていません
2. HierarｃｈyウインドウでMainCameraを選択し、Clipping Planesの値を変更します
3. Nearを1に、Farを1,000,000に設定すると、地平線の方まで地形が見えるようになります
   
   

3D建物をシーンに追加する

公式のクイックスタートではシカゴを表示していましたが、今回は東京を表示してみたいと思います

1. HierarchyウインドウのCesiumGeoreferenceを選択して、Inspectorウインドウに表示されている座標を以下に変更します
   Latitude：　35.681236
   Longitude:　139.767125
   Height: 1000
   
2. 座標を入力すると、シーンは東京駅付近を表示します
3. 次にCesiumウインドウで「Cesium OSM Buildings」の右にある＋をクリックします
4. するとOSMの建物データが読み込まれます
   

感想

以上、Cesium for Unityのクイックスタートでした
想像以上に簡単に3DTilesを扱う事が出来て感動しています
Cesium 3D Tilesetというコンポーネントがポイントで、こいつを自在に操ることができるかどうかが鍵です

ちなみにPlateauのテクスチャ付き建物データもサクッと載せれました
開発用のシーンビューはレンダリングが厳しい感じですがゲームビューは全く問題無し、空撮したかのようなショットが撮れました
ある程度Unityのカメラのコントロールの腕は必要ですが、これは便利だなと思いました

明日は@kntoshiyaさんです！お楽しみにー