Merge branch 'release/v3.4.2'

Author: linoal

Documentation~/manual/RoadNetworkExported.md

@@ -5,7 +5,7 @@
 
 ## 交差点
 **ファイル名: roadnetwork_node.geojson**  
-![](../resources/manual/roadnetwork/exported_nodes.png)  
+![交差点を示す図](../resources/manual/roadnetwork/exported_nodes.png)  
 上図は交差点の位置がエクスポートされたものです。  
 道路ネットワーク内の交差点をノード情報として格納します。
 
@@ -14,7 +14,7 @@
 
 ## 道路
 **ファイル名: roadnetwork_link.geojson**  
-![](../resources/manual/roadnetwork/exported_link.png)  
+![道路を示す図](../resources/manual/roadnetwork/exported_link.png)  
 上図の紫色の線に相当します。交差点（黄色い点）を接続します。  
 道路を、ノード（交差点）間を接続するリンク情報として格納します。
 
@@ -34,7 +34,7 @@
 
 ## レーン
 **ファイル名: roadnetwork_lane.geojson**  
-![](../resources/manual/roadnetwork/exported_lanes.png)  
+![レーンを示す図](../resources/manual/roadnetwork/exported_lanes.png)  
 上図のオレンジ色の線に相当します。  
 各リンクに属する車線情報をレーン情報として格納します。
 
@@ -48,7 +48,7 @@
 
 ## トラック
 **ファイル名: roadnetwork_track.geojson**
-![](../resources/manual/roadnetwork/exported_tracks.png)  
+![トラックを示す図](../resources/manual/roadnetwork/exported_tracks.png)  
 上図の交差点（黄色い点）の周りにある茶色の線に相当します。  
 各交差点の通行可能な経路をトラック情報として格納します。
 
@@ -65,3 +65,62 @@
 - TURNCONFIG: 街路網交通流シミュレーション AVENUEと互換性を持たせるために存在しますが、PLATEAU SDKでは常に同じ値が入ります。進行可能な方向の設定であり、値は直進、左折、右折可能を意味する7が常に入ります。
 - TYPECONFIG: 街路網交通流シミュレーション AVENUEと互換性を持たせるために存在しますが、PLATEAU SDKでは常に同じ値が入ります。進行可能な車両の種類であり、値は小型車、大型車、バスの通行可能を意味する7が常に入ります。
 
