CameraManager.cs 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663
  1. using System;
  2. using System.Collections.Generic;
  3. using System.IO;
  4. using System.Linq;
  5. using System.Reflection;
  6. using System.Text;
  7. using System.Threading.Tasks;
  8. using TeamAAS.Camera.Attributes;
  9. using TeamAAS.Camera.Enums;
  10. using TeamAAS.Camera.Interfaces;
  11. using TeamAAS.Camera.Models;
  12. namespace TeamAAS.Camera
  13. {
  14. /// <summary>
  15. /// 相机生命周期和配置管理器。
  16. /// 负责相机实例的创建、注册、连接、采集控制、移除、JSON 配置持久化以及品牌/设备发现。
  17. /// 同时作为懒汉单例使用:<c>CameraManager.Instance</c>。
  18. /// </summary>
  19. public class CameraManager : ICameraManager
  20. {
  21. #region 单例
  22. private static readonly Lazy<CameraManager> _instance =
  23. new Lazy<CameraManager>(() => new CameraManager(), isThreadSafe: true);
  24. /// <summary>
  25. /// 懒汉单例入口。首次访问时初始化,线程安全。
  26. /// </summary>
  27. public static CameraManager Instance => _instance.Value;
  28. #endregion
  29. #region 字段
  30. private readonly Dictionary<Guid, ICamera> _cameras;
  31. private readonly object _sync = new object();
  32. // 设备发现 provider 缓存
  33. private List<CameraProviderInfo> _providers;
  34. private readonly object _providerLock = new object();
  35. // 反射扫描结果缓存
  36. private List<CameraTypeInfo> _scannedTypes;
  37. private readonly object _scanLock = new object();
  38. #endregion
  39. #region 构造
  40. /// <summary>
  41. /// 默认构造(供单例和 DI 容器使用)。
  42. /// 外部不应直接 new,请使用 <see cref="Instance"/> 或通过 DI 注入 <see cref="ICameraManager"/>。
  43. /// </summary>
  44. public CameraManager()
  45. {
  46. _cameras = new Dictionary<Guid, ICamera>();
  47. }
  48. #endregion
  49. #region 相机生命周期
  50. public bool CreateCamera(Guid id, CameraInfo cameraInfo)
  51. {
  52. if (cameraInfo == null) throw new ArgumentNullException(nameof(cameraInfo));
  53. var camera = CreateCameraInstance(id, cameraInfo);
  54. ICamera existing = null;
  55. lock (_sync)
  56. {
  57. _cameras.TryGetValue(id, out existing);
  58. _cameras[id] = camera;
  59. }
  60. if (existing != null && !ReferenceEquals(existing, camera))
  61. {
  62. try
  63. {
  64. if (existing.IsGrabbing)
  65. existing.StopGrabbing();
  66. }
  67. catch { }
  68. try { existing.CloseDevice(); } catch { }
  69. }
  70. return true;
  71. }
  72. public Task<bool> CreateCameraAsync(Guid id, CameraInfo cameraInfo)
  73. {
  74. return Task.Run(() => CreateCamera(id, cameraInfo));
  75. }
  76. public ICamera GetCamera(Guid id)
  77. {
  78. lock (_sync)
  79. {
  80. return _cameras.TryGetValue(id, out var cam) ? cam : null;
  81. }
  82. }
  83. public Task<ICamera> GetCameraAsync(Guid id)
  84. {
  85. return Task.Run(() => GetCamera(id));
  86. }
  87. public IReadOnlyCollection<ICamera> GetAllCameras()
  88. {
  89. lock (_sync)
  90. {
  91. return _cameras.Values.ToList().AsReadOnly();
  92. }
  93. }
  94. public Task<IReadOnlyCollection<ICamera>> GetAllCamerasAsync()
  95. {
  96. return Task.Run(() => GetAllCameras());
  97. }
  98. public bool TryGetCamera(Guid id, out ICamera camera)
  99. {
  100. lock (_sync)
  101. {
  102. return _cameras.TryGetValue(id, out camera);
  103. }
  104. }
  105. public IReadOnlyList<ICamera> Devices
  106. {
  107. get
  108. {
  109. lock (_sync)
  110. {
  111. return _cameras.Values.ToList().AsReadOnly();
  112. }
  113. }
  114. }
  115. public bool ContainsCamera(Guid id)
  116. {
  117. lock (_sync)
  118. {
  119. return _cameras.ContainsKey(id);
  120. }
  121. }
  122. public bool ContainsSN(string serialNumber)
  123. {
  124. lock (_sync)
  125. {
  126. return _cameras?.Values.Any(c => c.SerialNumber == serialNumber) ?? false;
  127. }
  128. }
  129. public bool RemoveCamera(Guid id)
  130. {
  131. ICamera camera = null;
  132. lock (_sync)
  133. {
  134. if (_cameras.TryGetValue(id, out camera))
  135. {
  136. _cameras.Remove(id);
  137. }
  138. }
  139. if (camera != null)
  140. {
  141. try
  142. {
  143. if (camera.IsGrabbing)
  144. camera.StopGrabbing();
  145. }
  146. catch { }
  147. try
  148. {
  149. camera.CloseDevice();
  150. }
  151. catch { }
  152. return true;
  153. }
  154. return false;
  155. }
  156. public Task<bool> RemoveCameraAsync(Guid id)
  157. {
  158. return Task.Run(() => RemoveCamera(id));
  159. }
  160. public void UnRegisterCamera(Guid id)
  161. {
  162. RemoveCamera(id);
  163. }
  164. /// <summary>
  165. /// 停止采集并关闭所有相机(程序退出前调用)。
  166. /// 幂等:已关闭的设备再调一次不会抛异常。
  167. /// </summary>
  168. public void CloseAll()
  169. {
  170. List<ICamera> list;
  171. lock (_sync)
  172. {
  173. list = _cameras.Values.ToList();
  174. _cameras.Clear();
  175. }
  176. foreach (var camera in list)
  177. {
  178. try { if (camera.IsGrabbing) camera.StopGrabbing(); } catch { }
  179. try { camera.CloseDevice(); } catch { }
  180. }
  181. }
  182. public Task UnRegisterCameraAsync(Guid id)
  183. {
  184. return Task.Run(() => RemoveCamera(id));
  185. }
  186. public ICamera GetCameraByNumber(int number)
  187. {
  188. lock (_sync)
  189. {
  190. foreach (var kvp in _cameras)
  191. {
  192. if (kvp.Value != null && kvp.Value.Index == number)
  193. return kvp.Value;
  194. }
  195. }
  196. return null;
  197. }
  198. public void RemoveAllCameras()
  199. {
  200. List<Guid> ids;
  201. lock (_sync)
  202. {
  203. ids = _cameras.Keys.ToList();
  204. }
  205. foreach (var id in ids)
  206. {
  207. RemoveCamera(id);
  208. }
  209. }
  210. public (bool IsSucceed, string Message) InitializeAllCameras(CameraInfo[] cameras)
  211. {
  212. RemoveAllCameras();
  213. foreach (var info in cameras)
  214. {
  215. var camera = CreateCameraInstance(info.Id, info);
  216. lock (_sync)
  217. {
  218. _cameras[info.Id] = camera;
  219. }
  220. }
  221. bool allConnected = true;
  222. StringBuilder errors = new StringBuilder();
  223. foreach (var info in cameras)
  224. {
  225. if (TryGetCamera(info.Id, out var camera))
  226. {
  227. bool opened = camera.OpenDevice();
  228. if (!opened)
  229. {
  230. allConnected = false;
  231. errors.AppendLine($"相机 {info.CameraName}(编号: {info.CameraNo})打开失败: {camera.ErrorMessage}");
  232. }
  233. else
  234. {
  235. // 应用配置里持久化的参数快照(曝光/增益/Gamma),null 表示沿用硬件默认值
  236. ApplySavedParameters(camera, info);
  237. }
  238. }
  239. else
  240. {
  241. allConnected = false;
  242. errors.AppendLine($"未找到相机 {info.CameraName}(编号: {info.CameraNo})的实例。");
  243. }
  244. }
  245. return allConnected ? (true, "所有相机均已成功初始化并连接。") : (false, errors.ToString());
  246. }
  247. public Task<(bool IsSucceed, string Message)> InitializeAllCamerasAsync(CameraInfo[] cameras)
  248. {
  249. return Task.Run(() => InitializeAllCameras(cameras));
  250. }
  251. public void UpdateCameraNumber(Guid id, int newNumber)
  252. {
  253. if (TryGetCamera(id, out var camera))
  254. {
  255. camera.Index = newNumber;
  256. }
  257. }
  258. #endregion
  259. #region 配置持久化
  260. public static string DefaultConfigPath
  261. {
  262. get
  263. {
  264. return Path.Combine(TeamAAS.PathHelper.ConfigDirectory, "Cameras.json");
  265. }
  266. }
  267. public bool SaveConfig(string path = null)
  268. {
  269. path = path ?? DefaultConfigPath;
  270. var infos = new List<CameraInfo>();
  271. lock (_sync)
  272. {
  273. foreach (var cam in _cameras.Values)
  274. {
  275. infos.Add(new CameraInfo
  276. {
  277. Id = cam.ID,
  278. CameraNo = cam.Index,
  279. CameraName = cam.Name,
  280. CameraBrand = cam.CameraBrand,
  281. CameraType = cam.CameraType,
  282. CameraIp = cam.CameraIp,
  283. IsFindByIp = cam.IsFindByIp,
  284. SerialNumber = cam.SerialNumber,
  285. Model = cam.ModelName,
  286. ManufacturerName = cam.ManufacturerName,
  287. ExposureTime = cam.ExposureTime,
  288. Gain = cam.Gain,
  289. Gamma = cam.Gamma,
  290. });
  291. }
  292. }
  293. return TeamAAS.JsonFileStore.Save(path, infos);
  294. }
  295. public IReadOnlyList<CameraInfo> GetAllCameraInfos()
  296. {
  297. var infos = new List<CameraInfo>();
  298. lock (_sync)
  299. {
  300. foreach (var cam in _cameras.Values)
  301. {
  302. infos.Add(new CameraInfo
  303. {
  304. Id = cam.ID,
  305. CameraNo = cam.Index,
  306. CameraName = cam.Name,
  307. CameraBrand = cam.CameraBrand,
  308. CameraType = cam.CameraType,
  309. CameraIp = cam.CameraIp,
  310. IsFindByIp = cam.IsFindByIp,
  311. SerialNumber = cam.SerialNumber,
  312. Model = cam.ModelName,
  313. ManufacturerName = cam.ManufacturerName,
  314. ExposureTime = cam.ExposureTime,
  315. Gain = cam.Gain,
  316. Gamma = cam.Gamma,
  317. });
  318. }
  319. }
  320. return infos.AsReadOnly();
  321. }
  322. public void LoadConfig(string path = null)
  323. {
  324. path = path ?? DefaultConfigPath;
  325. if (!File.Exists(path)) return;
  326. var infos = TeamAAS.JsonFileStore.Load<List<CameraInfo>>(path);
  327. if (infos == null || infos.Count == 0) return;
  328. InitializeAllCameras(infos.ToArray());
  329. }
  330. #endregion
  331. #region 品牌/设备发现(原 CameraFactory 职责)
  332. /// <summary>
  333. /// 获取所有已注册的相机品牌 provider(首次访问时反射扫描并缓存)。
  334. /// </summary>
  335. private List<CameraProviderInfo> GetProviders()
  336. {
  337. if (_providers != null) return _providers;
  338. lock (_providerLock)
  339. {
  340. if (_providers != null) return _providers;
  341. _providers = ScanProviders();
  342. return _providers;
  343. }
  344. }
  345. private List<CameraProviderInfo> ScanProviders()
  346. {
  347. var result = new List<CameraProviderInfo>();
  348. // 通用模块扫描:收集全部 ICamera 实现(含 Runtime\Plugins 里的插件 DLL)
  349. foreach (var type in TeamAAS.Modularity.AssemblyScanner.FindImplementations<ICamera>())
  350. {
  351. var attr = type.GetCustomAttribute<CameraAttribute>();
  352. if (attr == null) continue;
  353. var getDevicesMethod = type.GetMethod("GetDevices", BindingFlags.Public | BindingFlags.Static);
  354. var checkInstalledMethod = type.GetMethod("CheckSoftwareInstalled", BindingFlags.Public | BindingFlags.Static);
  355. if (getDevicesMethod == null) continue;
  356. result.Add(new CameraProviderInfo
  357. {
  358. CameraType = type,
  359. Brand = attr.Brand,
  360. DisplayName = attr.DisplayName,
  361. GetDevicesDelegate = () =>
  362. {
  363. try
  364. {
  365. var r = getDevicesMethod.Invoke(null, null);
  366. if (r is CameraInfo[] arr) return arr.ToList();
  367. if (r is IEnumerable<CameraInfo> list) return list.ToList();
  368. return new List<CameraInfo>();
  369. }
  370. catch { return new List<CameraInfo>(); }
  371. },
  372. CheckInstalledDelegate = () =>
  373. {
  374. if (checkInstalledMethod == null)
  375. return (false, "");
  376. try
  377. {
  378. var r = checkInstalledMethod.Invoke(null, null);
  379. if (r is ValueTuple<bool, string> tuple) return tuple;
  380. if (r is Tuple<bool, string> t2) return (t2.Item1, t2.Item2);
  381. return (false, "");
  382. }
  383. catch { return (false, ""); }
  384. }
  385. });
  386. }
  387. return result
  388. .GroupBy(p => p.CameraType.FullName)
  389. .Select(g => g.First())
  390. .OrderBy(p => p.DisplayName)
  391. .ToList();
  392. }
  393. /// <summary>
  394. /// 搜索所有品牌的可用相机设备
  395. /// </summary>
  396. public List<CameraInfo> DiscoverAllDevices()
  397. {
  398. var allDevices = new List<CameraInfo>();
  399. int index = 1;
  400. foreach (var provider in GetProviders())
  401. {
  402. try
  403. {
  404. var devices = provider.GetDevicesDelegate();
  405. foreach (var d in devices)
  406. {
  407. d.CameraNo = index++;
  408. allDevices.Add(d);
  409. }
  410. }
  411. catch { }
  412. }
  413. return allDevices;
  414. }
  415. /// <summary>
  416. /// 按品牌搜索可用相机设备
  417. /// </summary>
  418. public List<CameraInfo> DiscoverByBrand(string brand)
  419. {
  420. var provider = GetProviders().FirstOrDefault(p => p.Brand == brand);
  421. if (provider == null)
  422. throw new NotSupportedException($"品牌 {brand} 暂未实现设备发现功能");
  423. try
  424. {
  425. return provider.GetDevicesDelegate();
  426. }
  427. catch
  428. {
  429. return new List<CameraInfo>();
  430. }
  431. }
  432. /// <summary>
  433. /// 获取已安装的相机品牌列表(用于弹窗选择)
  434. /// </summary>
  435. public List<(string Brand, string DisplayName, bool Installed)> GetAvailableBrands()
  436. {
  437. var list = new List<(string, string, bool)>();
  438. foreach (var provider in GetProviders())
  439. {
  440. try
  441. {
  442. var (installed, _) = provider.CheckInstalledDelegate();
  443. list.Add((provider.Brand, provider.DisplayName, installed));
  444. }
  445. catch
  446. {
  447. list.Add((provider.Brand, provider.DisplayName, false));
  448. }
  449. }
  450. return list;
  451. }
  452. /// <summary>
  453. /// 获取相机品牌的显示名称
  454. /// </summary>
  455. public string GetBrandDisplayName(string brand)
  456. {
  457. var provider = GetProviders().FirstOrDefault(p => p.Brand == brand);
  458. return provider?.DisplayName ?? brand;
  459. }
  460. /// <summary>
  461. /// 获取已安装的相机SDK列表
  462. /// </summary>
  463. public List<(string Name, bool Installed, string Version)> GetSdkStatus()
  464. {
  465. var list = new List<(string, bool, string)>();
  466. foreach (var provider in GetProviders())
  467. {
  468. try
  469. {
  470. var (installed, version) = provider.CheckInstalledDelegate();
  471. list.Add((provider.DisplayName, installed, version));
  472. }
  473. catch
  474. {
  475. list.Add((provider.DisplayName, false, ""));
  476. }
  477. }
  478. return list;
  479. }
  480. #endregion
  481. #region 反射扫描(类型信息)
  482. /// <summary>
  483. /// 获取所有可用的相机类型信息(通过 [Camera] 特性自动发现)。
  484. /// </summary>
  485. public IReadOnlyList<CameraTypeInfo> GetAvailableTypes()
  486. {
  487. if (_scannedTypes != null) return _scannedTypes.AsReadOnly();
  488. lock (_scanLock)
  489. {
  490. if (_scannedTypes != null) return _scannedTypes.AsReadOnly();
  491. _scannedTypes = ScanTypes();
  492. return _scannedTypes.AsReadOnly();
  493. }
  494. }
  495. private List<CameraTypeInfo> ScanTypes()
  496. {
  497. var result = new List<CameraTypeInfo>();
  498. // 通用模块扫描:收集全部 ICamera 实现(含 Runtime\Plugins 里的插件 DLL)
  499. foreach (var type in TeamAAS.Modularity.AssemblyScanner.FindImplementations<ICamera>())
  500. {
  501. var attr = type.GetCustomAttribute<CameraAttribute>();
  502. if (attr == null) continue;
  503. result.Add(new CameraTypeInfo
  504. {
  505. TypeKey = type.FullName,
  506. DisplayName = attr.DisplayName,
  507. Brand = attr.Brand,
  508. Description = attr.Description,
  509. Type = type
  510. });
  511. }
  512. return result
  513. .GroupBy(t => t.TypeKey)
  514. .Select(g => g.First())
  515. .OrderBy(t => t.DisplayName)
  516. .ToList();
  517. }
  518. #endregion
  519. #region IDisposable
  520. public void Dispose()
  521. {
  522. RemoveAllCameras();
  523. GC.SuppressFinalize(this);
  524. }
  525. #endregion
  526. #region 私有辅助
  527. private ICamera CreateCameraInstance(Guid id, CameraInfo info)
  528. {
  529. var types = GetAvailableTypes();
  530. var match = types.FirstOrDefault(t => t.Brand == info.CameraBrand);
  531. if (match == null)
  532. throw new NotSupportedException("Unsupported camera brand: " + info.CameraBrand);
  533. return (ICamera)Activator.CreateInstance(
  534. match.Type,
  535. id, info.CameraNo, info.CameraName, info.SerialNumber, info.CameraIp, info.IsFindByIp);
  536. }
  537. /// <summary>
  538. /// 相机打开成功后,把 Cameras.json 中持久化的参数快照下发到硬件。
  539. /// 属性 setter 内部已做异常兜底(失败写入 ErrorMessage),此处再整体兜底保证初始化流程不被打断。
  540. /// </summary>
  541. private static void ApplySavedParameters(ICamera camera, CameraInfo info)
  542. {
  543. if (camera == null || info == null) return;
  544. try
  545. {
  546. // 自动曝光是相机品牌特有(UVC)的运行时开关,不在这层恢复;
  547. // 恢复手动参数即可——UVC 处于自动曝光时会自行忽略手动写入。
  548. if (info.ExposureTime.HasValue) camera.ExposureTime = info.ExposureTime.Value;
  549. if (info.Gain.HasValue) camera.Gain = info.Gain.Value;
  550. if (info.Gamma.HasValue) camera.Gamma = info.Gamma.Value;
  551. }
  552. catch { }
  553. }
  554. private class CameraProviderInfo
  555. {
  556. public Type CameraType { get; set; }
  557. public string Brand { get; set; }
  558. public string DisplayName { get; set; }
  559. public Func<List<CameraInfo>> GetDevicesDelegate { get; set; }
  560. public Func<(bool isInstalled, string version)> CheckInstalledDelegate { get; set; }
  561. }
  562. #endregion
  563. }
  564. public class CameraTypeInfo
  565. {
  566. public string TypeKey { get; set; }
  567. public string DisplayName { get; set; }
  568. public string Brand { get; set; }
  569. public string Description { get; set; }
  570. public Type Type { get; set; }
  571. }
  572. }