mdm-im-v3 2.0.3 → 2.1.0

package/CHANGELOG.md

@@ -82,3 +82,11 @@
 - 发布mdm-im-v3@2.0.3版本
 1. PC端页面主题背景图未加载问题修复；
 2. PC端人员选择弹框、消息转发弹框样式优化。
+
+## V2.1.0 2026-10-30
+- 发布mdm-im-v3@2.1.0版本
+1. 修复从外部指定会话人员时，未定位到对应用户会话的问题；
+2. 修复切换会话时空会话展示上一个会话的消息问题；
+3. 组件增加传参 targetUserInfo，用于指定指定的用户会话，内容形式：{ userID: 'xxx', userName: '张三' }；
+4.  新增「阅后即焚」功能（单聊）：会话设置抽屉/聊天设置页可开关并设置销毁时长（1–86400 秒，默认 30 秒，PC 提供预设 + 自定义）；
+5. 新增「语音消息」发送能力：H5 支持"按住说话"（上滑取消、最短 1 秒、最长 60 秒、最后 10 秒倒计时、切后台自动取消），PC 支持麦克风录音弹窗（点击开始 / 停止并发送）。

package/README.md

@@ -45,6 +45,8 @@ node_modules/mdm-im-v3/
 | `mdm-im-v3/style/index-h5.css` | `dist-h5/style/index-h5.css` | CSS | H5 端样式文件 |
 
 > **核心原则：** `mdm-im-v3/core` 在两端通用，PC 端额外导入 `mdm-im-v3`（组件）和 `mdm-im-v3/style/index.css`（样式），H5 端额外导入 `mdm-im-v3/h5`（组件）和 `mdm-im-v3/style/index-h5.css`（样式）。
+>
+> **图标字体已内置：** 两个样式文件都包含 `@font-face` 与全部 `.mdm-icon-*` 类（字体文件随包输出到 `dist/assets/extracted/`、`dist-h5/assets/extracted/`），消费方**无需**再单独引入 `iconfont.css`，也不依赖宿主是否已有同名图标字体。
 
 ## 安装
 
