跳到主要内容

小视频消息

用户可以通过 IMKit 图库（本地相册）或小视频插件发送小视频消息。消息将出现在会话页面的消息列表组件中。插件默认发送的消息包含小视频消息内容对象 SightMessage（类型标识：RC:SightMsg）。

局限性​

小视频功能目前存在以下限制：

  • IMKit 仅单聊会话和群聊会话支持发送小视频消息。
  • 如果使用小视频插件进行录制，支持录制长度不超过 10 秒的小视频。
  • 如果从本地相册中选择视频文件，请注意服务端的默认视频时长上限为 2 分钟。如需调整上限，请联系商务。
  • 仅支持 H.264 + AAC 编码的视频文件，因为 IMKit 的短视频录制、播放只实现了该编码组合的支持。注意：mp4 格式的视频可以播放并保存到相册，avi/rmvb 格式的视频可以播放，但是无法保存到相册。
  • 如果 App Key 使用 IM 旗舰版或 IM 尊享版，文件存储时长默认为 180 天（不含小视频文件，小视频文件存储 7 天）。注意，IM 商用版（已下线）默认存储 7 天。如需了解IM 旗舰版或 IM 尊享版的具体功能与费用，请参见融云官方价格说明页面及计费说明。

用法​

建议通过集成 IMKit 小视频插件使用小视频消息功能。

从本地相册选择小视频​

用户点击输入栏右侧 + 号按钮可展开扩展面板，点击相册图标，打开本地相册时，默认包含视频文件，用户可以选择视频文件进行发送。

本地相册使用鸿蒙内置本地相册模块：https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V13/js-apis-photoaccesshelper-V13

录制小视频消息​

用户点击输入栏右侧 + 号按钮可展开扩展面板，点击小视频图标，即可录制小视频并发送小视频消息。

小视频的录制使用了鸿蒙内置模块：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/camera-picker-V5

extension(width=250)

定制化​

调整小视频压缩质量​

小视频文件默认不会压缩。 小视频首帧画面会被用于生成缩略图，在聊天界面中展示。SDK 默认以原图 80% 质量生成符合标准大小要求的缩略图后再上传和发送，缩略图最长边不超过 240 px。

自定义小视频消息的 UI​

小视频消息使用 SightMessageItemProvider 模板展示在消息列表中。 如果需要调整内置消息样式，需继承 BaseMessageItemProvider<SightMessage> 自行实现消息展示模板类，详见自定义Provider。

调用下面的接口将该自定义模板提供给 SDK，objectName 传 SightMessageObjectName。

TypeScript
import { SightMessageObjectName, RongIM } from "@rongcloud/imkit";

// 注册自定义文件消息 provider 给 IMKit
RongIM.getInstance().conversationService().addMessageItemProvider(SightMessageObjectName, new CustomSightMessageItemProvider())

隐藏小视频插件的录制视频功能​

IMKit 目前暂不支持隐藏。

隐藏相册插件中的视频文件​

IMKit 目前暂不支持隐藏。

最后于 更新