iOS - 融云RTC功能梳理

2023-12-22 18:38
文章标签 功能 ios rtc 梳理 融云

本文主要是介绍iOS - 融云RTC功能梳理,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

一. 功能介绍

功能需求

  1. 一个文字聊天室(如图下半部分)
  2. 一个语音聊天室(语音房)(上半部分)
  3. 五个麦位
  4. 可上麦下麦

二. 业务梳理

融云流程图

  1. 业务层面的语音聊天室  在用户创建聊天室时请求业务(自己)服务器,业务服务器创建聊天室,并返回给创者者当前聊天室的 id,同时其他用户可通过获取聊天室列表接口获取到此聊天室的 id。用户调根据此聊天室 id 加入 IM 聊天室音频 RTC房间。当前用户属于哪个聊天室,当前聊天室内有哪些用户是基于此聊天室。
    备注: 在创建一个房间时, 后台依次会调用融云server API 创建一个语音通话, 文字聊天都包含的一个房间(ROOM).

  2. IM 即时通讯层面的语音聊天室  加入 IM 聊天室后,用户可以发送文本消息聊天。另外维护聊天室各种状态的信令消息也通过 IM 服务来收发。(理论上 文字聊天(IM), 语音房(RTC) 使用一个目标Id即可)

3, RTC 音频层面的语音聊天室   加入 RTC 聊天室后,用户可以获得到当前语音聊天室内所有发布音频流的用户,并选择订阅音频流来收听目标用户的声音,也可以自己发布音频流让其他人听到自己的声音。

三. 前端(App端) 梳理

屏幕快照 2019-10-26 下午5.00.05.png

  • A 可见 B、C、D 的音频、视频

  • B 可按需选择只听 A、D 的音频,只看 A、C 的视频

  • C 可按需选择只听 A、B、D 的音频,但不看其他人视频

  • D 可按需选择只看 A、B、C 的视频,但不听其他人的音频

四. iOS 端伪代码, 以下全是伪代码

  1. RTC(语音视频室基于IM)所以第一步 需要连接IM
