EntryAbility 生命周期、课堂页面、IResourceProvider、ClassConfig 和启动 API,且同样仅支持 userType=listener 学生端。唯一差异是服务端签发的 query 必须包含 d_lowLatencyClass=1。| 要求 | 值 |
|---|---|
| HarmonyOS | >= 5.0(API >= 12) |
| DevEco Studio | >= 5.0 |
| 开发语言 | ArkTS |
.ohpmrc 将伯索仓库置于首位,并在 entry/oh-package.json5 添加:{
"dependencies": {
"styleupime": "1.68.100"
}
}ohpm install。在 entry/src/main/module.json5 声明 ohos.permission.INTERNET、ohos.permission.CAMERA、ohos.permission.MICROPHONE;Demo 下载地址为 PlasoSdkHosSample。生产应用不得内置 appKey。EntryAbility 转发生命周期,并在进入课堂前注册非空 IResourceProvider:import { StyleUpime, StyleUpimeAbilityHelper } from 'styleupime';
onCreate(): void {
StyleUpimeAbilityHelper.onAbilityCreate(this);
StyleUpime.getInstance().setResourceProvider(new AppResourceProvider());
}
onDestroy(): void {
StyleUpimeAbilityHelper.onAbilityDestroy(this);
}
onWindowStageCreate(stage: window.WindowStage): void {
StyleUpimeAbilityHelper.onWindowStageCreate(this, stage);
stage.loadContent('pages/Index', () => {});
}
onWindowStageDestroy(): void {
StyleUpimeAbilityHelper.onWindowStageDestroy(this);
}AppResourceProvider 应实现 supportResourceCenter、showResourceCenter、dismissResourceCenter、getExtFileName、getPreParseFileName、signQuery 与 getWebviewUrl。未接入资料能力时,取址失败仍须回调 callback.onFilePath(null)。main_pages.json 登记固定路径 pages/PlasoLiveClassPage:import { LiveClassBackPressBridge, PlasoLiveClassView } from 'styleupime';
@Entry
@Component
struct PlasoLiveClassPage {
build() {
Stack() { PlasoLiveClassView() }.width('100%').height('100%')
}
onBackPress(): boolean {
return LiveClassBackPressBridge.handleBackPress();
}
}| 参数 | 类型 | 值 | 说明 |
|---|---|---|---|
d_lowLatencyClass | Int | 1 | 极速课 堂开关:0 关闭,1 开启。极速课堂必须传 1,并与全部 query 参数一起参与服务端签名。 |
const params: Record<string, string | number> = {
appId: Config.appId,
appType: 'liveclassSDK',
meetingId: 'class-001',
meetingType: 'public',
mediaType: 'video',
loginName: 'student-001',
userName: '小明',
userType: 'listener',
d_dimension: '1280x720',
d_lowLatencyClass: 1
};validBegin、validTime、signature 并返回完整 query。不要在客户端追加该字段或使用 appKey 签名。validBegin、validTime 和服务端生成的 signature。字段和签名规则见《服务端接口与协议/03-query参数》。classURL 和 query,其余流程与实时课堂相同:const config = new ClassConfig();
config.classURL = query;
config.query = query;
config.host = 'https://www.plaso.cn';
config.taskId = meetingId;
config.userName = userName;
config.openFileMode = UpimeConfig.OPEN_FILE_MODE_WINDOW;
config.toolboxItems = UpimeConfig.ToolBoxItem.ALL;
await StyleUpime.getInstance().launchLiveClass(config, context, '/');classURL、query、host 外,其余 ClassConfig 配置与实时课堂一致,可设置 enableInteractPpt、teachToolTypes、supportUndo、supportHighlighter、forbiddenScreenShot、enableVote、enableSaveBoard、enableAns、enableStarShow、logConfig 和 waterMarkConfig。import {
StyleUpime,
UpimeLogConfig,
UpimeWaterMarkConfig
} from 'styleupime';
const logConfig = new UpimeLogConfig();
logConfig.logDir = `${context.filesDir}/logs`;
logConfig.logLevel = UpimeLogConfig.DEBUG;
config.logConfig = logConfig;
const waterMarkConfig = new UpimeWaterMarkConfig();
waterMarkConfig.text = 'your-watermark';
waterMarkConfig.size = 14;
waterMarkConfig.opacity = 0.5;
config.waterMarkConfig = waterMarkConfig;
StyleUpime.getInstance().updateProhibitedWords(['违禁词1', '违禁词2']);logLevel 分别为 DEBUG=0、INFO=1