NetworkConfig.cs 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313
  1. using System.Net;
  2. using System.Net.Sockets;
  3. using UnityEngine;
  4. using UnityEngine.Windows;
  5. namespace LightGlue.Unity.Config
  6. {
  7. /// <summary>
  8. /// 网络配置参数(统一管理所有IP和端口配置)
  9. /// 用于部署到不同设备时的配置管理
  10. /// </summary>
  11. [System.Serializable]
  12. public class NetworkConfig
  13. {
  14. public enum RomaHardwareMode
  15. {
  16. OrangePi = 0,
  17. Esp32 = 1,
  18. }
  19. [Header("硬件图像接收 (Hardware -> Unity)")]
  20. [Tooltip("Unity本地绑定IP(用于接收硬件发送的JPEG图像流)。默认由 GetLocalBindIp() 自动获取本机地址一次;也可调用 ApplyLocalBindIp() 或 NetworkConfig.GetLocalBindIp() 手动刷新。")]
  21. public string hardwareBindIp = "192.168.0.105";
  22. [Tooltip("硬件发送JPEG图像的UDP端口")]
  23. public int hardwarePort = 12346;
  24. [Tooltip("JPEG接收超时时间(秒),超过此时间未收到完整帧则重置缓冲区")]
  25. public float hardwareTimeoutSeconds = 2.0f;
  26. [Header("硬件控制 (Unity -> Hardware)")]
  27. [Tooltip("硬件设备IP地址(用于发送控制指令,例如ESP32S3的IP,如192.168.0.106)")]
  28. public string hardwareControlIp = "192.168.0.106";
  29. [Tooltip("硬件监听控制命令的UDP端口")]
  30. public int hardwareControlPort = 8888;
  31. [Header("Python通信 (Unity -> Python)")]
  32. [Tooltip("Python进程IP(UDP模式使用,通常为localhost)")]
  33. public string pythonIp = "127.0.0.1";
  34. [Tooltip("Python UDP端口(UDP模式使用,用于接收Unity发送的JPEG)")]
  35. public int pythonPort = 12347;
  36. [Header("Python结果接收 (Python -> Unity)")]
  37. [Tooltip("Unity本地绑定IP(用于接收Python发送的算法结果),例如 127.0.0.1 或 0.0.0.0(监听所有接口)")]
  38. public string pythonResultBindIp = "127.0.0.1";
  39. [Tooltip("Python结果接收端口(用于接收Python发送的算法结果,默认12348)")]
  40. public int pythonResultPort = 12348;
  41. [Header("Python启动参数")]
  42. [Tooltip("Python脚本启动参数(完整命令行参数,不包括脚本路径)。" +
  43. "可以使用以下占位符,会自动替换为实际值:" +
  44. "{pythonPort} - Python UDP端口(接收图像)" +
  45. "{resultIp} - Unity结果接收IP(默认127.0.0.1)" +
  46. "{resultPort} - Unity结果接收端口(默认12348)" +
  47. "比较全的指令:--input \"udp://0.0.0.0:{pythonPort}\" --result_ip {resultIp} --result_port {resultPort} --control_port 12349 --max_keypoints 64 --use_fp16 --use_tensorrt --tensorrt_precision fp16 --depth_confidence 0.90 --width_confidence 0.95 --keypoint_threshold 0.015 --nms_radius 5 --show_fps")]
  48. [TextArea(3, 8)]
  49. public string pythonScriptArgs = "--input \"udp://0.0.0.0:{pythonPort}\" --result_ip {resultIp} --result_port {resultPort} --control_port 12349 --use_tensorrt";
  50. [Header("Python启动参数(Roma)")]
  51. [Tooltip("Roma 脚本启动参数(完整命令行参数,不包括脚本路径)。" +
  52. "可用占位符:" +
  53. "{pythonPort} - 传统 udp:// 输入端口(作为 --input udp://0.0.0.0:{pythonPort} 的端口,兼容旧风格)" +
  54. "{wifiPort} - OrangePi WiFi 图传接收端口(FrameHeader 分片输入)" +
  55. "{forwardPort} - Python->Unity 图像转发端口(用于显示)" +
  56. "{resultIp} - Unity结果接收IP" +
  57. "{resultPort} - Unity结果接收端口" +
  58. "{controlPort} - Unity->Python 控制端口(n/s/r)" +
  59. "示例:--input udp://0.0.0.0:{pythonPort} --reference_image ... --model tiny ... --result_ip {resultIp} --result_port {resultPort} --control_port {controlPort}")]
  60. [TextArea(3, 8)]
  61. public string romaPythonScriptArgs =
  62. "--input udp://0.0.0.0:{pythonPort} --reference_image assets/sacre_coeur_A.jpg --model tiny --resize 320 240 " +
  63. "--sample_num 500 --sample_thresh 0.05 --ransac_reproj_threshold 4.0 --min_matches 120 --min_inlier_ratio 0.08 " +
  64. "--roma_interval 10 --smooth_alpha 0.9 --trail_len 150 --show_fps --max_fps 90 --max_display_fps 60 --idle_sleep_ms 2 --timer_print_interval 0.5 " +
  65. "--result_ip {resultIp} --result_port {resultPort} --control_port {controlPort} --log_send_result";
  66. [Header("Python启动参数(Roma WiFi/FrameHeader)")]
  67. [Tooltip("Roma WiFi 图传版桥接脚本(demo_roma_camera_position_async_unity_bridge.py)启动参数模板。" +
  68. "可用占位符:" +
  69. "{wifiPort} - OrangePi WiFi 图传接收端口(--wifi_listen_port)" +
  70. "{forwardPort} - Python->Unity 图像转发端口(--forward_port)" +
  71. "{deviceInfoPort} - Python->Unity 设备信息上报端口(JSON)" +
  72. "{resultIp} - Unity结果接收IP" +
  73. "{resultPort} - Unity结果接收端口" +
  74. "{controlPort} - Unity->Python 控制端口(n/s/r)")]
  75. [TextArea(3, 8)]
  76. public string romaWifiPythonScriptArgs =
  77. "--input udp://0.0.0.0:{wifiPort} " +
  78. "--reference_image assets/sacre_coeur_A.jpg --model tiny --resize 320 240 " +
  79. "--sample_num 500 --sample_thresh 0.05 --ransac_reproj_threshold 4.0 --min_matches 120 --min_inlier_ratio 0.08 " +
  80. "--roma_interval 10 --smooth_alpha 0.9 --trail_len 150 " +
  81. "--forward_ip {resultIp} --forward_port {forwardPort} --forward_fps 30 " +
  82. "--device_info_ip {resultIp} --device_info_port {deviceInfoPort} " +
  83. "--result_ip {resultIp} --result_port {resultPort} --control_port {controlPort} " +
  84. "--show_fps --max_fps 90 --max_display_fps 60 --idle_sleep_ms 2 --timer_print_interval 0.5";
  85. [Header("Roma 控制端口(Unity -> Python)")]
  86. [Tooltip("Roma 控制端口占位符 {controlPort} 的默认值(与 Unity 侧 Roma 控制端口保持一致)。")]
  87. public int romaControlPort = 12349;
  88. [Header("Roma WiFi 图传端口(OrangePi -> Python)")]
  89. [Tooltip("Roma WiFi 图传接收端口占位符 {wifiPort} 的默认值(避免与广播 12345 冲突)。\n" +
  90. "注意:若同一台机器上同时运行旧 LightGlue_Deployment 场景(其 hardwarePort 也可能是 12346),会发生端口占用冲突。")]
  91. public int romaWifiListenPort = 12346;
  92. [Header("Roma 图像转发端口(Python -> Unity)")]
  93. [Tooltip("Roma Python->Unity 图像转发端口占位符 {forwardPort} 的默认值(用于 Unity 显示 RawImage)。")]
  94. public int romaForwardPort = 12366;
  95. [Header("Roma 设备信息上报端口(Python -> Unity, JSON)")]
  96. [Tooltip("Python 将硬件 source_ip/source_port 通过 JSON 上报给 Unity 的端口占位符 {deviceInfoPort}。")]
  97. public int romaDeviceInfoPort = 12350;
  98. [Header("Roma 硬件模式")]
  99. [Tooltip("OrangePi:广播发现+下发图传配置;ESP32:无需下发配置,直接有图像回传则启动算法流程与结果接收。")]
  100. public RomaHardwareMode romaHardwareMode = RomaHardwareMode.Esp32;
  101. [Header("Roma 本机目标IP(PC -> OrangePi config target_ip)")]
  102. [Tooltip("下发给 OrangePi 的 target_ip(也就是本机接收 WiFi 图传的 IP)。用于持久化 RomaNetworkConfigUIController.localTargetIpField。")]
  103. public string romaLocalTargetIp = "";
  104. [Header("Roma ESP32 设备信息(后续用于下发硬件参数)")]
  105. [Tooltip("ESP32 设备 IP(仅在 romaHardwareMode=ESP32 时使用;供后续 ImageTransmissionUIController 下发硬件信息)。")]
  106. public string romaEsp32DeviceIp = "";
  107. [Tooltip("ESP32 设备端口(仅在 romaHardwareMode=ESP32 时使用;供后续 ImageTransmissionUIController 下发硬件信息)。")]
  108. public int romaEsp32DevicePort = 8888;
  109. [Header("启动控制")]
  110. [Tooltip("是否在Play时自动启动所有相关组件(如果为false,需要手动启动)")]
  111. public bool autoStartOnPlay = false;
  112. [Tooltip("是否以无窗口方式启动 Python(--no_display),避免绘制窗口在游戏背后时卡顿;取消勾选可保留 Python 窗口便于调试")]
  113. public bool pythonNoDisplay = true;
  114. /// <summary>
  115. /// 验证IP地址格式
  116. /// </summary>
  117. public bool ValidateIpAddress(string ip)
  118. {
  119. if (string.IsNullOrWhiteSpace(ip))
  120. return false;
  121. if (ip == "0.0.0.0")
  122. return true; // 允许监听所有接口
  123. string[] parts = ip.Split('.');
  124. if (parts.Length != 4)
  125. return false;
  126. foreach (string part in parts)
  127. {
  128. if (!int.TryParse(part, out int num) || num < 0 || num > 255)
  129. return false;
  130. }
  131. return true;
  132. }
  133. /// <summary>
  134. /// 验证配置有效性
  135. /// </summary>
  136. public bool Validate()
  137. {
  138. if (!ValidateIpAddress(hardwareBindIp))
  139. {
  140. Debug.LogError($"[NetworkConfig] 无效的硬件绑定IP: {hardwareBindIp}");
  141. return false;
  142. }
  143. if (!ValidateIpAddress(hardwareControlIp))
  144. {
  145. Debug.LogError($"[NetworkConfig] 无效的硬件控制IP: {hardwareControlIp}");
  146. return false;
  147. }
  148. if (!ValidateIpAddress(pythonIp))
  149. {
  150. Debug.LogError($"[NetworkConfig] 无效的Python IP: {pythonIp}");
  151. return false;
  152. }
  153. if (!ValidateIpAddress(pythonResultBindIp))
  154. {
  155. Debug.LogError($"[NetworkConfig] 无效的Python结果绑定IP: {pythonResultBindIp}");
  156. return false;
  157. }
  158. if (hardwarePort <= 0 || hardwarePort > 65535)
  159. {
  160. Debug.LogError($"[NetworkConfig] 无效的硬件端口: {hardwarePort}");
  161. return false;
  162. }
  163. if (hardwareControlPort <= 0 || hardwareControlPort > 65535)
  164. {
  165. Debug.LogError($"[NetworkConfig] 无效的硬件控制端口: {hardwareControlPort}");
  166. return false;
  167. }
  168. if (pythonPort <= 0 || pythonPort > 65535)
  169. {
  170. Debug.LogError($"[NetworkConfig] 无效的Python端口: {pythonPort}");
  171. return false;
  172. }
  173. if (pythonResultPort <= 0 || pythonResultPort > 65535)
  174. {
  175. Debug.LogError($"[NetworkConfig] 无效的Python结果端口: {pythonResultPort}");
  176. return false;
  177. }
  178. return true;
  179. }
  180. /// <summary>
  181. /// 获取处理后的Python启动参数(替换占位符)
  182. /// </summary>
  183. public string GetPythonScriptArgs()
  184. {
  185. if (string.IsNullOrWhiteSpace(pythonScriptArgs))
  186. return string.Empty;
  187. // 替换所有占位符
  188. string args = pythonScriptArgs;
  189. args = args.Replace("{pythonPort}", pythonPort.ToString());
  190. args = args.Replace("{resultIp}", pythonResultBindIp);
  191. args = args.Replace("{resultPort}", pythonResultPort.ToString());
  192. return args;
  193. }
  194. /// <summary>
  195. /// 获取处理后的 Roma 启动参数(替换占位符)。
  196. /// </summary>
  197. public string GetRomaPythonScriptArgs()
  198. {
  199. if (string.IsNullOrWhiteSpace(romaPythonScriptArgs))
  200. return string.Empty;
  201. string args = romaPythonScriptArgs;
  202. args = args.Replace("{pythonPort}", pythonPort.ToString());
  203. args = args.Replace("{wifiPort}", romaWifiListenPort.ToString());
  204. args = args.Replace("{forwardPort}", romaForwardPort.ToString());
  205. args = args.Replace("{resultIp}", pythonResultBindIp);
  206. args = args.Replace("{resultPort}", pythonResultPort.ToString());
  207. args = args.Replace("{controlPort}", romaControlPort.ToString());
  208. return args;
  209. }
  210. /// <summary>
  211. /// 获取处理后的 Roma WiFi 图传版启动参数(替换占位符)。
  212. /// </summary>
  213. public string GetRomaWifiPythonScriptArgs()
  214. {
  215. if (string.IsNullOrWhiteSpace(romaWifiPythonScriptArgs))
  216. return string.Empty;
  217. string args = romaWifiPythonScriptArgs;
  218. args = args.Replace("{wifiPort}", romaWifiListenPort.ToString());
  219. args = args.Replace("{forwardPort}", romaForwardPort.ToString());
  220. args = args.Replace("{deviceInfoPort}", romaDeviceInfoPort.ToString());
  221. args = args.Replace("{resultIp}", pythonResultBindIp);
  222. args = args.Replace("{resultPort}", pythonResultPort.ToString());
  223. args = args.Replace("{controlPort}", romaControlPort.ToString());
  224. return args;
  225. }
  226. /// <summary>
  227. /// 获取本机用于绑定的 IPv4 地址(非回环、首选网卡)。
  228. /// 可供外部或 UI 调用,用于填充 hardwareBindIp。
  229. /// 失败时返回 "0.0.0.0"(监听所有接口)。
  230. /// </summary>
  231. public static string GetLocalBindIp()
  232. {
  233. try
  234. {
  235. var host = Dns.GetHostEntry(Dns.GetHostName());
  236. foreach (var ip in host.AddressList)
  237. {
  238. if (ip.AddressFamily == AddressFamily.InterNetwork && !IPAddress.IsLoopback(ip))
  239. return ip.ToString();
  240. }
  241. }
  242. catch (System.Exception ex)
  243. {
  244. Debug.LogWarning($"[NetworkConfig] 获取本机IP失败,使用 0.0.0.0: {ex.Message}");
  245. }
  246. return "0.0.0.0";
  247. }
  248. /// <summary>
  249. /// 将当前配置的 hardwareBindIp 设为本次获取的本机地址(可多次调用刷新)。
  250. /// </summary>
  251. public void ApplyLocalBindIp()
  252. {
  253. hardwareBindIp = GetLocalBindIp();
  254. }
  255. /// <summary>
  256. /// 创建默认配置(hardwareBindIp 自动设为本次获取的本机地址)。
  257. /// </summary>
  258. public static NetworkConfig CreateDefault()
  259. {
  260. var config = new NetworkConfig();
  261. config.hardwareBindIp = GetLocalBindIp();
  262. config.romaLocalTargetIp = GetLocalBindIp();
  263. config.romaHardwareMode = RomaHardwareMode.Esp32;
  264. return config;
  265. }
  266. }
  267. }