Struct RealtimeCommand 

pub struct RealtimeCommand { /* private fields */ }

实时命令类型（统一使用 FrameBuffer）

设计决策：不再区分 Single 和 Package，统一使用 FrameBuffer。

• Single 只是 len=1 的 FrameBuffer
• 简化 TX 线程逻辑（不需要 match 分支）
• 消除 CPU 分支预测压力

Implementations

impl RealtimeCommand

pub fn single(frame: PiperFrame) -> Self

创建单个帧命令（向后兼容）

性能优化：添加 #[inline] 属性，因为此方法处于热路径（Hot Path）上。

pub fn package(frames: impl IntoIterator<Item = PiperFrame>) -> Self

创建帧包命令

性能优化：添加 #[inline] 属性，因为此方法处于热路径（Hot Path）上。

注意：如果用户传入 Vec<PiperFrame>，into_iter() 会消耗这个 Vec。 如果 Vec 长度 > 6，SmallVec 可能会尝试重用 Vec 的堆内存或重新分配。 虽然这是安全的，但为了最佳性能，建议用户传入数组（栈分配）。

pub fn len(&self) -> usize

获取帧数量

pub fn is_empty(&self) -> bool

检查是否为空

pub fn iter(&self) -> impl Iterator<Item = &PiperFrame>

获取帧迭代器（用于 TX 线程发送）

pub fn into_frames(self) -> FrameBuffer

消费并获取帧（用于 TX 线程发送）

Trait Implementations

impl Clone for RealtimeCommand

fn clone(&self) -> RealtimeCommand

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RealtimeCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.