【案例+1】HarmonyOS官方模板优秀案例(第10期:教育行业 · 课堂应用)
💡 鸿蒙生态为开发者提供海量的HarmonyOS模板/组件,助力开发效率原地起飞 💡
★ 一键直达生态市场组件&模板市场 , 快速应用DevEco Studio插件市场集成组件&模板 ★
在之前第三期为大家介绍了“教育备考案例”(^_^点这里立即回顾)
本期带来新上模板“课堂应用模板”的案例解析
👉 覆盖20+行业,点击查看往期案例汇总贴,持续更新,点击收藏!一键三连!常看常新!
【第10期】教育行业 · 课堂应用
概述
行业洞察
- 行业诉求:
- 精准分发:面对不同的受众教育类应用有不同的业务场景,产出适配内容、精准题库等,并以高效且契合场景的方式进行分发,最终实现优质教育资源的有效传递。
- 高效流畅、操作敏捷是教育类应用不同场景重要诉求,在线学习、考试等场景出现卡顿会严重影响学习、考试的。
- 需具备智能刷题与精准辅导能力:基于大数据和算法,依据答题情况判断用户知识掌握状况,动态调整出题难度,推送契合的学习内容。
- 多端协同能力:实现手机、平板、PC 端数据实时互通,提供离线功能,便于用户利用碎片化时间用于刷题或知识点复习,并可在线后同步学习进度。
- 行业常用三方SDK

SDK链接:腾讯浏览服务SDK、高德定位SDK、百度地图SDK 、极光Push SDK、火山引擎SDK、同盾SDK、友盟SDK、微信支付SDK、支付宝SDK、听云SDK、福昕 PDF SDK、网易云信 IM SDK、保利威视频直播webSDK、支付宝分享SDK
说明:“以上三方库及链接仅为示例,三方库由三方开发者独立提供,以其官方内容为准”
案例概览(下载模板)
基于以上行业分析,本期将介绍鸿蒙生态市场教育类行业模板——课堂应用模板,为行业提供常用功能的开发案例,模板主要分首页、学习、我的三大模块。
- Stage开发模型 + 声明式UI开发范式。
- 分层架构设计 + 组件化拆分,支持开发者在开发时既可以选择完整使用模板,也可以根据需求单独选用其中的业务组件。
- 本模板已集成华为账号、广告等服务,只需做少量配置和定制即可快速实现华为账号的登录、媒体播放等功能。

本模板主要页面及核心功能如下所示:
教育学习应用模板 ├──首页 │ ├──顶部栏-搜索 │ │ ├── 搜索 │ │ └── 职级分类选择 │ │ │ ├──课堂列表 │ │ ├── 动态布局 │ │ ├── 信息流 │ │ └── 功能区 │ └──课堂详情 │ ├── 图文 │ ├── 收藏、评论 │ ├── 分享(微信、朋友圈、QQ、生成海报、复制链接等) │ └── 视频 ├──学习 │ ├──顶部栏 │ │ └── 搜索 │ ├──课堂列表 │ └──视频详情页 │ ├── 竖屏播放 │ ├── 横屏播放 │ ├── 暂停、播放、进度调节、倍速、选集、画中画 │ └── 收藏、评论、分享 │ └──我的 ├──登录 │ ├── 华为账号一键登录 │ ├── 微信登录 │ ├── 账密登录 │ └── 用户隐私协议同意 │ ├──个人主页 │ └── 头像、昵称、简介 │ ├──功能栏 │ ├── 我的课程 │ ├── 我的收藏 │ ├── 我的下载 │ └── 我的错题 │ └──常用服务 ├── 订单 ├── 消息 ├── 评论 ├── 观看记录 ├── 意见反馈 └── 设置 ├── 编辑个人信息 ├── 隐私设置 ├── 播放设置 ├── 清理缓存 ├── 检测版本 ├── 关于我们 └── 退出登录
应用架构设计
分层化模块设计
产品定制层:专注于满足不同设备或使用场景的个性化需求,作为应用的入口,是用户直接互动的界面。
本实践支持直板机、折叠机,为单HAP包形式,包含路由根节点、底部导航栏等。
基础特性层:用于存放相对独立的功能UI和业务逻辑实现。
本实践的基础特性层将应用底部导航栏的每个选项拆分成一个独立的业务功能模块。
每个功能模块都具备高内聚、低耦合、可定制的特点,支持产品的灵活部署。
公共能力层:存放公共能力,包括公共UI组件、数据管理、外部交互和工具库等共享功能。
本实践的公共能力层分为公共基础能力和可分可合组件,均打包为HAR包被上层业务组件引用。
公共基础能力包含日志、文件处理等工具类,公共类型定义,网络库,以及弹窗、加载等公共组件。
可分可合组件将包含行业特点、可完全自闭环的能力抽出独立的组件模块,支持开发者在开发中单独集成使用,详见业务组件设计章节。

