客户端实现

本文介绍如何通过环信 IM SDK 和 Agora Audio SDK 在你的 iOS 项目里实现语聊房的主要功能。

语聊房 SDK 内部依赖环信 IM 聊天室（Chatroom）与 Agora Audio 的音频房间（RTC Channel）。

语聊房内用户角色说明如下：

以下为房间管理流程图。

房间管理流程如下：

1. 用户利用手机号和验证码登录环信 IM。
2. 房主可创建语聊房，普通用户加入语聊房。
3. 加入环信 IM 和 RTC 频道。
4. 进入语聊房，检查是否成功加入环信 IM 和 RTC 频道。
   • 若成功加入，房主可以发送本地音频流和消息，观众可以发消息。
   • 若未成功加入，退出房间，返回房间列表页面。
5. 退出房间。

房间相关操作如下表所示：

以下为麦位管理流程图：

麦位相关操作如下所示：

邀请用户上麦的流程如下：

1. 房主调用 RESTFul API 邀请用户上麦。
2. App Server 收到邀请消息后，利用房主角色向用户发送该消息。
3. 用户同意邀请后调用 RESTful API 上麦。
4. App Server 设置聊天室属性通知房间全员刷新房间设置。

用户申请上麦的流程如下：

1. 用户调用 RESTful 接口申请上麦。
2. App Server 收到上麦申请消息后以用户角色向房主发送该消息。
3. 房主收到上麦申请后调用 RESTful API 同意上麦。
4. App Server 设置聊天室属性通知房间全员刷新房间设置。

发送礼物消息的流程如下：

1. 用户 A 发送礼物详情到 App Server。
2. App Server 统计礼物信息后对用户 A 返回响应。
3. SDK 将礼物消息发送到语聊房。

• Xcode 13.0 或以上版本。
• CocoaPods。你可以参考 CocoaPods 安装指南 。
• iOS 13.0 或以上版本的设备。部分模拟机可能无法支持本项目的全部功能，所以推荐使用真机。
• 有效的环信 IM 开发者账号和 App key，详见环信即时通讯云控制台。
• 有效的 Agora 项目，获取项目的 App ID 以及一个 RTC Token，实现语音通话。
• 如果你的网络环境部署了防火墙，请联系环信技术支持设置白名单。

本节提供环信 IM SDK 和 Agora Audio SDK 的基本 API 参考。

• App Server API 文档。该文档为静态 HTML 页面，需下载后查看。
• Demo 中的方法与 App Server API 之间的映射。

麦位相关方法，详见 VoiceRoomViewController+Mic 文件。

加入语聊房前，进行环信 IM SDK 初始化和 Agora Audio 初始化设置。

通过 App Server 加入或离开语聊房的方法的示例代码如下：

// 加入语聊房
    func uploadStatus( status: Bool) {
        guard let roomId = self.roomInfo?.room?.room_id  else { return }
        VoiceRoomBusinessRequest.shared.sendPOSTRequest(api: .joinRoom(roomId: roomId), params: [:]) { dic, error in
            if let result = dic?["result"] as? Bool,error == nil,result {
                self.view.makeToast("Joined successful!".localized(),point: self.toastPoint, title: nil, image: nil, completion: nil)
            } else {
                self.didHeaderAction(with: .back,destroyed: false)
            }
        }
    }
// 离开语聊房
    @objc private func leaveRoom() {
        if let room_id = roomInfo?.room?.room_id {
            VoiceRoomBusinessRequest.shared.sendDELETERequest(api: .leaveRoom(roomId: room_id), params: [:]) { map, err in
                print(map?["result"] as? Bool ?? false)
            }
        }
    }

• 环信 IM 相关回调以及处理的方法，详见 VoiceRoomViewController+IM 文件。
• 送礼物相关方法及其底部时间回调，详见 VoiceRoomViewController+ChatBar 文件。

主播调用以下方法设置音频流：

调用 setAudioEffectPreset 方法，在不改变原声的性别特征的前提下，设置人声音效。设置音效后，频道内所有用户都能听到该效果。

rtcKit.setChannelProfile(.liveBroadcasting)
    rtcKit.setAudioProfile(.musicHighQuality)
    rtcKit.setAudioScenario(.gameStreaming)

AI 降噪插件使用声网人工智能噪声消除算法，能够让远程交流和面对面交谈一样实时。

可以开启或关闭 AI 降噪以及设置中级降噪和高级降噪。示例代码如下：

public func setAINS(with level: AINS_STATE) {
        switch level {
        case .high:
        rtcKit.setParameters("{\"che.audio.ains_mode\":2}")
        rtcKit.setParameters("{\"che.audio.nsng.lowerBound\":10}")
        rtcKit.setParameters("{\"che.audio.nsng.lowerMask\":10}")
        rtcKit.setParameters("{\"che.audio.nsng.statisticalbound\":0}")
        rtcKit.setParameters("{\"che.audio.nsng.finallowermask\":8}")
        rtcKit.setParameters("{\"che.audio.nsng.enhfactorstastical\":200}")
        case .mid:
        rtcKit.setParameters("{\"che.audio.ains_mode\":2}")
        rtcKit.setParameters("{\"che.audio.nsng.lowerBound\":80}")
        rtcKit.setParameters("{\"che.audio.nsng.lowerMask\":50}")
        rtcKit.setParameters("{\"che.audio.nsng.statisticalbound\":5}")
        rtcKit.setParameters("{\"che.audio.nsng.finallowermask\":30}")
        rtcKit.setParameters("{\"che.audio.nsng.enhfactorstastical\":200}")
        case .off:
        rtcKit.setParameters("{\"che.audio.ains_mode\":0}")
        rtcKit.setParameters("{\"che.audio.nsng.lowerBound\":80}")
        rtcKit.setParameters("{\"che.audio.nsng.lowerMask\":50}")
        rtcKit.setParameters("{\"che.audio.nsng.statisticalbound\":5}")
        rtcKit.setParameters("{\"che.audio.nsng.finallowermask\":30}")
        rtcKit.setParameters("{\"che.audio.nsng.enhfactorstastical\":200}")
    }
}