跳到主要内容

语音消息

用户可以通过 IMKit 内置的输入组件录制并发送语音消息。消息将出现在会话页面的消息列表组件中。SDK 默认生成和发送的消息包含高清语音消息内容对象 RCHQVoiceMessage(类型标识:RC:HQVcMsg)。

hqvoice-message(width=250) hqvoice-message-read(width=250)

局限性

语音输入功能目前存在以下限制:

  • IMKit 仅单聊会话和群聊会话支持发送语音消息。
  • 用户必须录制至少为 1 秒的音频内容,且必须短于 60 秒钟。
  • 用户在录制语音消息时无法暂停。
  • 正在视频通话和语音通话中不能进行语音消息发送。

用法

IMKit 默认在输入栏组件中启用语音消息输入功能。输入栏中默认带有切换语音输入按钮。

发送语音消息

为了发送语音消息,用户必须首先在输入栏中通过 RCVoiceRecorder 录制消息。默认情况下,语音消息图标显示在输入字段的左侧。点击此图标后,就会出现录制按钮(“按住说话”)。用户可以通过点击录制按钮来录制语音消息。长度必须至少为一秒且短于 60 秒钟。如果在点击停止按钮之前消息不到一秒,则不会保存该消息。录制过程中可以上滑取消录制或放弃取消。一旦松开按钮,SDK 默认发送到目前为止录制的内容。不支持在发送语音消息之前预览。在播放语音消息中的音频文件时不可暂停。

hqvoice-message(width=250)

消息列表中的语音消息

您可以在单聊会话、群聊会话、系统会话中接收语音消息。语音消息显示在消息列表中。

用户可以通过点击播放按钮查看和播放语音消息。未播放的语音消息旁边会显示一个红点,消息可多次播放。但是,用户只能在客户端应用程序中收听语音消息,并且无法将其保存到自己的设备中。您在频道中一次只能收听一条音频文件。如果您在收听消息时尝试播放另一条消息,则先播放的消息将暂停。

hqvoice-message(width=250) hqvoice-message(width=250)

IMKit 默认下载高清语音消息,并且默认点击播放后连续播放消息下方未收听的语音消息。您可以在会话页面显示前,通过 RCConversationViewControllerenableContinuousReadUnreadVoice 属性设置未听的语音消息不连续播放。

NO 表示禁止连续播放。

chatVC.enableContinuousReadUnreadVoice = NO;
[self.navigationController pushViewController:chatVC animated:YES];

定制化

语音消息的定制化涉及到输入栏的语音输入切换图标、音频录制界面、和高清语音消息展示 UI。

自定义语音消息的 UI

IMKit 默认生成和发送高清语音消息(RC:HQVoiceMsg),使用 RCHQVoiceMessageCell 模板展示在消息列表中。

IMKit 中所有消息模板都继承自 RCMessageCell,自定义消息 Cell 也需要继承 RCMessageCell。详见修改消息的展示样式

您也可以直接替换 RongCloud.bundle 中小视频消息展示模板中引用的样式资源、字符串资源和图标资源。详见 IMKit 源码 RCHQVoiceMessageCell.m 中引用的资源。

输入栏与录音弹窗样式资源

您也可以直接替换 RongCloud.bundle 中输入栏、录音弹窗相关样式资源。下表列出了部分图标。

图标图像描述
inputbar_voice(width=14)用作语音输入按钮的图标,用于在消息输入时切换至语音消息录制视图。inputbar_voice_dark 对应暗黑模式下的图标。
voice_unread(width=14)本端用户发送的高清语音消息未读状态。

更多图标资源,请参考 IMKit 源码中的 RCHQVoiceMessageCell.mRCVoiceCaptureControl.m 等。

处理录音相关事件

IMKit 在 RCConversationViewController 中提供了录音相关的事件:

  • (void)onBeginRecordEvent;:开始录制语音消息
  • (void)onEndRecordEvent;:结束录制语音消息
  • (void)onCancelRecordEvent;: 取消录制语音消息的回调,不会再触发 onEndRecordEvent

详见页面事件监听

隐藏切换语音输入按钮

您可以在会话页面 viewDidLoad 之后,设置,通过 RCConversationViewControllerchatSessionInputBarControl 属性改变输入工具栏的样式 RCChatSessionInputBarControlStyle,移除语音/文本切换按钮。

RCChatSessionInputBarControlStyle style = RC_CHAT_INPUT_BAR_STYLE_CONTAINER_EXTENTION;
[self.yourChatVC.chatSessionInputBarControl setInputBarType:RCChatSessionInputBarControlDefaultType style:style];