本模板详细工程结构可见工程结构章节。
业务组件设计
为支持开发者单独获取特定场景的页面和功能,本模板将功能完全自闭环的部分能力抽离出独立的行业组件模块,不依赖公共基础能力包,开发者可以单独集成,开箱即用,降低使用难度。

行业场景技术方案
视频播放控制层定制化
1)场景说明
用户可播放网络视频,视频播放支持加解锁、画中画、倍速、等功能。

2)技术方案
- 基于AVPlayer实现视频播放能力。
- 使用XComponent渲染视频画面。
- ArkUI搭建控制层操作能力。
画中画
1)场景说明
用户可启动画中画功能同时操作其他界面不影响视频观看。

2)技术方案
- 采用XComponent实现画中画能力。
- 封装PipManager工具类封装画中画相关API。
模板代码
工程结构(下载模板)
详细代码结构如下所示:
Course
├──commons
│ ├──commonlib/src/main/ets // 基础模块
│ │ ├──components
│ │ │ ├──BottomEditBar.ets // 底部编辑组件
│ │ │ ├──CourseItemComponent.ets // 课程列表组件
│ │ │ ├──DeleteDialog.ets // 删除按钮组件
│ │ │ ├──DialogComponent.ets // 自适应弹框组件
│ │ │ ├──GlobalAttributeModifier.ets // 自定义动态属性
│ │ │ ├──LeftSwipeComponent.ets // 编辑组件
│ │ │ ├──NoData.ets // 空数据页面
│ │ │ └──TopBar.ets // 标题栏
│ │ ├──constants
│ │ │ ├──CommonConstants.ets // 常量
│ │ │ └──CommonEnums.ets // 路由页面
│ │ ├──models
│ │ │ ├──CollectionModel.ets // 收藏
│ │ │ ├──DownloadModel.ets // 下载
│ │ │ ├──MyCourseModel.ets // 我的课程
│ │ │ ├──OrderInfo.ets // 订单数据模型
│ │ │ ├──TopicItemModel.ets // 题目数据模型
│ │ │ ├──UserInfo.ets // 用户信息
│ │ │ ├──WindowSize.ets // 窗口数据模型
│ │ │ └──WrongQuestionModel.ets // 错题数据模型
│ │ └──utils
│ │ ├──DialogUtil.ets // 弹框
│ │ ├──Logger.ets // 日志
│ │ ├──NumberUtil.ets // 数据格式化
│ │ ├──PermissionUtil.ets // 权限
│ │ ├──PreferenceUtil.ets // 首选项
│ │ └──RouterModule.ets // 路由
│ │
│ │
│ └──http/src/main/ets // 网络模块
│ ├──apis
│ │ ├──Apis.ets // 请求接口
│ │ └──HttpRequest.ets // 请求对象
│ ├──mocks
│ │ ├──AxiosMock.ets // mock
│ │ ├──RequestMock.ets // 请求mock数据
│ │ └──Data
│ │ └──CourseData.ets // 数据源
│ ├──model
│ │ └──CourseModel.ets // 课程数据模型
│ ├──tools
│ │ └──ConvertTool.ets // 模型转换工具
│ └──types
│ └──Course.ets // 课程数据协议
├──components
│ ├──aggregated_payment // 支付组件
│ ├──aggregated_share // 分享组件
│ ├──classification // 分类组件
│ ├──feed_back // 意见反馈组件
│ ├──login_info // 登录组件
│ ├──open_ads // 广告组件
│ ├──search // 搜索组件
│ └──recorded_player // 视频播放组件
├──features
│ ├──course/src/main/ets // 学习课程模块
│ │ ├──component
│ │ │ └──CourseStudyComponent.ets // 课程数据源
│ │ ├──viewModels
│ │ │ └──CourseVM.ets // 课程数据源
│ │ └──views
│ │ └──MyLearnPage.ets // 学习页面
│ │
│ ├──home/src/main/ets // 首页模块
│ │ ├──components
│ │ │ ├──AnswerQuestionsComponent.ets // 答题view
│ │ │ ├──CommentPopup.ets // 评分弹框
│ │ │ ├──CourseCatalogComponents.ets // 课程章节弹框
│ │ │ ├──LiveBroadcastSign.ets // 直播标签view
│ │ │ ├──LiveNumberOverlay.ets // 数量view
│ │ │ ├──LiveStreamingItem.ets // 直播列表item
│ │ │ ├──AnswerSheetDialog.ets // 答题卡view
│ │ │ └──HomeTop.ets // 首页职能类型选择页面
│ │ ├──models
│ │ │ ├──Practice.ets // 模块数据
│ │ │ ├──HomeMenuModel.ets // 课程数据
│ │ │ ├──SelectRoleModel.ets // 职称级别数据
│ │ │ └──Score.ets // 打分数据
│ │ ├──viewModels
│ │ │ ├──CourseCatalogVM.ets // 章节数据刷新
│ │ │ └──HomeVM.ets // 首页数据刷新
│ │ └──pages
│ │ ├──AnswerQuestionsExamPage.ets // 答题页面
│ │ ├──AnswerQuestionsPage.ets // 答题view
│ │ ├──AnswerSheetPage.ets // 答题卡页面
│ │ ├──ChapterDetail.ets // 章节详情页面
│ │ ├──CourseListPage.ets // 课程页页面
│ │ ├──ExamResultPage.ets // 答题结果页面
│ │ ├──HomePage.ets // 首页
│ │ ├──HomeSearch.ets // 搜索页面
│ │ ├──LiveStreamingListPage.ets // 直播页面
│ │ ├──MaterialPage.ets // 资料页面
│ │ ├──TestReportPage.ets // 结果页面
│ │ └──RecordedDetail.ets // 课程详情页面
│ └──mine/src/main/ets // 个人模块
│ ├──viewModel
│ │ └──MyVM.ets // 数据处理层
│ ├──models
│ │ ├──MessageModel.ets // 消息数据
│ │ ├──SystemMessageModel.ets // 系统消息数据
│ │ └──ServiceModel.ets // 模块服务数据
│ ├──component
│ │ ├──CourseHistoryComponent.ets // 观看记录item
│ │ └──TopicItemComponent.ets // 题目标题
│ └──views
│ ├──AboutAndVersion.ets // 关于页面
│ ├──AboutPage.ets // 设置页面
│ ├──Authentication.ets // 用户协议页面
│ ├──CourseUpdateMessagePage.ets // 课程动态消息页面
│ ├──DataSharingPage.ets // 三方信息页面
│ ├──FeedbackPage.ets // 意见反馈页面
│ ├──FeedbackRecordsPage.ets // 反馈记录
│ ├──MessageListCard.ets // 消息列表组件页面
│ ├──MessagePage.ets // 消息页面
│ ├──MinePage.ets // 个人页面
│ ├──MultiLineText.ets // 消息组件页面
│ ├──MyCollectionPage.ets // 收藏页面
│ ├──MyCourseComments.ets // 课程评论页面
│ ├──MyCoursePage.ets // 课程页面
│ ├──MyDownloadPage.ets // 下载页面
│ ├──MyOrderPage.ets // 订单页面
│ ├──MyWrongQuestionPage.ets // 错题页面
│ ├──OrderListPage.ets // 订单列表页面
│ ├──OrderDetailPage.ets // 订单列表页面
│ ├──PersonalInfoPage.ets // 个人信息页面
│ ├──PersonalInformationCollectionPage.ets // 个人信息收集页面
│ ├──PrivacyAgreement.ets // 隐私协议页面
│ ├──PrivacySetPage.ets // 隐私设置页面
│ ├──PrivacyStatement.ets // 隐私声明页面
│ ├──SetUpPage.ets // 设置页面
│ ├──SystemMessage.ets // 系统消息页面
│ ├──UpdateVersionContentCard.ets // 版本更新页面
│ ├──WatchHistoryPage.ets // 观看记录页面
│ └──UserAgreement.ets // 服务协议页面
│
└──product
└──entry/src/main/ets
├──viewmodels // 首页数据
│ └──MainEntryVM.ets
├──entryability // 入口
│ └──EntryAbility.ets
├──entrybackupability // 后台
│ └──EntryBackupAbility.ets
├──models
│ ├──RouterTable.ets // 路由表
│ └──Types.ets // tab数据类型
└──pages
├──Index.ets // 入口页面
├──Launch.ets // 启动页面
├──LaunchAd.ets // 广告页面
├──Login.ets // 登录页面
├──MainEntry.ets // 主页面
├──PrivacyPolicy.ets // 隐私页面
└──PrivacyPolicyAlert.ets // 隐私弹框页面
关键代码解读
本篇代码非应用的全量代码,只包括应用的部分能力的关键代码。
- 播放器工具封装
| @ObservedV2 export class AVPlayer { callbackComplete: () => void = () => { }; callbackTimeUpdate: (nol: number, total: number) => void = (nol: number) => { }; callbackBitrateUpdate: (bitrateList: number[]) => void = (bitrateList: number[]) => { }; callbackErrorUpdate: (error: string) => void = (error: string) => { }; @Trace currentTime: number = 0; @Trace totalDuration: number = 0; @Trace isPlaying: boolean = false; @Trace isLoading: boolean = true; @Trace isLoadError: boolean = false; // surfaceID用于播放画面显示,具体的值需要通过XComponent接口获取,相关文档链接见上面XComponent创建方法 surfaceID: string = ”; // 画中画是否开启 isPipOpen: boolean = false; // 复原 isPiPWindowRestore: boolean = false; avPlayer: media.AVPlayer = {} as media.AVPlayer; isCreate: boolean = false; seekTime: number = 0; // 碰到特殊场景进入其他页时,即便加载成功也不需要播放 isResetPause: boolean = false; videoUrl: string = ”;async init(url: string, seekTime: number): Promise<void> { await this.release(); // 创建avPlayer实例对象 this.avPlayer = await media.createAVPlayer(); // 创建状态机变化回调函数 await this.setStateChangeCallback(); await this.setSourceInfoCallback(); this.isCreate = true; this.isResetPause = false; this.videoUrl = url this.avPlayer.url = url; this.isLoading = true; this.seekTime = seekTime; } getPlay() { getPause() { getStop() { changeVolume(volume: number) { changeSpeed(speed: number) { changeSeek(seekTime: number, mode: SliderChangeMode) { setSurfaceId(surfaceId: string): void { // 切换播放 setCompleteCallback(func: () => void) { setTimeUpdateCallback(func: (nol: number, total: number) => void) { setBitrateUpdateCallback(func: (bitrateList: number[]) => void) { setErrorCallback(func: (error: string) => void) { // 资源释放 // 视频信息上报函数 // 状态机 |
- 画中画工具类封装
| const CONTEXT_WIDTH: number = 1600; const CONTEXT_HEIGHT: number = 900;export class CustomXComponentController extends XComponentController { onSurfaceCreated(surfaceId: string): void { if (PipManager.getInstance().player.surfaceID === surfaceId) { return; } PipManager.getInstance().player.setSurfaceId(surfaceId); } } // 画中画控制器 constructor() { public static getInstance(): PipManager { getXComponentController(): CustomXComponentController { init(ctx: Context, navigationId: string) { startPip() { stopPip() { setAutoStart(autoStart: boolean): void { updateContentSize(width: number, height: number) { updatePiPControlStatus() { unregisterPipStateChangeListener() { // 监听画中画生命周期 // 监听画中画控制面板控件动作事件
|
模板集成
本模板提供了两种代码集成方式,供开发者自由使用。
整体集成
开发者可以选择直接基于模板工程开发自己的应用工程。
模板代码获取:
- 通过IDE插件创建模板工程,开发指导。
- 通过生态市场下载源码,下载地址。
- 通过开源仓访问源码(待上架),仓库地址。
- 打开模板工程,根据README说明中的快速入门章节,将自己的应用信息配置在模板工程内,即可运行并查看模板效果。

- 对接开发者自己的服务器接口,转换数据结构,展示真实的云侧数据。
将commons/http/src/main/ets/apis/Apis.ets文件中的mock接口替换为真实的服务器接口。

在commons/http/src/main/ets/types/Course.ets文件中将云侧开发者自定义的数据结构转换为端侧数据结构。

- 根据自己的业务内容修改模板,进行定制化开发。
按需集成
若开发者已搭建好自己的应用工程,但暂未实现其中的部分场景能力,可以选择取用其中的业务组件,集成在自己的工程中。
组件代码获取:
- 通过IDE插件创建模板工程,开发指导。
- 通过生态市场下载源码,下载地址。
- 下载组件源码,根据README中的说明,将组件包配置在自己的工程中。
- 根据API参考和示例代码,将组件集成在自己的对应场景中。
以上是第10期“课堂应用”行业优秀案例的内容,更多行业敬请期待~
欢迎下载使用行业模板“点击下载”,若您有体验和开发问题,或者迫不及待想了解XX行业的优秀案例,欢迎在评论区留言,小编会快马加鞭为您解答~
同时诚邀您添加下方二维码加入“组件模板活动社群”,精彩上新&活动不错过!

👉 HarmonyOS官方模板优秀案例系列持续更新, 点击查看往期案例汇总贴, 点击收藏方便查找!
👉【集成有礼】HarmonyOS官方模板集成创新活动,挥洒创意,赢精美大礼!点击参加
👉【HarmonyOS行业解决方案】为各行业鸿蒙应用提供全流程技术方案。点击查看
- 目前还没评论,等你发挥!

起点课堂会员权益




