Lightship Mapのプレハブ

Lightship Mapsプレハブは、コンポーネントやプロパティ値、子アセットを含む、パッケージ済みのGameObject、 Unityプレハブ です。 このプレハブは、フィーチャービルダー、マップレイヤー、特徴、テーマをサポートしています。

このプレハブの以下のプロパティは、プレハブの Inspector ウィンドウで変更できます。

• Label Language - ISO 639-1の言語コード（オプション）。言語が翻訳済みの場合は、ラベルに使用するローカライズ済みの文字列を指定します。 この言語に一致する翻訳が存在しない場合は、その地域の地理的な人々が使用する言語（必ず存在することが保証されている）にフォールバックされます。 このフィールドが空の場合、ラベルには、デフォルトで「ローカル」バージョンのテキスト文字列が使用されます。

• Lightship Map Manager - Lightship Map Manager への参照。

• Center Map at Origin - 設定されている場合、マップは常にその中心がシーンの原点になるように配置されます。

• Maximum Map Offset - マップが原点から離れることができる最大距離（メートル単位）。 マップの中心がこの制限を超えて移動すると、マップ上に配置されているマップタイルやオブジェクトは、シーンの原点に戻ります。

• Tile Batch Count - このフィールドでは、一緒にバッチ処理される予定のマップタイルの最大数を指定します。 通常、この値はデフォルト値のままにしておく必要があります。 この値をデフォルト値以下に設定することで、多数のマップタイルが同時に返った場合に発生する可能性のあるパフォーマンスへの影響を抑えることができます（たとえば、プロファイリングでフレーム時間が大きくスパイクした場合）。

• Map Theme - このマップビューをレンダリングする際に使用するテーマ。 Map Themeを参照。

• Viewable Radius - マップで表示可能な半径（シーン単位）。 このフィールドは、表示可能なエリアの半径が、実行時に中心位置と一緒に渡される場合は省略することができます。

• Start at Default Location - 設定すると、マップビューは Default Location（デフォルト位置） で初期化されます。

• Default Location - デフォルトの開始位置。

• Map Layers - プレハブまたはGameObjectのリスト。マップビューを構築する際に使用するMapLayerコンポーネントを含みます。 通常、オブジェクトを配置したり、マップの広範囲をカバーするためにマップタイルの境界を越える可能性のあるジオメトリをレンダリングするために使用されます。 Map Layersを参照。

Lightship Map Manager

LightshipMapManager クラスは、 Lightship Maps Core ライブラリの初期化を担います。これは、Rawマップタイルデータのストリーミングやデコードを行うMaps SDKのコンポーネントです。 このクラスはシングルトンであることを前提としているため、所定のシーンでは常に1つのLightshipMapManagerのみがアクティブである必要があります。 通常、LightshipMapManagerは、LightshipMapプレハブのLightshipMapViewと同じGameObject上のコンポーネントになります。 ただし、複数のマップビューが同時にアクティブになるシーンなどでは、LightshipMapManagerはシーン内の別のGameObjectにアタッチされることがあります。

Lightship Map View

LightshipMapView クラスは、マップの単一の表示可能領域を表し、ゲームが Maps SDK と対話するために使用する主な API です。 ほとんどのシーンには、単一のLightshipMapViewインスタンスがありますが、Maps SDKでは、一度に任意のシーンでアクティブなマップビューの数をサポートしています。