| 要求 | 值 |
|---|---|
| 最低系统版本 | minSdk >= 26(Android 8.0) |
| 建议编译 | compileSdk 34,targetSdk 33,JDK 17 |
| 依赖 | cn.plaso:yxtsdk:2.0.21 |
| Maven | https://nexus.plaso.cn/repository/maven-public/ |
| 入口类 | YxtSDK |
AndroidManifest.xml 声明下列权限,并在进课前完成危险权限的运行时申请(与《实时课堂/Android》权限要求一致):<!-- 网络 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 麦克风 / 摄像头(危险权限,须运行时申请) -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<!-- 蓝牙(耳机 / 音频路由;Android 12+ 的 CONNECT 须运行时申请) -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- 通知(Android 13+ 须运行时申请) -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- 前台服务;Android 14+ 麦克风类型前台服务须声明 MICROPHONE -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />| 权限 | 用途 | 说明 |
|---|---|---|
RECORD_AUDIO | 上课发言 / 录制 | 危险权限,进课前申请 |
CAMERA | 视频上课 | 危险权限,进课前申请 |
BLUETOOTH / BLUETOOTH_CONNECT | 蓝牙耳机等音频设备 | CONNECT 自 Android 12 起为运行时权限 |
POST_NOTIFICATIONS | 课堂相关通知 | 自 Android 13 起为运行时权限 |
FOREGROUND_SERVICE / FOREGROUND_SERVICE_MICROPHONE | 麦克风前台服务 | Android 14+ 使用麦克风类型前台服务时必声明 |
cn.plaso:yxtsdk:2.0.21。appId、signKey(即课堂 SDK Demo 中的 appKey,同一把密钥)、loginName 与用户类型后登录联调。4000258208 / business@plaso.cn 开通开放平台账号,获取 appId、signKey(与 StyleUpime 文档中的 appKey 为同一密钥)。loginName 填登录用户名,不需要密码。userType 必须与角色一致:student / teacher / assistant;不传时服务端按学生处理。plaso(以商务分配为准)。YxtSDK.init(context, "plaso")。www.plaso.cn。init 返回后设置 PlasoProp.setRealoem_server(host) 与 setOem_server("https://{host}/")(host 取 www.plaso.cn)。EnvManager.setEnv 放在 init 之后。OpenAPI、环境管理与 PlasoProp 必须指向同一主机。POST https://{host}/dataentry/user/getToken{
"appId": "your_app_id",
"loginName": "student_login",
"userType": "student",
"validBegin": 1710000000,
"validTime": 1200,
"signature": "HEX_HMAC_SHA1"
}appId、loginName、userType、validBegin(Unix 秒)、validTime(建议 1200)。密码不参与。k=v&k=v。signKey 做 HmacSHA1,结果转大写十六进制(前导 0 不补)。code == 0,obj.token 为访问令牌,obj.expire 为有效秒数。接口按 loginName + userType 查用户,找不到时 code == 1(no such user)。userType 与换 Token 时相同,大小写敏感。onInitSuccess 之后再打开业务页。init,且 updateToken 成功。backButton 为 true 时显示返回。平板进入课堂首页,手机按角色进入老师或学生课堂页。YxtSDK.isPad() 区分形态(平板横屏、手机竖屏)。onTokenError 中同样调用 doLogout(),清理本地 Token 与页面后回到授权流程。RECORD_AUDIO、CAMERA、蓝牙、POST_NOTIFICATIONS;Android 14+ 已声明 FOREGROUND_SERVICE_MICROPHONE。init 成功,环境域名与 OpenAPI Host 一致。getToken 验签通过,客户端完成 updateToken。onTokenError 并能登出返回。signKey。