Agent Skills
返回列表
TCIC 原生 SDK

TCIC 原生 SDK

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_82156869/tcic。

技能介绍

你在集成时会卡在哪里

TCIC Native SDK 通常嵌在宿主 App里,而不是在 TCIC 仓库里改源码。集成方常见困境是:课堂页打不开、权限或初始化顺序不对、回调对象被释放收不到事件、自定义按钮或 builderJson 写了却不生效,以及回放、WebView 模式、离线缓存与 AppBar 显隐等配置对不上实际 SDK 版本。

技能如何帮你排查

本技能默认读者是 SDK 集成方,回答时优先指向宿主工程里的公开符号与调用点,例如 TCICManager、TCICConfig、setConfig、openTCICPage / openPlayback,以及 TCICCallback、UIEventCallback、PlaybackCallback 的注册与持有方式。工作流会先区分 Android / iOS / Objective-C,再归类问题(接入失败、生命周期、消息拦截、自动切课、拖拽浮层、layoutConfig、语言与文案覆盖等),并按专题引用能力说明:安装与权限、全量公开 API、平台集成、builderJson 与 Slot、layoutConfig、回放与 PlaybackConfig、回调与错误码、典型场景模板。

涉及 UI 自定义时,技能会帮你分清三层:配置字段(显隐、颜色、字号)、builderJson(SDK 内 Flutter 轻量 UI)、builder / NativeView(宿主原生完全掌控);点击 TCIC 页内入口后弹抽屉、BottomSheet 或原生路由,由宿主 native 实现,而不是让客户去解析 TCIC 内部 Flutter 工程。

适用边界

  • 不假设你能打开 TCIC SDK 内部文件路径;以宿主工程里的初始化、AndroidManifest.xml / Info.plist 为准。
  • 公开 API 与 config 优先于 callTCICControllerMethod 等非首选路径。
  • 若本地 SDK 方法签名与文档示例略有差异,以客户项目实际可用的 API 为准。

使用场景

  • 宿主 App 已接 TCIC,课堂页白屏或打不开,需在工程里核对 `setConfig` 与 `openTCICPage` 调用顺序
  • Android 侧自定义课堂结束弹窗或发送消息前拦截,要正确注册 `onClassEndDialogRequested` / `beforeSendMessage` 并持有回调
  • iOS 需在 TCIC 页内点击入口后弹出原生 BottomSheet,要接 `UIEventCallback` 并在宿主实现抽屉或路由
  • 回放要开 WebView 模式、自动播放或按 classId 做离线缓存,需配置 `PlaybackConfig` 与缓存回调

适合人员

  • 负责教育/会议类 App 的 Android 工程师,要在现有工程里接入 TCIC 并处理 Manifest 与运行时权限
  • 负责 iOS 或 Objective-C 混编工程的客户端开发,需把 TCIC 课堂页与原生导航、弹窗打通
  • 集成方技术负责人,要按公开 API 定制 header/footer 按钮、`builderJson` 与水印,且不能依赖 SDK 内部源码
  • 维护含回放能力的宿主 App 的前端/客户端同学,需排查 `openPlayback`、缓存状态回调与 AppBar 运行时显隐