struct ThermalTelemetry {
    // 芯片级：SoC 内置热区传感器（CPU/GPU/DSP/NPU/Modem）
    float soc_tz[THERMAL_ZONE_MAX];      // 单位：℃，采样 1Hz
    // 皮肤级：电池盖/中框 NTC/金属热敏电阻
    float skin_temp[SKIN_SENSOR_MAX];    // 单位：℃，采样 0.5Hz
    // 环境级：红外测温/气压推算环境温度
    float ambient_temp;                  // 单位：℃
    // 运动状态：加速度计判断手持/桌面/支架模式
    DevicePose pose;                     
    uint64_t timestamp_ms;
};

┌─────────────────────────────────────────────────────┐
│              Thermal Adaptive Controller            │
├─────────────┬─────────────┬─────────────┬───────────┤
│ Thermal     │ Power       │ Network     │ Business  │
│ Monitor     │ Estimator   │ Predictor   │ Context   │
│ (Sensor HAL)│ (Perfetto)  │ (CC/BWE)    │ (Meeting) │
└──────┬──────┴──────┬───────┴──────┬──────┴────┬─────┘
       │             │              │           │
       ▼             ▼              ▼           ▼
┌─────────────────────────────────────────────────────┐
│           MPC Solver (C++ / OR-Tools)               │
│  + Tiny-PPO Policy Net (TFLite / MNN / NCNN)        │
└────────────────────┬────────────────────────────────┘
                     │ Encoding Parameter Vector
                     ▼
┌─────────────────────────────────────────────────────┐
│         Codec Adapter (MediaCodec / VideoToolbox)   │
│  - 动态重配置：无需重建 Surface，Seamless 切换      │
│  - 硬编/软编无缝切换：保持参考帧一致性               │
└─────────────────────────────────────────────────────┘

// 伪代码：编码器切换状态机
enum EncoderState { HARDWARE, SOFTWARE, TRANSITIONING }
void switchEncoder(EncoderTarget target) {
    if (current == target) return;
    state = TRANSITIONING;
    // 1. 预热目标编码器，注入最近 2 个 IDR 作为参考
    targetEncoder.flush(); 
    targetEncoder.queueInputBuffer(lastIDR1, lastIDR2);
    // 2. 双编并行 1 GOP，输出端按 PTS 去重
    dualEncodeGOP();
    // 3. 原子切换输出管道
    atomicSwitchOutputSink(targetEncoder);
    state = target;
}

温度(℃)
50 ┤                    ╭──── 基线触发热节流断崖
   │                   ╱
45 ┤        ╭────────╯      自适应策略平滑收敛
   │       ╱
40 ┤──────╯
   └──────────────────────────────────────► 时间(min)
     0    20    40    60    80   100   120

// 统一编码参数增量结构：仅下发变化字段，避免全量重配置
struct CodecParamsDelta {
    std::optional<int32_t> target_bitrate_bps;
    std::optional<float>   target_framerate_fps;
    std::optional<int32_t> qp_min, qp_max;
    std::optional<GopStructure> gop_struct;      // IBBP / IBP / IP / I_ONLY
    std::optional<Resolution> resolution;        // 触发重建 Surface
    std::optional<EncoderPreference> preference; // HARDWARE / SOFTWARE / HYBRID
    std::optional<ROIMap> roi_map;               // 帧级生效
    uint64_t apply_from_pts_us = 0;              // 生效时间戳，实现流水线对齐
};

// 统一热控控制器接口
class IThermalCodecControl {
public:
    virtual ~IThermalCodecControl() = default;
    
    // 初始化：注入平台相关句柄
    virtual Result init(PlatformContext ctx, CodecCapability caps) = 0;
    
    // 核心控制入口：由 ThermalAdaptiveController 周期调用
    virtual Result applyParamsDelta(const CodecParamsDelta& delta) = 0;
    
    // 紧急兜底：L3 级别调用，强制最低配置
    virtual Result emergencyThrottle() = 0;
    
    // 查询当前编码器真实状态（用于 MPC 状态估计）
    virtual CodecRuntimeStatus queryStatus() = 0;
    
    // 注入参考帧（硬软切换时保持参考一致性）
    virtual Result injectReferenceFrames(const std::vector<EncodedFrame>& idr_frames) = 0;
};

// 平台工厂模式注册
class ThermalCodecFactory {
public:
    using Creator = std::function<std::unique_ptr<IThermalCodecControl>()>;
    static void registerPlatform(const std::string& platform_id, Creator creator);
    static std::unique_ptr<IThermalCodecControl> create(const std::string& platform_id);
};

// 伪代码：帧级 RC 决策入口
int32_t ThermalAwareRC::decideFrameQP(const FrameContext& ctx) {
    // 1. 基础 QP 来自传统 RDO / lambda 映射
    int base_qp = traditionalRDO(ctx.frame_type, ctx.lambda);
    
    // 2. 热修正项：基于未来 N 帧温升预测
    float thermal_pressure = thermal_predictor_.getPressure(ctx.pts_us); // [0.0, 1.0]
    
    // 3. 功耗敏感度：I 帧功耗 >> P 帧 >> B 帧
    float power_sensitivity = getPowerSensitivity(ctx.frame_type); 
    
    // 4. 计算修正量：压力大时，优先抬高高功耗帧 QP
    int delta_qp = std::round(thermal_pressure * power_sensitivity * MAX_QP_DELTA);
    
    // 5. 滞回平滑：防止相邻帧 QP 抖动
    delta_qp = hysteresis_filter_.update(delta_qp);
    
    // 6. 硬性约束：不超过上层下发的 [qp_min, qp_max]
    return clamp(base_qp + delta_qp, rc_config_.qp_min, rc_config_.qp_max);
}

