LoveChengke
c7f215a09c
- 增加课件上传、班级可见范围、设备补收与传输进度 - 整合自定义灵动岛编辑器和相关客户端交互 - 同步三端契约、数据库迁移、部署配置与隔离回归 - 按源码统一文档与官网说明，移除过时任务书和审查记录 - 保持产品版本为 1.4.0
51 lines
3.4 KiB
Markdown
51 lines
3.4 KiB
Markdown
---
|
|
title: 通知与提醒
|
|
description: 优先级、课堂确认与经典/自定义常驻模式的提醒区别。
|
|
---
|
|
|
|
# 通知与提醒
|
|
|
|
Web 发布通知需 notification:publish 和班级范围权限。通知按本地 assignDate 归档，支持按日期、发布人查看与批量发布。
|
|
服务端保存后立即广播；上课暂存与是否自动展开是客户端本机展示规则。
|
|
|
|
## 优先级与本机展示
|
|
|
|
共享优先级为 LOW（低）、NORMAL（普通）、HIGH（重要）、URGENT（紧急）。
|
|
经典固定模式和自定义常驻模式有不同展示：
|
|
|
|
| 场景 | 经典 fixed | 自定义 custom |
|
|
| ---------------------- | ------------------------------------------ | -------------------------------------- |
|
|
| 普通/重要/低通知、作业 | 课间显示胶囊；上课暂存，下课补弹 | 常驻内容旁提示铃铛与去重数量，点击查看 |
|
|
| 紧急通知/紧急叫人 | 无论是否上课立即展开 | 提示铃铛，由用户主动展开 |
|
|
| 普通叫人 | 上课保留可点击胶囊，不自动展开；课间可展开 | 提示铃铛，可主动查看 |
|
|
| 主动查看 | 普通通知受课堂状态限制，叫人和紧急可点开 | 上课也可主动展开 |
|
|
|
|
经典紧急通知默认约 45 秒收起；列表与消息处理见[灵动岛](island.md)。课件传输另显示专用进度。
|
|
|
|
## 课堂发布紧急通知
|
|
|
|
上课时发布 URGENT，服务端先返回 409 URGENT_DURING_CLASS。
|
|
Web 显示全屏确认和倒计时，再次请求带 confirmDuringClass:true 才放行。
|
|
这是服务端发布校验，不受客户端选择 fixed/custom 影响；普通叫人和紧急叫人走[叫人](calls.md)的接口规则。
|
|
|
|
## 已读与撤回
|
|
|
|
客户端通知页有未读数，打开详情可标已读；班级会话的已读操作代表全班在读学生。
|
|
删除需相应员工权限和范围，实时撤回会清理客户端列表、缓存与岛队列。
|
|
同 id 的通知与叫人双播合并，不重复计数。
|
|
|
|
## 接口入口
|
|
|
|
以下省略 /api，均先鉴权；具体功能键及范围见[REST API](../dev/api.md)。
|
|
|
|
| 方法与路径 | 用途 |
|
|
| ----------------------------------------------------- | --------------------------------------------------------------------- |
|
|
| GET /notifications | 列表；classId、priority、unreadOnly、keyword、date/from/to、createdBy |
|
|
| GET /notifications/days、/notifications/creators | 日期与发布人归档 |
|
|
| GET /notifications/unread-count | 未读数 |
|
|
| POST /notifications、/notifications/bulk | 单班/批量发布，批量逐班返回结果 |
|
|
| POST /notifications/:id/read、/notifications/read-all | 标记已读 |
|
|
| DELETE /notifications/:id | 撤回 |
|
|
|
|
ClassIsland 在线提醒渠道已移除；本机提醒设置不会写回旧渠道字段。
|