[[KKIMMgr shareInstance] checkAndConnectRCSuccess:^{/// 连接成功, 再去创建一个上述功能的房间} error:^(RCConnectErrorCode status) {[CC_Notice show:@"聊天室未连接"];}];
  1. 创建房间成功后呢, 后台会返回一个目标Id, 或者叫做房间Id (roomId), 通过这个Id去连接 RTC Room
///  KKRtcService 是对融云RTC "<RongRTCLib/RongRTCLib.h>"进行了一层封装
[[KKRtcService shareInstance] joinRoom:channelId success:^(RongRTCRoom * _Nonnull room) {dispatch_async(dispatch_get_main_queue(), ^{/// 证明连接成功RTC///  跳转进入房间});});} error:^(RongRTCCode code) {dispatch_main_async_safe(^{[CC_Notice show:@"进入房间失败!"];});}];          
  1. 做一个上麦, 下麦的管理

没有伪代码

  1. 对于再麦位上的用户, 扩散动画处理, 也是一段伪代码.
- (void)didReportStatForm:(RongRTCStatisticalForm *)form {//1.发送for(RongRTCStreamStat *streamStat in form.sendStats){//只处理音频//处理发送的音频 动画if ([streamStat.mediaType isEqualToString:RongRTCMediaTypeAudio]) {[self updateMicPositionSpeaking:streamStat.trackId audioLevel:streamStat.audioLevel];}}//2.接收for(RongRTCStreamStat *streamStat in form.recvStats){//只处理音频//处理接收的音频 动画if ([streamStat.mediaType isEqualToString:RongRTCMediaTypeAudio]) {[self updateMicPositionSpeaking:streamStat.trackId audioLevel:streamStat.audioLevel];}}
}- (void)updateMicPositionSpeaking:(NSString *)userId audioLevel:(NSInteger)audioLevel {dispatch_async(dispatch_get_main_queue(), ^{/// 这里是处理了 CollectionViewCell里面的动画逻辑/// 关键在与userId的判断和audioLevel音量的双重条件, 来控制动画for (KKPlayerCardCollectionCell *cell in self.playerListView.visibleCells) {if (cell.dataModel.userId.length > 0 && [userId containsString:cell.dataModel.userId]) {CCLOG(@"cell.dataModel.userId === %@", cell.dataModel.userId);if (self.isMicOpen == YES) {cell.isSpeaking = audioLevel > 0;}else {if ([userId containsString:[KKUserInfoMgr shareInstance].userId]) {cell.isSpeaking = NO;}}}}});
}
  1. 解释

5.1 简单理解上麦需要发布音频流
5.2 下麦取消发布音频流
5.3 想听到谁的声音/视频 你就去订阅谁
5.4 不想听谁的声音关闭扬声器就好了

五. RTCServiceMgr 以下代码通用

@interface RTCServiceMgr : NSObject#pragma mark - life circle
+ (instancetype)shareInstance;
- (void)remove;#pragma mark - rtc
/** 当前加入的 rtc房间 (当加入房间成功之后,才会是有效值 */
@property (nonatomic, strong, readonly) RongRTCRoom *rtcRoom;/** 关闭所有声音 */
@property (nonatomic, assign) BOOL muteAllVoice;/** 设置 直播间代理 */
- (void)setRTCRoomDelegate:(id<RongRTCRoomDelegate>)delegate;/** 设置 直播间引擎代理 */
- (void)setRTCEngineDelegate:(id<RongRTCActivityMonitorDelegate>)delegate;#pragma mark 加入/退出
/** 加入直播间 */
- (void)joinRoom:(NSString *)roomId success:(void (^)( RongRTCRoom *room))success error:(void (^)(RongRTCCode code))error;/** 退出直播间 */
- (void)leaveRoom:(NSString*)roomId success:(void (^)(void))success error:(void (^)(RongRTCCode code))error;#pragma mark  音频流
/** 发布 音视频流 */
- (void)pulishCurrentUserAudioStream;/** 取消发布 音视频流 */
- (void)unpublishCurrentUserAudioStream;/** 订阅 远端音频stream */
- (void)subscribeRemoteUserAudioStream:(NSString *)userId;/** 取消订阅 远端音频stream */
- (void)unsubscribeRemoteUserAudioStream:(NSString *)userId;#pragma mark 麦克风/扬声器
/** 设置麦克风 是否可用 */
- (void)setMicrophoneDisable:(BOOL)disable;/** 设置扬声器 是否可用 */
- (void)useSpeaker:(BOOL)useSpeaker;@end
@interface RTCServiceMgr () 
@property (nonatomic, strong) RongRTCRoom *rtcRoom;
@property (nonatomic, strong) RongRTCVideoCaptureParam *captureParam;
@property (nonatomic, strong) RongRTCAVCapturer *capturer;
@end@implementation RTCServiceMgrstatic RTCServiceMgr *rongRtcMgr = nil;
static dispatch_once_t onceToken;#pragma mark - getter/setter
#pragma mark getter
- (RongRTCAVCapturer *)capturer {if(!_capturer) {_capturer = [RongRTCAVCapturer sharedInstance];}return _capturer;
}
- (RongRTCVideoCaptureParam *)captureParam {if(!_captureParam) {_captureParam = [[RongRTCVideoCaptureParam alloc] init];_captureParam.turnOnCamera = NO;}return _captureParam;}#pragma mark setter
- (void)setMuteAllVoice:(BOOL)mute {_muteAllVoice = mute;for(RongRTCRemoteUser *remoteUser in self.rtcRoom.remoteUsers) {for(RongRTCAVInputStream *stream in remoteUser.remoteAVStreams) {if(stream.streamType == RTCMediaTypeAudio) {stream.disable = mute;}}}
}#pragma mark - life circle
+ (instancetype)shareInstance {dispatch_once(&onceToken, ^{rongRtcMgr = [[KKRtcService alloc] init];});return rongRtcMgr;
}- (instancetype)init {self = [super init];if (self) {}return self;
}/** 清空 */
- (void)remove{//1.删除userDefault中的用户信息//2.释放selfrongRtcMgr = nil;onceToken = 0;
}#pragma mark - rtc
- (void)setRTCRoomDelegate:(id<RongRTCRoomDelegate>)delegate {if(!self.rtcRoom) {//[CC_Notice show:@"尚未加入招募厅,无法设置代理"];return;}self.rtcRoom.delegate = delegate;
}-(void)setRTCEngineDelegate:(id<RongRTCActivityMonitorDelegate>)delegate {[RongRTCEngine sharedEngine].monitorDelegate = delegate;
}#pragma mark 加入/退出 rtc 房间
- (void)joinRoom:(NSString *)roomId success:(void (^)( RongRTCRoom  * _Nullable room))success error:(void (^)(RongRTCCode code))error {[[RongRTCEngine sharedEngine] joinRoom:roomId completion:^(RongRTCRoom * _Nullable room, RongRTCCode code) {dispatch_async(dispatch_get_main_queue(), ^{if(RongRTCCodeSuccess == code) {self.rtcRoom = room;if(success) {success(room);}}else if(RongRTCCodeJoinRepeatedRoom == code || RongRTCCodeJoinToSameRoom == code) {//当 RTC 出现此类错误时,RTC 不会再下发 room 对象,只能用上次的 roomif(success) {success(self.rtcRoom);}}else {if(error) {error(code);}}});}];
}- (void)leaveRoom:(NSString*)roomId success:(void (^)(void))success error:(void (^)(RongRTCCode code))error {[[RongRTCEngine sharedEngine] leaveRoom:roomId completion:^(BOOL isSuccess, RongRTCCode code) {dispatch_async(dispatch_get_main_queue(), ^{BBLOG(@"离开 RTCRoom ,code = %ld",(long)code);//成功 或 不再房间中 或 没有匹配的RTC roomif(isSuccess || RongRTCCodeSuccess == code ||RongRTCCodeNotInRoom == code ||RongRTCCodeNoMatchedRoom == code) {self.rtcRoom = nil;if(success) {success();}}else {if(error) {error(code);}}});}];
}#pragma mark 音频流
/** 发布 音视频流 */
- (void)pulishCurrentUserAudioStream {if(!self.rtcRoom) {//房间没生成return;}//1.采集self.captureParam.turnOnCamera = NO;[self.capturer setCaptureParam:self.captureParam];[self.capturer startCapture];//2.发布[self.rtcRoom publishDefaultAVStream:^(BOOL isSuccess, RongRTCCode desc) {BBLOG(@"当前用户发布音频流 %@",@(desc));}];
}/** 取消发布 音视频流 */
- (void)unpublishCurrentUserAudioStream {if(!self.rtcRoom) {//房间没生成return;}//1.关闭采集[self.capturer stopCapture];//2.取消发布[self.rtcRoom unpublishDefaultAVStream:^(BOOL isSuccess, RongRTCCode desc) {BBLOG(@"当前用户取消发送音视频流 %@",@(desc));}];}/** 订阅 远端音频stream */
- (void)subscribeRemoteUserAudioStream:(NSString *)userId {if(!self.rtcRoom) {//房间没生成return;}if(userId.length < 1){return;}RongRTCRemoteUser *remoteUser = [self getRTCRemoteUser:userId];if(remoteUser.remoteAVStreams.count <= 0) {[CC_Notice show:@"远端资源不存在,不能订阅音频"];//BBLOG(@"subscribe --- user:%@ streams:%@",remoteUser.userId,remoteUser.remoteAVStreams);return;}[self.rtcRoom subscribeAVStream:remoteUser.remoteAVStreams tinyStreams:nil completion:^(BOOL isSuccess, RongRTCCode desc) {BOOL mute = [KKRtcService shareInstance].muteAllVoice;for(RongRTCAVInputStream *stream in remoteUser.remoteAVStreams) {if(stream.streamType == RTCMediaTypeAudio) {stream.disable = mute;}}BBLOG(@"subscribe --- 订阅流 %@ success:%@ code:%@",remoteUser.userId,@(isSuccess),@(desc));}];
}/** 取消订阅 远端音频stream */
- (void)unsubscribeRemoteUserAudioStream:(NSString *)userId {if(!self.rtcRoom) {//房间没生成return;}RongRTCRemoteUser *remoteUser = [self getRTCRemoteUser:userId];if(remoteUser.remoteAVStreams.count <= 0) {//[CC_Notice show:@"远端资源不存在,不能取消订阅音频"];BBLOG(@"unsubscribe --- user:%@ streams:%@",remoteUser.userId,remoteUser.remoteAVStreams);return;}[self.rtcRoom unsubscribeAVStream:remoteUser.remoteAVStreams completion:^(BOOL isSuccess, RongRTCCode desc) {BBLOG(@"取消订阅流 %@ success:%@ code:%@",remoteUser.userId,@(isSuccess),@(desc));}];
}#pragma mark - tool
#pragma mark capturer
- (void)setMicrophoneDisable:(BOOL)disable {[self.capturer setMicrophoneDisable:disable];
}- (void)useSpeaker:(BOOL)useSpeaker {[self.capturer useSpeaker:useSpeaker];
}#pragma mark RemoteUser
/** 获取 rtcRemoteUser */
- (RongRTCRemoteUser *)getRTCRemoteUser:(NSString *)userId{for (RongRTCRemoteUser *user in self.rtcRoom.remoteUsers) {if ([userId isEqualToString:user.userId]) {return user;}}return nil;
}

六 总结

  1. 创建房间(具备RTC功能的房间) 重要!
  2. 加入房间
  3. 麦位管理
  4. 动画处理
  5. 麦克风和扬声器的管理


文/夏天然后

这篇关于iOS - 融云RTC功能梳理的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/525036

相关文章

Android使用ImageView.ScaleType实现图片的缩放与裁剪功能

《Android使用ImageView.ScaleType实现图片的缩放与裁剪功能》ImageView是最常用的控件之一,它用于展示各种类型的图片,为了能够根据需求调整图片的显示效果,Android提... 目录什么是 ImageView.ScaleType?FIT_XYFIT_STARTFIT_CENTE

Python的time模块一些常用功能(各种与时间相关的函数)

《Python的time模块一些常用功能(各种与时间相关的函数)》Python的time模块提供了各种与时间相关的函数,包括获取当前时间、处理时间间隔、执行时间测量等,:本文主要介绍Python的... 目录1. 获取当前时间2. 时间格式化3. 延时执行4. 时间戳运算5. 计算代码执行时间6. 转换为指

Android实现两台手机屏幕共享和远程控制功能

《Android实现两台手机屏幕共享和远程控制功能》在远程协助、在线教学、技术支持等多种场景下,实时获得另一部移动设备的屏幕画面,并对其进行操作,具有极高的应用价值,本项目旨在实现两台Android手... 目录一、项目概述二、相关知识2.1 MediaProjection API2.2 Socket 网络

Redis消息队列实现异步秒杀功能

《Redis消息队列实现异步秒杀功能》在高并发场景下,为了提高秒杀业务的性能,可将部分工作交给Redis处理,并通过异步方式执行,Redis提供了多种数据结构来实现消息队列,总结三种,本文详细介绍Re... 目录1 Redis消息队列1.1 List 结构1.2 Pub/Sub 模式1.3 Stream 结

MySQL索引的优化之LIKE模糊查询功能实现

《MySQL索引的优化之LIKE模糊查询功能实现》:本文主要介绍MySQL索引的优化之LIKE模糊查询功能实现,本文通过示例代码给大家介绍的非常详细,感兴趣的朋友一起看看吧... 目录一、前缀匹配优化二、后缀匹配优化三、中间匹配优化四、覆盖索引优化五、减少查询范围六、避免通配符开头七、使用外部搜索引擎八、分

Android实现悬浮按钮功能

《Android实现悬浮按钮功能》在很多场景中,我们希望在应用或系统任意界面上都能看到一个小的“悬浮按钮”(FloatingButton),用来快速启动工具、展示未读信息或快捷操作,所以本文给大家介绍... 目录一、项目概述二、相关技术知识三、实现思路四、整合代码4.1 Java 代码(MainActivi

SpringBoot集成Milvus实现数据增删改查功能

《SpringBoot集成Milvus实现数据增删改查功能》milvus支持的语言比较多,支持python,Java,Go,node等开发语言,本文主要介绍如何使用Java语言,采用springboo... 目录1、Milvus基本概念2、添加maven依赖3、配置yml文件4、创建MilvusClient

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

SpringBoot实现微信小程序支付功能

《SpringBoot实现微信小程序支付功能》小程序支付功能已成为众多应用的核心需求之一,本文主要介绍了SpringBoot实现微信小程序支付功能,文中通过示例代码介绍的非常详细,对大家的学习或者工作... 目录一、引言二、准备工作(一)微信支付商户平台配置(二)Spring Boot项目搭建(三)配置文件

在Android平台上实现消息推送功能

《在Android平台上实现消息推送功能》随着移动互联网应用的飞速发展,消息推送已成为移动应用中不可或缺的功能,在Android平台上,实现消息推送涉及到服务端的消息发送、客户端的消息接收、通知渠道(... 目录一、项目概述二、相关知识介绍2.1 消息推送的基本原理2.2 Firebase Cloud Me