+## 信号制御器
+**ファイル名: roadnetwork_signalcontroler.geojson**  
+
+[PLATEAU SDK-Toolkits for Unity](https://github.com/Project-PLATEAU/PLATEAU-SDK-Toolkits-for-Unity) の交通シミュレーション機能が有効な場合に生成されます。利用方法は[こちら](https://github.com/Project-PLATEAU/PLATEAU-SDK-Toolkits-for-Unity/tree/main/PlateauToolkit.Sandbox#10-%E4%BA%A4%E9%80%9A%E3%82%B7%E3%83%9F%E3%83%A5%E3%83%AC%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%A9%9F%E8%83%BD)を参照してください。
+
+![信号制御器を示す図](../resources/manual/roadnetwork/exported_signalcontroler.png)  
+上図は交通シミュレーション機能により車両用交通信号機が設置された交差点の位置がエクスポートされたものです。 
+所属する信号灯火器を制御する情報を格納します。
+
+#### 属性情報
+- ID: 信号制御器の識別子です。値は `SignalController(対応するノードの番号)` となります。
+- ALLOCNODE: 割り当てられたノードの識別子です。
+- SIGLIGHT: 制御対象の信号灯火器識別子です。複数ある場合は「:」で連結します。
+- OFFSETBASESIGID: オフセット基準となる信号制御器の識別子です。PLATEAU SDKでは常に空です。
+- NUMOFPATTERN: 時間帯別の信号制御パターン数です。PLATEAU SDKでは常に `1` 固定です。
+- PATTERNID: 使用する制御パターンの識別子です。複数ある場合は「:」で連結します。
+- INITCYCLE: 制御サイクルの長さ（秒）です。
+- PHASENUM: 信号現示数です。
+- OFFSETTYPE: オフセットタイプです。相対オフセットの場合は `1`、絶対オフセットの場合は `0` となります。PLATEAU SDKでは常に `0` 固定です。
+- OFFSET: オフセット値（秒）です。PLATEAU SDKでは常に `0` 固定です。
+- STARTTIME: 制御パターンの開始時刻です。`hh:mm:ss` 形式で `:` で連結します。
+
+## 信号灯火器
+**ファイル名: roadnetwork_signallight.geojson**  
+
+[PLATEAU SDK-Toolkits for Unity](https://github.com/Project-PLATEAU/PLATEAU-SDK-Toolkits-for-Unity) の交通シミュレーション機能が有効な場合に生成されます。利用方法は[こちら](https://github.com/Project-PLATEAU/PLATEAU-SDK-Toolkits-for-Unity/tree/main/PlateauToolkit.Sandbox#10-%E4%BA%A4%E9%80%9A%E3%82%B7%E3%83%9F%E3%83%A5%E3%83%AC%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%A9%9F%E8%83%BD)を参照してください。
+
+![信号灯火器を示す図](../resources/manual/roadnetwork/exported_signallight.png)  
+上図は交通シミュレーション機能により設置された車両用交通信号機の位置がエクスポートされたものです。 
+車両用交通信号機についての情報を格納します。
+
+#### 属性情報
+- ID: 信号灯火器の識別子です。値は `SignalLight(属する信号制御器の番号)_(灯火グループ)_(灯火グループ内の順番)` となります。
+- SIGNALID: 属する信号制御器の識別子です。
+- LINKID: 設置対象のレーンの識別子です。
+- LANETYPE: 規制対象レーン種別です。PLATEAU SDKでは常に `lane` 固定です。
+- LANEPOS: 規制対象レーン番号です。PLATEAU SDKでは常に全レーンを示す `-1` 固定です。
+- DISTANCE: 信号灯火器の設置位置で停止線からの距離（m）です。
+
+## 信号現示階梯
+**ファイル名: roadnetwork_signalstep.geojson**  
+
+[PLATEAU SDK-Toolkits for Unity](https://github.com/Project-PLATEAU/PLATEAU-SDK-Toolkits-for-Unity) の交通シミュレーション機能が有効な場合に生成されます。利用方法は[こちら](https://github.com/Project-PLATEAU/PLATEAU-SDK-Toolkits-for-Unity/tree/main/PlateauToolkit.Sandbox#10-%E4%BA%A4%E9%80%9A%E3%82%B7%E3%83%9F%E3%83%A5%E3%83%AC%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%A9%9F%E8%83%BD)を参照してください。
+
+![信号現示階梯を示す図](../resources/manual/roadnetwork/exported_signalstep.png)  
+上図は信号現示階梯がエクスポートされたものです。位置は対象となる信号制御器と同じになります。
+信号制御器が制御する信号の切り替え順序やパターン（現示階梯）に関する情報が格納されます。
+
+#### 属性情報
+- ID: 信号現示階梯の識別子です。値は `SignalStep(対象の信号制御器の番号)_(階梯順番)` となります。
+- SIGNALID: 信号制御器の識別子です。
+- PATTERNID: 制御パターン番号です。
+- ORDER: 階梯順番です。
+- DURATION: 階梯の持続時間（秒）です。
+- SIGLIGHT: 制御信号灯火器の識別子です。
+- TYPEMASK: 進入許可車種規制マスクです。PLATEAU SDKでは常に同じ値が入り、小型車・大型車・バスの通行を許可する `7` が設定されます。
+- GREEN: 青現示方向リンクペアです。ペアは `->` で表し、複数ある場合は `:` で連結します。
+- YELLOW: 黄現示方向リンクペアです。ペアは `->` で表し、複数ある場合は `:` で連結します。
+- RED: 赤現示方向リンクペアです。ペアは `->` で表し、複数ある場合は `:` で連結します。

Documentation~/resources/manual/roadnetwork/exported_signalcontroler.png

@@ -0,0 +1,63 @@
+using UnityEditor;
+using UnityEditor.AddressableAssets;
+using UnityEditor.AddressableAssets.Settings;
+using UnityEngine;
+
+namespace PLATEAU.Editor.Addressables
+{
+    [InitializeOnLoad]
+    public class AddressablesInitializer
+    {
+        private const string AddressablesDataFolderName = "AddressableAssetsData";
+        private const string AddressablesDataPath = "Assets/" + AddressablesDataFolderName;
+        private const string AddressablesSettingsName = "AddressableAssetSettings";
+
+        static AddressablesInitializer()
+        {
+            // Unityエディタ初期化直後はAssetDatabaseやAddressablesの内部が完全に初期化されていないことがあるため、
+            // Addressablesの初期化は遅延コールで行う
+            EditorApplication.delayCall += InitializeAddressables;
+        }
+
+        private static void InitializeAddressables()
+        {
+            // Addressablesの型チェック
+            var type = System.Type.GetType("UnityEditor.AddressableAssets.Settings.AddressableAssetSettings, Unity.Addressables.Editor");
+            if (type == null)
+            {
+                Debug.LogWarning(
+                    "PLATEAU SDKの一部機能にはAddressablesパッケージが必要です。Package Managerからインストールしてください。"
+                );
+                return;
+            }
+
+            if (AddressableAssetSettingsDefaultObject.Settings != null)
+            {
+                return;
+            }
+
+            try
+            {
+                if (!AssetDatabase.IsValidFolder(AddressablesDataPath))
+                {
+                    AssetDatabase.CreateFolder("Assets", AddressablesDataFolderName);
+                }
+
+                var settings = AddressableAssetSettings.Create(
+                    AddressablesDataPath,
+                    AddressablesSettingsName,
+                    true,
+                    true
+                );
+                AddressableAssetSettingsDefaultObject.Settings = settings;
+                AssetDatabase.Refresh();
+
+                Debug.Log("Addressablesの設定が正常に初期化されました。");
+            }
+            catch (System.Exception e)
+            {
+                Debug.LogError($"Addressables初期化中にエラーが発生しました: {e.Message}");
+            }
+        }
+    }
+}