客户端 SDK 总览
客户端提供 Headless SDK 和 UI Kit。Headless 暴露课堂操作与状态回调；UI Kit 提供课堂界面。二者都使用业务后端签发的课堂用户 Token。
客户端集成层次
左右滑动查看完整图示
平台入口
| 平台 | Headless / UI Kit | 接入要求 | 指南 |
|---|---|---|---|
| Web / H5 | @eduskit/sdk / @eduskit/ui | npm 0.1.1；UI 使用 Vue 3，控制器可供其他框架使用 | Web |
| Android | com.eduskit:edusdk / com.eduskit:edusdk-ui | Kotlin / Java；API 24+，发布链路使用 arm64 | Android |
| iOS / iPadOS | EduSDK / EduSDKUI | Swift / Objective-C；统一 SwiftPM 包 iOS 15+ | iOS |
| Electron | @eduskit/sdk-electron / @eduskit/ui-electron | Windows / macOS；原生依赖按系统和架构打包 | Electron |
| Qt / C++ | DesktopSdk / EduSdk::UiQt | macOS 与 Windows x64；Qt 示例需原生供应商库 | Qt / C++ |
| 微信 / 支付宝 / 抖音小程序 | 平台分包入口 createEduSdk | 源码分包；需宿主单调时钟、Worker/WASM 与设备联调 | 小程序 |
| HarmonyOS | @edukits/edusdk / @edukits/edusdk-ui | 本地 HAR；需宿主绑定供应商 Provider | HarmonyOS |
| Flutter / React Native | 规划中的原生桥接 | 暂无官方桥接插件与安装包 | 跨端桥接状态 |
进课参数
| 参数 | 来源 |
|---|---|
appId | 课堂应用 ID |
backendUrl | 当前环境的 sdk-api 入口 |
classroomId | 服务端创建课堂的返回值 |
userId | 注册用户的 eduUserId |
userToken | Server SDK 签发的 accessToken 原文 |
displayName | 业务展示名 |
客户端生产默认地址为 https://sdk.eduskit.com，测试地址为 https://sdk-dev.eduskit.com。Web 三项必填为 classroomId、userId、userToken；移动端 Options 还需要按签名显式填写应用、地址和展示名。
IM、RTC、白板的运行凭证与地址由进课响应下发。源码构建按 init.needWhiteboard / init.needRtc 决定初始化范围，并使用独立的 IM 和 RTC 凭证。完整流程见课堂生命周期。