适配版本：HarmonyOS 5.0.0 或以上
阅读目标：掌握如何在 TV 控制端实现统一的控制指令解析系统、权限验证逻辑，并将控制能力模块插件化，提升多设备控制的安全性与扩展性

---

🧠 一、核心设计目标

模块	目标
指令统一解析器	所有远程控制指令统一入口、解析、分发
权限判断机制	仅允许已配对/认证设备执行控制操作
控制能力插件化	控制逻辑独立封装，支持新增如「翻页」「截图」「快退」等能力
指令格式标准化	所有控制指令统一结构，便于维护和安全审查

---

📦 二、标准控制指令格式

interface ControlCommand {
  cmd: string               // 指令类型，如 scroll、seek、focusMove
  payload?: any             // 额外参数
  fromDeviceId: string      // 来源设备
  timestamp: number
}

---

🧩 三、统一指令解析器（TV 端）

const commandHandlers: Record<string, (payload: any) => void> = {
  scroll: handleScroll,
  seek: handleSeek,
  focusMove: handleFocus,
  select: handleSelect,
  screenshot: handleScreenshot,
}

接收分布式控制指令：

kvStore.on('dataChange', SUBSCRIBE_TYPE_ALL, (change) => {
  const entry = change.insertEntries[0]
  if (!entry.key.startsWith('control_cmd_')) return

  const cmd: ControlCommand = JSON.parse(entry.value.value)
  if (!isTrustedDevice(cmd.fromDeviceId)) return

  const handler = commandHandlers[cmd.cmd]
  handler?.(cmd.payload)
})

---

🔐 四、权限判断机制实现

const trustedDevices = new Set<string>()

function isTrustedDevice(deviceId: string): boolean {
  return trustedDevices.has(deviceId)
}

配对成功时加入：

trustedDevices.add(payload.fromDeviceId)

---

🧱 五、控制能力插件化封装示例

1. handleScroll.ts

export function handleScroll(direction: 'up' | 'down') {
  if (direction === 'up') scrollOffset -= 100
  else scrollOffset += 100
}

2. handleSeek.ts

export function handleSeek(seconds: number) {
  videoPlayer.seek(seconds)
}

每个控制能力独立文件夹 → 独立测试 → 易于注册与动态加载

---

🧠 六、插件注册机制（可拓展）

export function registerControl(cmd: string, handler: (payload: any) => void) {
  commandHandlers[cmd] = handler
}

// 动态注册新指令
registerControl('screenshot', payload => {
  captureScreen()
})

---

🔒 七、安全扩展建议

模块	安全策略建议
指令来源校验	所有指令需携带 fromDeviceId 并验证
指令频率限制	每台设备单位时间内最大指令数，防止刷爆
记录操作日志	所有控制记录写入 KVStore 或本地日志，便于审查与追踪
指令签名机制（进阶）	每条指令附加签名字段 + 公钥校验，确保指令未被篡改（企业级可选）

---

✅ 八、小结

能力模块	实现说明
指令统一入口	所有控制行为通过单一解析器处理，提高可维护性
权限校验机制	校验设备是否配对、是否超过速率、是否允许执行该类指令
控制模块插件化	每类控制能力独立封装，支持动态注册与统一注册表调度
安全策略建议	限频、防篡改、日志记录，保障多设备控制系统的运行安全

---

📘 下一篇预告

第20篇｜跨设备数据回流机制：TV 上报播放行为 + 手机端生成学习报告与图表可视化设计