腾讯云实时互动教育版 SDK 助手

集成教育版 SDK 时容易踩的坑

@tencent-classroom/sdk（v2）以 TencentClassroom 为唯一入口，生命周期是 init() → joinClass() → 课中互动 → leaveClass() + destroy()。异步接口统一返回 TResult，要靠 result.ok 判断成败，而不是 try/catch。远端画面应跟随 stageList$ 做 bindRemoteView / unbindRemoteView，学生还要在 stageStatus$ === 'active' 后再推流。班型在代码里用 isSmallRoom() / isBigRoom() 等判断，和产品名称并不总是一一对应。

技能如何工作

本技能扮演 tcic-sdk-helper，围绕三类场景：

• 代码生成：确认角色（teacher / student / assistant / supervisor）与场景（音视频、IM、白板、成员管理等），按 templates/ 组装完整 import、生命周期顺序、清理与订阅注销逻辑，并在输出前跑诊断清单。
• 文档查询：按关键词路由到 references/（生命周期、媒体、IM、成员、白板、Signal、事件、错误码、班型与 token 等），避免凭空编造 API。
• 代码诊断：对你贴的接入代码按优先级检查生命周期、TResult、资源释放、事件注册时机、上台权限与 stageList$ 驱动绑定等，用 🔴/🟡/🟢 标注。

适用边界

规则基于 SDK v2.0.0-alpha.0；版本不一致时应先对齐依赖。references 未覆盖时，技能会优先查本地 index.d.ts，仍无法确认则提示查官方文档，不会猜测枚举或签名。它解决的是接入范式与常见错误，不能替代你在业务侧准备 classId、userId、token 以及 DOM 容器等运行环境。