ActiveProtect/src/Models/Jammer/IJammer.cs

63 lines
2.1 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

namespace ActiveProtect.Models
{
/// <summary>
/// 干扰设备接口
/// 定义了所有干扰设备必须实现的基本功能和属性
/// </summary>
/// <remarks>
/// 该接口用于定义干扰设备的标准行为,包括:
/// - 干扰状态的控制(开启/关闭)
/// - 干扰功率的监控
/// - 干扰状态的查询
/// 所有具体的干扰器实现(如激光、红外、毫米波等)都必须实现此接口
/// </remarks>
public interface IJammer
{
/// <summary>
/// 获取一个值,该值指示干扰器当前是否处于工作状态
/// </summary>
/// <value>
/// true 表示干扰器正在工作false 表示干扰器处于停止状态
/// </value>
bool IsJamming { get; }
/// <summary>
/// 获取当前干扰功率值
/// </summary>
/// <value>
/// 当前干扰功率,单位:瓦特(W)
/// 当干扰器未工作时返回0
/// </value>
double CurrentJammingPower { get; }
/// <summary>
/// 启动干扰器,开始执行干扰操作
/// </summary>
/// <remarks>
/// 调用此方法将使干扰器进入工作状态,开始输出干扰信号
/// 如果干扰器已经在工作,则此调用不会产生任何效果
/// </remarks>
void StartJamming();
/// <summary>
/// 停止干扰器的工作
/// </summary>
/// <remarks>
/// 调用此方法将使干扰器停止工作,终止干扰信号的输出
/// 如果干扰器已经停止,则此调用不会产生任何效果
/// </remarks>
void StopJamming();
/// <summary>
/// 获取干扰器当前的工作状态描述
/// </summary>
/// <returns>
/// 返回描述干扰器当前状态的字符串,包括:
/// - 工作状态(开启/关闭)
/// - 当前功率
/// - 其他相关状态信息
/// </returns>
string GetJammingStatus();
}
}