本文档主要介绍如何快速跑通 语聊房 示例工程
Demo 效果:
- 最低兼容 iOS 13.0及以上的手机设备。
- Xcode 13.0及以上版本。
-
安装依赖库
切换到 iOS 目录，运行以下命令使用CocoaPods安装依赖，AgoraSDK会在安装后自动完成集成。
使用cocoapods
pod install打开
AgoraEntScenarios.xcworkspace -
获取声网App ID 和 App 证书
声网Agora - 文档中心 - 如何获取 App ID
声网Agora - 文档中心 - 获取 App 证书-
点击创建应用
-
选择你要创建的应用类型
-
得到App ID与App 证书
-
在项目的功能配置中启用"实时消息 RTM"功能, 同时启用下列子模块
- 状态同步（Storage） 配置
- 分布式锁（Lock ）配置
注: 如果没有启动"实时消息 RTM"功能, 将无法体验项目完整功能
-
-
获取环信的App Key 环信
-
创建应用
-
查看应用的App Key
-
-
在项目的KeyCenter.swift里填写需要的声网 App ID 和 App证书
static let AppId: String = 声网AppID
static let Certificate: String? = 声网App证书
普通语聊房需要配置IM Key
static var IMAppKey: String? = 环信AppKey
static var IMClientId: String? = 环信ClientId
static var IMClientSecret: String? = 环信ClientSecret
声动语聊项目是声网语聊房场景的开源代码，开发者可以获取并添加到您的APP工程里，本源码会伴随声动语聊Demo同步更新，为了获取更多新的功能和更佳的音效，强烈推荐您下载最新代码集成。
iOS/AgoraEntScenarios/Scenes/VoiceChatRoom
- 房间管理及语聊房内的交互请求和响应，如麦位变化、消息变化、礼物收发、定向消息转发、成员变化等，通过ChatRoomServiceProtocol来定义协议，通过ChatRoomServiceImp来实现，您可以通过自己实现的ServiceImp来一键替换，无需改动业务代码。
- 功能代码路径：RoomService
- 麦位管理相关功能主要依托于组件MicPosView，拖拽到项目中即可使用
- AgoraChatRoomNormalRtcView：基础麦位组件，支持麦位的上下麦，换麦，静音/解除静音，锁麦/解锁，麦位的单个刷新，音量更新等麦位功能。
- 麦位相关操作逻辑请参考VoiceRoomViewController+Mic.swift文件
- IM相关的弹幕以及回调VoiceRoomViewController+IM.swift文件
- IM相关的打赏 VoiceRoomViewController+ChatBar.swift
- 当前版本使用的环信IM，用户可以自主选择集成的IM
- 音效方法参考：VoiceRoomViewController+ChatBar.swift文件的 func showEQView()
- 该方法支持对音效功能的统一处理
声网声动语聊源码，最终目的是方便开发者快速按需集成，减少开发者搭建语聊房的工作量。在现有源码的基础上，您可以按需自由定制，包括UI/UE，前端逻辑，权限体系等
- 声网APPID申请：https://www.agora.io/cn/
- 环信APPKey申请：https://www.easemob.com/
声动语聊源码使用的是环信AgoraChat的IM和信令服务，您也可以使用自己的服务
详情请查看 声动互娱
-
方案1：如果您已经在使用声网服务或者在对接中，可以直接联系对接的销售或服务
-
方案2：发送邮件给 [email protected] 咨询
-
方案3：扫码加入我们的微信交流群提问
