具备界面基础功能

SHH.CameraDashboard/Services/WebApis/Models/WebApiCameraModel.cs

@@ -0,0 +1,181 @@
+using System.ComponentModel;
+using System.Runtime.CompilerServices;
+
+/// <summary>
+/// 代表一个网络摄像头的模型，用于在 UI 上显示和监控其状态。
+/// 实现了 <see cref="INotifyPropertyChanged"/> 接口，当属性值改变时可以通知视图进行更新。
+/// </summary>
+public class WebApiCameraModel : INotifyPropertyChanged
+{
+    #region --- INotifyPropertyChanged 实现 ---
+
+    /// <summary>
+    /// 当属性值更改时发生。
+    /// </summary>
+    public event PropertyChangedEventHandler? PropertyChanged;
+
+    /// <summary>
+    /// 引发 <see cref="PropertyChanged"/> 事件。
+    /// </summary>
+    /// <param name="propertyName">已更改的属性名称。如果未提供，则使用调用方成员的名称。</param>
+    protected void OnPropertyChanged([CallerMemberName] string? propertyName = null)
+    {
+        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
+    }
+
+    /// <summary>
+    /// 设置属性值的通用方法。只有当值发生变化时，才会更新字段并通知属性更改。
+    /// </summary>
+    /// <typeparam name="T">属性的类型。</typeparam>
+    /// <param name="field">对存储属性值的字段的引用。</param>
+    /// <param name="value">属性的新值。</param>
+    /// <param name="propertyName">属性的名称。</param>
+    /// <returns>如果值已更改，则返回 <c>true</c>；否则返回 <c>false</c>。</returns>
+    protected bool SetProperty<T>(ref T field, T value, [CallerMemberName] string? propertyName = null)
+    {
+        if (Equals(field, value))
+        {
+            return false;
+        }
+
+        field = value;
+        OnPropertyChanged(propertyName);
+        return true;
+    }
+
+    #endregion
+
+    #region --- 摄像头属性 ---
+
+    private int _id;
+    /// <summary>
+    /// 获取或设置摄像头的唯一标识符。
+    /// </summary>
+    public int Id
+    {
+        get => _id;
+        set => SetProperty(ref _id, value);
+    }
+
+    private string _name = string.Empty;
+    /// <summary>
+    /// 获取或设置摄像头的自定义名称。
+    /// </summary>
+    public string Name
+    {
+        get => _name;
+        set => SetProperty(ref _name, value);
+    }
+
+    private string _ipAddress = string.Empty;
+    /// <summary>
+    /// 获取或设置摄像头的 IP 地址。
+    /// </summary>
+    public string IpAddress
+    {
+        get => _ipAddress;
+        set => SetProperty(ref _ipAddress, value);
+    }
+
+    private string _brand = string.Empty;
+    /// <summary>
+    /// 获取或设置摄像头的品牌。
+    /// </summary>
+    public string Brand
+    {
+        get => _brand;
+        set => SetProperty(ref _brand, value);
+    }
+
+    private string _status = string.Empty;
+    /// <summary>
+    /// 获取或设置摄像头的综合状态描述（例如："在线", "离线", "连接中"）。
+    /// </summary>
+    public string Status
+    {
+        get => _status;
+        set => SetProperty(ref _status, value);
+    }
+
+    private bool _isOnline;
+    /// <summary>
+    /// 获取或设置一个值，该值指示摄像头的逻辑连接状态（API 是否可达）。
+    /// </summary>
+    public bool IsOnline
+    {
+        get => _isOnline;
+        set => SetProperty(ref _isOnline, value);
+    }
+
+    private bool _isPhysicalOnline;
+    /// <summary>
+    /// 获取或设置一个值，该值指示摄像头的物理连接状态（例如：通过 ICMP ping 检测）。
+    /// </summary>
+    public bool IsPhysicalOnline
+    {
+        get => _isPhysicalOnline;
+        set => SetProperty(ref _isPhysicalOnline, value);
+    }
+
+    private bool _isRunning;
+    /// <summary>
+    /// 获取或设置一个值，该值指示摄像头的流媒体服务是否正在运行。
+    /// </summary>
+    public bool IsRunning
+    {
+        get => _isRunning;
+        set => SetProperty(ref _isRunning, value);
+    }
+
+    private int _width;
+    /// <summary>
+    /// 获取或设置摄像头视频流的宽度（分辨率）。
+    /// </summary>
+    public int Width
+    {
+        get => _width;
+        set => SetProperty(ref _width, value);
+    }
+
+    private int _height;
+    /// <summary>
+    /// 获取或设置摄像头视频流的高度（分辨率）。
+    /// </summary>
+    public int Height
+    {
+        get => _height;
+        set => SetProperty(ref _height, value);
+    }
+
+    private int _realFps;
+    /// <summary>
+    /// 获取或设置摄像头当前的实际帧率（FPS）。
+    /// </summary>
+    public int RealFps
+    {
+        get => _realFps;
+        set => SetProperty(ref _realFps, value);
+    }
+
+    private long _totalFrames;
+    /// <summary>
+    /// 获取或设置自启动以来收到的总帧数。
+    /// </summary>
+    public long TotalFrames
+    {
+        get => _totalFrames;
+        set => SetProperty(ref _totalFrames, value);
+    }
+
+    private int _streamType;
+    /// <summary>
+    /// 获取或设置视频流的类型（例如：0 = 主码流, 1 = 子码流）。
+    /// </summary>
+    public int StreamType
+    {
+        get => _streamType;
+        set => SetProperty(ref _streamType, value);
+    }
+
+    #endregion
+}