enum class ComputeTaskPriority {
    CRITICAL_ENCODING = 0,    // 视频编码（硬编优先，不可抢占）
    CRITICAL_AUDIO = 1,       // 音频处理/回声消除
    HIGH_AI_REALTIME = 2,     // 实时字幕/翻译/虚拟背景（帧级截止时间 < 33ms）
    NORMAL_AI_BATCH = 3,      // 会议纪要/向量化/离线推理（可延迟、可批处理）
    BEST_EFFORT = 4           // 日志上传/统计
};

struct ComputeToken {
    ComputeTaskPriority priority;
    int64_t deadline_us;      // 绝对截止时间
    float estimated_power_mw; // 预估功耗
    std::function<void()> task;
};

class ComputeResourceBroker {
public:
    // 统一提交入口，返回 future
    virtual std::future<Result> submit(ComputeToken token) = 0;
    
    // 热感知调度策略注入
    virtual void setThermalPolicy(const ThermalSchedulingPolicy& policy) = 0;
    
    // 查询当前 NPU/GPU/DSP 负载与温度
    virtual ComputeLoadSnapshot queryLoad() = 0;
};

+------------------+      USB/PCIe       +-------------------------+
|  Host Controller | <-----------------> |  DUT (Device Under Test)|
|  (Python/Pytest) |   ADB / SSH / RDP   |  (Phone/PC/Board)       |
+------------------+                     +-------------------------+
        |                                         |
        | 1. 温控箱指令 (SCPI/Modbus)              | 2. 热电偶/红外热像仪 (高精度地表温)
        v                                         v
+------------------+                     +-------------------------+
|  Thermal Chamber |                     |  Power Analyzer         |
|  (-40℃ ~ +85℃)   |                     |  (Keysight N6705C /     |
|  +/- 0.5℃        |                     |   Rohde & Schwarz       |
+------------------+                     |   NGU401)               |
        |                                 +-------------------------+
        | 3. 网络损伤仪
        v
+------------------+
|  Network Impair  |
|  (Spirent /      |
|   Ixia / TC)     |
+------------------+

# test_case_thermal_throttle_1080p_30fps_5g_weak.yaml
metadata:
  id: "THERMAL-001"
  title: "1080p30 5G弱网长时热节流稳定性"
  tags: [regression, thermal, weak_network, 1080p]
  duration_min: 120

environment:
  chamber_temp_c: 35
  humidity_rh: 40
  network_profile: "5G_NSA_Band_n78_RSRP_-95_SNR_10_PLR_5%" # 预定义网络模板

dut_setup:
  app_version: "latest_debug"
  config_overrides:
    enable_thermal_adaptive: true
    log_level: "VERBOSE"
    metrics_upload_interval_sec: 10

stimulus:
  - type: "join_meeting"
    params: { meeting_id: "auto_gen", role: "host", video_on: true, screen_share: false }
  - type: "inject_traffic"
    params: { pattern: "conversation_3p", duration_sec: 7200 }

oracles: # 断言规则
  - metric: "skin_temp_max_c"
    assert: "lt(45.0)" # 皮肤温度不超过 45℃
  - metric: "throttle_event_count"
    assert: "eq(0)"    # 零系统级热节流
  - metric: "vmaf_mean"
    assert: "gt(80)"   # 平均 VMAF > 80
  - metric: "freeze_rate_percent"
    assert: "lt(2.0)"  # 卡顿率 < 2%
  - metric: "codec_switch_glitch_count"
    assert: "eq(0)"    # 无切换花屏/黑帧

teardown:
  - "dump_thermal_logs"
  - "dump_codec_stats"
  - "generate_perfetto_trace"

graph LR
    A[Code Push] --> B{Unit Test}
    B -->|Pass| C[Build Debug APK/IPA]
    C --> D[Device Farm Scheduling]
    D --> E[Thermal Chamber Pre-cool]
    E --> F[Parallel Test Execution]
    F --> G[Real-time Metrics Streaming]
    G --> H{Threshold Gate}
    H -->|Fail| I[Auto Bisect + Alert]
    H -->|Pass| J[Generate Report]
    J --> K[Merge Gate]
    
    subgraph "Nightly Long Run"
    L[12h Soak Test] --> M[Trend Analysis]
    M --> N[Model Drift Detection]
    end

// 扩展 WebRTC 标准接口，允许应用层感知/控制热状态
partial dictionary RTCRtpEncodingParameters {
    // 当前热状态：'nominal' | 'warm' | 'hot' | 'critical'
    readonly attribute ThermalState thermalState; 
    
    // 允许应用设定热节流下的最低画质底线
    attribute double minQualityThermalThrottle; // 0.0 ~ 1.0 映射 VMAF
    
    // 回调：编码器即将因热节流降级
    eventhandler onthermaladapt;
}

enum ThermalState { "nominal", "warm", "hot", "critical" };

// AV1 / VVC 编码器配置扩展
typedef struct {
    // ... 现有字段 ...
    
    // 热感知控制
    int32_t thermal_aware_rc_enable;        // 1: 开启热感知 RC
    float   thermal_pressure;               // 0.0~1.0 外部注入热压力
    int32_t max_qp_delta_thermal;           // 热压力下允许的最大 QP 增量
    int32_t min_resolution_thermal;         // 热节流允许的最低分辨率索引
    int32_t target_skin_temp_c;             // 目标皮肤温度 (℃)，编码器内部反推功耗预算
    
    // 功耗模型回调：编码器内部调用，上层注入实时功耗估算
    float (*get_encoding_power_mw)(void* opaque, int frame_type, int qp, int resolution_idx);
    void* power_opaque;
} AV1EncoderConfig_Ext / VVCEncoderConfig_Ext;