Podfile 为准)。appId 与签名密钥 signKey(即课堂 SDK Demo 中的 appKey,同一把密钥)。loginName(学生 / 教师 / 助教)。| 要求 | 值 |
|---|---|
| 最低系统版本 | iOS 13.0 |
| 工具 | Xcode 14+(建议 15+),CocoaPods 1.12+ |
| Specs | cdn.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 已示例)。x86_64。Apple Silicon 上请在 Podfile / 工程中设置:appId、signKey、loginName 与用户类型后联调。Demo 客户端签名仅限测试。NSCameraUsageDescriptionNSMicrophoneUsageDescriptionNSPhotoLibraryUsageDescription / NSPhotoLibraryAddUsageDescriptionNSBluetoothAlwaysUsageDescription / NSBluetoothPeripheralUsageDescriptionNSLocalNetworkUsageDescriptionNSAppTransportSecurity 允许 SDK 所需资源访问(Demo 使用 NSAllowsArbitraryLoads,正式环境宜收紧)yxt.html 加入 App Bundle(SDK WebView 兜 底页,Demo 启动时复制到 tmp)U3PlayerMainViewController 在 iPad 上只支持横屏。AppDelegate 的 supportedInterfaceOrientationsFor 宜直接返回 .all,同时在 Info.plist 中声明全部方向,否则 present 播放器会因方向没有交集而崩溃。POST https://{host}/dataentry/user/getTokenhttps://www.plaso.cn。Body 示例:{
"appId": "your_app_id",
"loginName": "student_login",
"userType": "student",
"validBegin": 1710000000,
"validTime": 1200,
"signature": "HEX_HMAC_SHA1"
}appId、validBegin、validTime(及 loginName、userType 等参与字段)。k=v&k=v。signKey 做 HMAC-SHA1,结果转大写十六进制得到 signature。signature 一并提交。code == 0)中 obj.token 为访问令牌,obj.expire 为有效秒数。安全提示: Demo 在客户端签名仅为联调方便。生产环境请在自有服务端签名,避免 signKey泄露。
userType 不传时服务端默认按学生处理。PlasoSDKBootstrap.swift。switch(toOemPlatform: "plaso") 之后,业务域名为 https://www.plaso.cn。PlasoSDKBridge 包装,回调参数可为空):POST {serviceHost}/yxt/servlet/user/getUserInfoPOST {serviceHost}/yxt/servlet/org/getOrgConfigPlasoSDK.initSDK,且 Token 登录成功。建议每个 Tab 包一层 UINavigationController,SDK 页面作为该导航控制器的根控制器。| 设备 | SDK 类 | 所在模块 |
|---|---|---|
| iPhone | YXTLiveClassiPhoneVC(liveClass = true) | PlasoLiveMini |
| iPad | YXTRealTimeMainVC | PlasoLiveMini |
YXTLiveClassiPhoneVC 会自己设置 navigationItem(右侧「新建课堂 / 课表」,标题处切换课堂与历史课堂)。iPad 的 YXTRealTimeMainVC 使用自绘导航栏,并在 viewWillAppear 里隐藏系统导航栏。若再套一层容器并把分段控件写到外层 navigationItem,系统导航栏显示的是外层 item,SDK 的新建课堂、课表不会出现。YXTNewHomeworkVC(PlasoFeatureWeb)。作为导航根页面嵌入,调用 startLoadWeb 时不传返回参数,Tab 根页面不显示返回。pod install 成功,真机可运行(或 Rosetta 模拟器)。signKey。getToken 不需要密码。