iOS 进阶

1. 互动连麦

语音连麦的流程如下图所示

1.1 发送连麦请求

通过发送消息功能实现连麦请求的发送，接口如下

/**
 * @brief 发送消息
 *
 * @param type 消息类型
 * @param content 消息内容，当 toUserId 不为 nil 时，content 不能大于 4k
 * @param toUserId 接收者id，null则发给频道所有人员
 * @return 返回 true 表示成功，false表示失败
 */
-(bool)sendMessage:(NSString * __nonnull)type content:(NSString * __nonnull)content toUserId:(NSString * __nullable)toUserId;

示例代码

[mediaChannel sendMessage:MESSAGE_TYPE_REQUEST_VIDEO content: @"请求连麦" toUserId:@"主播id"];

1.2 接受连麦

连麦消息发送后，主播会收到 onMessageReceive 回调

/**
 * @brief 接收频道消息的回调
 *
 * @param type 消息类型
 * @param content 消息内容
 * @param fromUserId    消息发送成员的userId
 */
-(void)onMessageReceive:(NSString *)type content:(NSString *)content fromUserId:(NSString *)fromUserId;

此时，主播可以根据消息类型（开发者可以自定义消息类型字符串）以及消息发送的对象进行对应的处理。

如果是语音连麦，则主播同意后，连麦成员会收到成员状态更新的回调，此时请求连麦的成员需要调用 enableUploadAudioStream 接口上传本地音频流。

主播同意连麦后，成员状态变为连麦互动状态。此时需要调用“设置状态”接口改变成员的状态。

1.3 设置状态

当成员与主播进行音视频连麦、停止连麦以及连麦成员离开时，均需要调用下面的接口设置成员状态

/**
 * @brief 设置自定义状态
 *
 * @param customState 自定义状态, 参看 JCMediaChannelCustomState
 * @param participant 成员，nil 则默认设置自己
 */
-(void)setCustomState:(JCMediaChannelCustomState)customState participant:(JCMediaChannelParticipant * __nullable)participant;

状态值可以根据 JCMediaChannelCustomState 枚举值自定义，JCMediaChannelCustomState 有以下几种

/// 无自定义状态
JCMediaChannelCustomStateNone = 0,
/// 自定义状态0
JCMediaChannelCustomState0 = 1<<12,
/// 自定义状态1
JCMediaChannelCustomState1 = 1<<13,
/// 自定义状态2
JCMediaChannelCustomState2 = 1<<14,
/// 自定义状态3
JCMediaChannelCustomState3 = 1<<15,

例如

//自定义音频连麦状态
JCMediaChannelCustomState STATE_AUDIO_JOIN = JCMediaChannelCustomState0;

状态设置后，可以通过下面的方法获取自定义状态值

/**
 * @brief 获得自定义状态
 *
 * @return
 */
-(JCMediaChannelCustomState)getCustomState;

示例代码

//自定义音频连麦状态
JCMediaChannelCustomState STATE_AUDIO_JOIN = JCMediaChannelCustomState0;
-(void)mediaChannelMessage:(NSNotification*)note {
  NSDictionary *dic = note.object;
  //取出消息类型
  NSString *type = [dic objectForKey:KtypeKey];
  //取出消息发送者id
  NSString *userId = [dic objectForKey:kFromUserIdKey];
  //获取发送者对象
  JCMediaChannelParticipant *partp = [mediaChannel getParticipant:userId];
  if (// 主播同意音频连麦) {
      if partp != nil {
          //设置成员状态为音频加入者
          [mediaChannel setCustomState:STATE_AUDIO_JOIN participant: partp];
      }
  }
}

成员状态设置后会收到 onParticipantUpdate 回调，该回调会上报变化的成员以及变化的属性

/**
 *  @brief 成员更新回调
 *  @param participant 成员对象
 *  @param participantChangeParam 变化标识集合
 */
-(void)onParticipantUpdate:(JCMediaChannelParticipant*)participant participantChangeParam:(JCMediaChannelParticipantChangeParam *)participantChangeParam;

示例代码

-(void)onParticipantUpdate:(JCMediaChannelParticipant*)participant participantChangeParam:(JCMediaChannelParticipantChangeParam*)participantChangeParam {
    if (participant.isSelf && participant.isAudience && participantChangeParam.customState) {
        if (participant.isAudioJoiner) { //音频连麦成员
            [mediaChannel enableUploadVideoStream:false];
            [mediaChannel enableUploadAudioStream:true];
        } else { //普通成员
            [mediaChannel enableUploadVideoStream:false];
            [mediaChannel enableUploadAudioStream:false];
        }
    }

2. 踢出成员

直播中，主播可以调用下面的接口踢出成员

/**
 * @brief 将成员踢出会议
 *
 * @param participant 成员
 * @return true表示成功，false表示失败
 */
-(BOOL)kick:(JCMediaChannelParticipant * __nonnull)participant;

示例代码

[mediaChannel kick:partp];

3. 发送消息

如果想在直播中发送消息，可以调用下面的接口

/**
 * @brief 发送消息
 *
 * @param type 消息类型
 * @param content 消息内容，当 toUserId 不为 nil 时，content 不能大于 4k
 * @param toUserId 接收者id，null则发给频道所有人员
 * @return 返回 true 表示成功，false表示失败
 */
-(bool)sendMessage:(NSString * __nonnull)type content:(NSString * __nonnull)content toUserId:(NSString * __nullable)toUserId;

其中，消息类型（type）为自定义类型。

示例代码

-(void)onJoin:(bool)result reason:(JCMediaChannelReason)reason channelId:(NSString*)channelId {
    // 发送给所有成员
    [mediaChannel sendMessage:@"text" content:@"content" toUserId:nil];
    // 发送给某个成员
    [mediaChannel sendMessage:@"text" content:@"content" toUserId:@"接收者id"];
}

当频道中的其他成员收到消息时，会收到 onMessageReceive 回调

/**
 * @brief 接收频道消息的回调
 *
 * @param type 消息类型
 * @param content 消息内容
 * @param fromUserId    消息发送成员的userId
 */
-(void)onMessageReceive:(NSString *)type content:(NSString *)content fromUserId:(NSString *)fromUserId;