伯索开放平台
首页API文档SDK文档
伯索官网
首页API文档SDK文档
伯索官网
  1. 云学堂模块化SDK
  • SDK 接入总览
  • 实时课堂
    • Android 实时课堂接入
    • Harmony 实时课堂接入
    • iOS 实时课堂接入
    • Electron 实时课堂接入
    • Web 实时课堂监课接入
  • 极速课堂
    • Android 极速课堂接入
    • Harmony 极速课堂接入
    • iOS 极速课堂接入
    • Electron 极速课堂接入
  • 微课
    • Android 微课接入
    • Harmony 微课接入
    • iOS 微课接入
    • Electron 微课接入
  • 资料中心
    • Android 资料中心接入
    • Harmony 资料中心接入
    • iOS 资料中心接入
    • Electron 资料中心接入
    • Web 资料中心接入
  • 文件预解析
    • Android 文件预解析接入
    • Harmony 文件预解析
    • iOS 文件预解析接入
    • Electron 文件预解析接入
  • 历史课堂回放
    • Android 历史课堂回放
    • Harmony 历史课堂回放
    • iOS 历史课堂回放
    • Electron 历史课堂回放
    • 播放器
      • 播放器 SDK 概述
      • 播放器 SDK 快速开始
      • 播放器 SDK 初始化与配置
      • 播放器 SDK 历史课堂回放
      • 播放器 SDK 移动端 WebView 嵌入
      • 播放器 SDK API 参考
      • 播放器 SDK 事件
      • 播放器 SDK 错误码
      • 播放器 SDK 常见问题
  • 云学堂模块化SDK
    • 云学堂模块化 SDK 概述
    • 云学堂模块化 SDK · Android 接入
    • 云学堂模块化 SDK · iOS 接入
    • 云学堂模块化 SDK · Harmony 接入
    • 云学堂模块化 SDK · PC 接入
    • 伯索云学堂跳转接入
  • 接入基础(Electron & Web)
    • Web
      • Web 概述
      • Web 快速开始:URL 接入监课
      • Web 初始化与配置(监课)
      • Web API 参考(监课)
      • Web 事件与回调(监课)
      • Web 错误码(监课)
      • Web 常见问题(监课)
    • Electron
      • Electron 概述
      • Electron 快速开始
      • Electron 初始化与配置
      • Electron API 参考
      • Electron 事件与回调
      • Electron 错误码
      • Electron 常见问题
  • 服务端接口与协议
    • 服务端接口与协议阅读顺序
    • 签名与鉴权
    • 签名示例
    • query 参数
    • 资料中心与文件 URL
    • 文档预解析
    • 课堂进行中数据回调
    • 课堂结束数据回调
    • 历史课堂转视频与下载
  1. 云学堂模块化SDK

云学堂模块化 SDK · iOS 接入

本文说明如何将伯索云学堂模块化 SDK 接入自有 iOS App,并对照对外 Demo:YXTSDK-iOS-Demo(以仓库内《接入说明.md》与 Podfile 为准)。
开放平台:https://open.plaso.cn/ · 用户访问 Token:https://open.plaso.cn/api-120430699 · 调用流程与签名:《Open API/调用流程》 · SDK 对接流程:《云学堂模块化SDK/概述》

1. 申请开放平台凭证#

1.
联系伯索商务开通开放平台账号。
2.
获取唯一标识 appId 与签名密钥 signKey(即课堂 SDK Demo 中的 appKey,同一把密钥)。
3.
准备测试用户 loginName(学生 / 教师 / 助教)。

2. 集成 Pod#

要求值
最低系统版本iOS 13.0
工具Xcode 14+(建议 15+),CocoaPods 1.12+
Specscdn.cocoapods.org + plaso-open-specs
主依赖PlasoFeaturedSDK 0.5.1(以 Demo Podfile / README 为准)
在 Podfile 中增加 Specs 源与依赖:
执行:
建议在 post_install 中统一 IPHONEOS_DEPLOYMENT_TARGET,并对 AliPlayer / RtsSDK 等传递依赖做 bitcode strip(Demo Podfile 已示例)。
当前 SDK 的模拟器 slice 为 x86_64。Apple Silicon 上请在 Podfile / 工程中设置:

使用对外 Demo 验证#

在授权页填写 appId、signKey、loginName 与用户类型后联调。Demo 客户端签名仅限测试。