@@ -485,6 +487,7 @@ const { initIMSDK, clearInstance, getUnReadMessageCount, setConversationMsgAsRea
 | `initIMSDK()` | 初始化 SDK → 绑定所有 OpenIM 事件 → 登录。需先在 store 中设置 userID、imToken、apiUrl 等。返回 `Promise<void>`。 |
 | `clearInstance(bool)` | 解绑事件 → 登出 → 清除 SDK 实例。传入 `true` 时同时清空会话列表和 `window.imInstance`。 |
 | `getUnReadMessageCount(fromServer?)` | 获取未读消息总数。`fromServer=true` 从服务端获取，默认从本地会话列表累计。 |
+| `waitForSyncFinish(timeout?)` | 等待登录后的服务端同步（`OnSyncServerFinish`）完成，返回 `Promise<boolean>`。同步完成前 SDK 本地会话缓存为空，此时拉取会话列表只会得到空数组，因此拉取会话列表前应先等待该方法；默认超时 8000ms，超时返回 `false`，按兜底流程继续。 |
 | `setConversationMsgAsRead(conversationID?)` | 将指定会话的消息标记为已读，不传则使用当前会话。窗口失焦时自动跳过。 |
 | `mittBus` | 全局事件总线实例，用于监听 IM 自定义事件（见下方事件列表） |
 
@@ -546,6 +549,7 @@ const chatStore = useChatStore()
 | `rejectSLRemote` | 远程桌面被拒绝 |
 | `LOGOUT_NOTICE` | 账号在其他设备登录，被强制下线 |
 | `IM_LOGOUT` | IM 已登出 |
+| `IM_SYNC_SERVER_FINISH` | 登录后的服务端同步结束（参数 `true`-成功，`false`-失败）。此时会话/消息缓存才就绪，可用于登录后补拉会话列表 |
 | `OnGroupInfoChanged` | 群信息变更（名称、头像、公告等） |
 | `OnJoinedGroupAdded` | 被拉入新群 |
 | `OnJoinedGroupDeleted` | 退出或被踢出群 |
@@ -563,6 +567,71 @@ mittBus.on('LOGOUT_NOTICE', () => {
 })
 ```
 
+## 阅后即焚（Burn After Reading）
+
+单聊会话支持「阅后即焚」：**谁开启，谁发送的消息才会在被对方阅读后倒计时并销毁**；对方未开启时，其发送的消息不受影响。
+
+### 使用入口
+
+- **PC**：聊天窗口右上角「设置」抽屉 → 单聊会话 → 「阅后即焚」开关 + 「阅后即焚时间」；
+- **H5**：聊天设置页（`/chat-settings`）→ 单聊会话 → 「阅后即焚」开关 + 时间选择。
+
+群聊不提供该入口（OpenIM 的 `isPrivateChat` 语义按私密会话设计，本期仅支持单聊）。
+
+### 规则
+
+| 项 | 说明 |
+|---|---|
+| 按用户持久化 | 开关、时长、开启人、目标人写入**自己会话的 `ex.burn`**：`{ enabled, duration, fromUserID, toUserID, updatedAt }`；`ex` 由服务端按用户存储，换设备/清缓存后可恢复，且不会改动对方设置 |
+| ex 兼容 | 写入 `burn` 时自动 merge，保留 `isHidden` / `isDeleted` / `isRead` 等业务标记；这些业务写 ex 时也会用 `preserveBurnInEx()` 保留 `burn` |
+| 会话标识 | 开启后自己的会话列表对应会话显示 🔥（按 `ex.burn.fromUserID === 当前用户` 判断，对方列表不会显示） |
+| 消息快照 | 开启方发送消息时在消息 `ex` 写入 `{ burnBySender, burnDuration, burnFromUserID, burnToUserID }`；未开启方发送的消息不带该标记，因此不会被焚毁 |
+| 时长范围 | 1–86400 秒，默认 30 秒；PC 提供预设（10s/30s/1min/5min/30min/1h）+ 自定义 |
+| 提交方式 | 开关、时长与 `ex.burn` 一次性提交 `setConversation()`，避免"开关开了但时长为 0、消息不销毁" |
+| 关闭 | 删除 `ex.burn`，后续发送的消息不再带焚毁快照；已进入倒计时的消息按原快照走完 |
+| 展示 | 带焚毁快照的消息在消息列表显示 🔥 与剩余秒数（通知类消息不展示、不参与焚毁） |
+| 通知文案 | 1701 通知带上操作人：`张三 开启了阅后即焚` / `张三 关闭了阅后即焚`（自己操作显示"你"） |
+| 销毁触发 | 接收方打开会话、未读转已读后开始倒计时；发送方在收到已读回执后开始 |
+| 销毁执行 | 倒计时结束：消息列表移除 + IndexedDB 缓存回写 + `deleteMessage` 删除；已切换走的会话也会在后台到点删除 |
+
+### 服务端能力与限制
+
+- 设置依赖服务端对会话 `ex` 的持久化（本项目已用于隐藏/标记未读，属于既有能力）；
+- 阅后即焚的「到期真删」属于 OpenIM 服务端能力，落地前需确认当前部署版本支持；即使服务端不支持，组件仍会按本地倒计时把消息从界面与缓存中移除（弱一致）；
+- 服务端会话上的 `isPrivateChat` / `burnDuration` 仍会随设置同步（用于 1701 通知与 SDK 私密快照），但组件不再据此决定是否焚毁。
+
+> 相关字段：会话 `ex.burn`（设置，按用户）；消息 `ex.burnBySender` / `burnDuration` / `burnFromUserID` / `burnToUserID`（发送方快照，组件焚毁依据）；`attachedInfoElem` 仅作兼容展示。
+
+## 语音消息（Voice Message）
+
+支持在 PC / H5 端录制并发送 OpenIM 语音消息（`contentType = 103`，`soundElem`），消息列表复用已有语音气泡（时长 + 声波 + 播放）。
+
+### 使用入口
+
+- **H5**：输入区左侧「语音/键盘」切换按钮 → 按住「按住 说话」开始录音，松开发送；上滑超过 80px 松开取消；
+- **PC**：编辑器工具栏麦克风图标 → 录音弹窗 → 点击麦克风开始，点击「停止并发送」结束并发送；
+- 另：PC 选择/拖拽音频文件、H5 选择音频文件，都会按语音消息发送（不再显示成文件卡片）。
+
+### 录音与发送规格
+
+| 项 | 说明 |
+|---|---|
+| 录音格式 | WAV（PCM），16kHz / 16bit / 单声道，全平台可播放 |
+| 时长 | 最短 1 秒（太短提示"录音时间太短"），最长 60 秒（最后 10 秒倒计时，到点自动发送） |
+| 发送链路 | 先上传业务文件服务（`/api/v1/common/uploadFiles`）→ `createSoundMessageByURL` → 乐观插入 → `sendMessageNotOss` |
+| 时长取值 | 优先读音频元数据（`getMediaDuration`），其次录音器计时，最后按实际耗时兜底；存储为整秒且 ≥1 |
+| 失败处理 | 上传失败不产生消息；发送失败气泡标记 `status=3`（红色感叹号） |
+| 播放 | 复用 `useAudioPlayer`，录音开始会暂停正在播放的语音，避免外放混入 |
+| 后台切换 | 录音中切到后台/隐藏页面自动取消，避免后台持续录音 |
+
+### 依赖与权限
+
+- 录音依赖 `js-audio-recorder`（已加入 `dependencies`），产物为 WAV，iOS / 微信浏览器 / Electron 均可播放；
+- 浏览器录音要求 **HTTPS 或 localhost**，首次使用需授权麦克风；拒绝授权、无麦克风、浏览器不支持时均有 Toast 提示；
+- PC Electron 需在系统层允许麦克风权限。
+
+> 相关字段：`soundElem.duration`（秒，必填）、`sourceUrl` / `soundPath`（播放地址，组件会补 `baseUrl` 并把 `/api/v1/common/reviewFile/` 重写为 `/api/v1/auth/reviewFile/`）、`dataSize`、`soundType`（如 `wav`）。
+
 ## 主题
 
 支持深色（`dark`）和浅色（`light`）两套主题，通过 CSS 变量驱动：

package/dist/{FilePreview-CqsQCI87.js → FilePreview-dpnc9m3Z.js}

@@ -1,8 +1,8 @@
 import { reactive, computed, ref, watch, nextTick, resolveComponent, openBlock, createElementBlock, Fragment, createVNode, withCtx, unref, createElementVNode, withModifiers, toDisplayString, createCommentVNode, normalizeStyle, createBlock, resolveDynamicComponent } from "vue";
 import { DocumentDelete, ZoomOut, ZoomIn } from "@element-plus/icons-vue";
-import { u as useChatStore } from "./index-D8yaC3ve.js";
+import { u as useChatStore } from "./index-D5S79LNp.js";
 import axios from "axios";
-import { _ as _export_sfc } from "./index-B3MeQmIL.js";
+import { _ as _export_sfc } from "./index-CNxeqkio.js";
 const _hoisted_1 = { class: "file-preview-box" };
 const _hoisted_2 = {
   key: 0,

package/dist/core.es.js

@@ -1,6 +1,6 @@
 import "vue";
-import { u, B } from "./index-D8yaC3ve.js";
+import { u, Q } from "./index-D5S79LNp.js";
 export {
   u as useChatStore,
-  B as useMessage
+  Q as useMessage
 };