3. 权限与 Info.plist#

课堂音视频能力需要声明:
NSCameraUsageDescription
NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription / NSPhotoLibraryAddUsageDescription
NSBluetoothAlwaysUsageDescription / NSBluetoothPeripheralUsageDescription
NSLocalNetworkUsageDescription
按需:定位相关描述
同时建议:
NSAppTransportSecurity 允许 SDK 所需资源访问(Demo 使用 NSAllowsArbitraryLoads,正式环境宜收紧)
将 yxt.html 加入 App Bundle(SDK WebView 兜底页,Demo 启动时复制到 tmp)
播放器 U3PlayerMainViewController 在 iPad 上只支持横屏。AppDelegate 的 supportedInterfaceOrientationsFor 宜直接返回 .all,同时在 Info.plist 中声明全部方向,否则 present 播放器会因方向没有交集而崩溃。

4. OpenAPI 获取 Token#

由业务服务端调用:
POST https://{host}/dataentry/user/getToken
正式环境示例 Host 为 https://www.plaso.cn。Body 示例:
{
  "appId": "your_app_id",
  "loginName": "student_login",
  "userType": "student",
  "validBegin": 1710000000,
  "validTime": 1200,
  "signature": "HEX_HMAC_SHA1"
}
签名步骤:
1.
业务参数加入 appId、validBegin、validTime(及 loginName、userType 等参与字段)。
2.
按参数名升序拼接为 k=v&k=v。
3.
使用 signKey 做 HMAC-SHA1,结果转大写十六进制得到 signature。
4.
将 signature 一并提交。
成功响应(code == 0)中 obj.token 为访问令牌,obj.expire 为有效秒数。
安全提示: Demo 在客户端签名仅为联调方便。生产环境请在自有服务端签名,避免 signKey 泄露。
无需用户密码。userType 不传时服务端默认按学生处理。

5. SDK 初始化与登录#

对应 Demo:PlasoSDKBootstrap.swift。switch(toOemPlatform: "plaso") 之后,业务域名为 https://www.plaso.cn。
拿到 Token 后(Demo 经 PlasoSDKBridge 包装,回调参数可为空):
实际业务请求示例:
POST {serviceHost}/yxt/servlet/user/getUserInfo
POST {serviceHost}/yxt/servlet/org/getOrgConfig

6. 嵌入业务页面#

前置条件:已完成 PlasoSDK.initSDK,且 Token 登录成功。建议每个 Tab 包一层 UINavigationController,SDK 页面作为该导航控制器的根控制器。

实时课堂#

设备SDK 类所在模块
iPhoneYXTLiveClassiPhoneVC(liveClass = true)PlasoLiveMini
iPadYXTRealTimeMainVCPlasoLiveMini
iPhone 的 YXTLiveClassiPhoneVC 会自己设置 navigationItem(右侧「新建课堂 / 课表」,标题处切换课堂与历史课堂)。iPad 的 YXTRealTimeMainVC 使用自绘导航栏,并在 viewWillAppear 里隐藏系统导航栏。若再套一层容器并把分段控件写到外层 navigationItem,系统导航栏显示的是外层 item,SDK 的新建课堂、课表不会出现。

作业巩固#

YXTNewHomeworkVC(PlasoFeatureWeb)。作为导航根页面嵌入,调用 startLoadWeb 时不传返回参数,Tab 根页面不显示返回。

资料中心#

平板提供入口,手机不展示。

我的#

SDK 没有统一的「我的」页面。可自建页面展示用户信息,并在 Token 失效时回到授权流程。

7. 联调检查清单#

pod install 成功,真机可运行(或 Rosetta 模拟器)。
服务端签发 Token,客户端登录成功。
iPhone / iPad 课堂页导航与新建课堂入口正常。
作业 Tab 可打开;Token 过期可回到授权页。
正式包未内置 signKey。

8. 常见问题#

Q: SignKey 能否写死在 App?
Demo 可以;正式发布请放到服务端。
Q: 是否需要密码登录?
OpenAPI getToken 不需要密码。

9. 联系方式#

对接过程中如遇文档或 SDK 问题,请通过商务 / 对接群反馈,并附带 SDK 版本、系统版本、操作步骤与日志。
修改于 2026-11-18 03:45:46
上一页
云学堂模块化 SDK · Android 接入
下一页
云学堂模块化 SDK · Harmony 接入
Built with