# 通话管理

# 通话静音

JCSDK 提供了两种静音方式,分别用于静音扬声器和静音麦克风。静音扬声器则听不到对方的声音,静音麦克风则对方听不到本端的声音。

# 静音扬声器

按照以下步骤实现静音扬声器功能:

  1. 通过 JCCallItem 对象中的 speakerMute 属性获取扬声器静音状态。返回 true 表示已静音,false 表示未静音。
  2. 调用 JCCall 中的 muteSpeaker 方法开启/取消扬声器静音功能。

示例代码

JCCallItem *item = [call getActiveCallItem];
if(item){
    if(item.speakerMute){
        // 取消扬声器静音
        [call muteSpeaker:item mute:false];
    }else{
        // 开启扬声器静音
        [call muteSpeaker:item mute:true];
    }
}

# 静音麦克风

按照以下步骤实现静音麦克风功能:

  1. 通过 JCCallItem 对象中的 microphoneMute 属性获取麦克风静音状态。返回 true 表示已静音,false 表示未静音。
  2. 调用 JCCall 中的 muteMicrophone 方法开启/取消麦克风静音功能。

示例代码

JCCallItem *item = [call getActiveCallItem];
if(item){
    if(item.microphoneMute){
        // 取消麦克风静音
        [call muteMicrophone:item mute:false];
    }else{
        // 开启麦克风静音
        [call muteMicrophone:item mute:true];
    }
}

# 通话录音

可以在通话中进行录音,开启或关闭录音需要根据当前的录音状态来决定。

如果正在录制或者通话被挂起或者挂起的情况下,不能进行音频录制。

录音状态可通过 JCCallItem (opens new window) 对象中的 audioRecord (opens new window) 获取。

开启或关闭录音接口如下

/**
 * 语音通话录音,通过 JCCallItem 对象中的audioRecord状态来决定开启关闭录音
 *
 * @param item              JCCallItem 对象
 * @param enable            开启关闭录音
 * @param filePath          录音文件路径
 * @return                  返回 true 表示正常执行调用流程,false 表示调用异常
 */
-(bool)audioRecord:(JCCallItem* __nonnull)item enable:(bool)enable filePath:(NSString* __nullable)filePath;

示例代码

// 语音录制
- (void)audioRecord:(JCCallItem* __nonnull)item {
    if (item.audioRecord) { // 正在录制中
       //可以做录音结束的处理
       [call audioRecord:item enable:false filePath:@"your filePath"];
        ...
    } else { // 未在录制中
        // 创建录音文件
        NSString *filePath; // 录音文件的绝对路径,SDK会自动创建录音文件
        if (filePath != nil) {
           // 开始录音
           [call audioRecord:item enable:true filePath:filePath];
            ...
        } else {
            // 录音失败的处理
        }
    }
}

开启或关闭录音时,录音状态会发生改变,并通过 onCallItemUpdate 回调上报

/**
 *  @brief 通话状态更新回调(当上层收到此回调时,可以根据 JCCallItem 对象获得该通话的所有信息及状态,从而更新该通话相关UI)
 *  @param item JCCallItem 对象
 *  @param changeParam 更新标识类
 */
-(void)onCallItemUpdate:(JCCallItem* __nonnull)item changeParam:(JCCallChangeParam * __nullable)changeParam;

# 视频通话录制

处于视频通话状态时可以对当前视频通话进行视频录制。调用 videoRecord (opens new window) 开启/关闭视频通话录制。

在开启视频录制前确保以下几点:

  1. 当前没有在录音。

  2. 确保远端/本地正在上传视频流。

  3. 当前处在非录制状态下。

示例代码

JCCallItem* item = call.getActiveCallItem();
if (item != nil) {
    if (item.localVideoRecord {
        // 如果本地视频录制已开启,则关闭本地录制
        [call videoRecord:item enable:false remote:false width:0 height:0 filePath:nil bothAudio:false];
    } else if (item.getRemoteVideoRecord()) {
        // 如果远端视频录制已开启,则关闭远端录制
        [call videoRecord:item enable:false remote:true width:0 height:0 filePath:nil bothAudio:false]
    } else {
        NSString* localFilePath = @"自定义文件存储路径";
        NSString* remoteFilePath = @"自定义文件存储路径";
        if ([call videoRecord:item enable:true remote:false width:600 height:360 filePath:localFilePath bothAudio:true]) {
            // 开始录制本地视频
        } else {
            // 调用失败
        }
        if ([call videoRecord:item enable:true remote:true width:600 height:360 filePath:remoteFilePath bothAudio:true]) {
            // 开始录制远端视频
        } else {
            // 调用失败
        }
    }
}

# 开启/关闭呼叫保持

调用下面的方法对通话对象进行呼叫保持或解除呼叫保持(当通话对象处于被保持状态(即状态为held)时不可以进行此操作),开启或关闭呼叫保持需要根据 JCCallItem 对象中(hold (opens new window))的呼叫保持状态来决定

/**
 *  @brief                  呼叫保持,通过 JCCallItem 对象中的呼叫保持状态来决定开启关闭呼叫保持
 *  @param item             JCCallItem 对象
 *  @return                 返回 true 表示正常执行调用流程,false 表示调用异常
 */
-(bool)hold:(JCCallItem* __nonnull)item;

# 切换活跃通话

调用下面的方法对通话中被保持的对象和活跃的通话对象进行切换

/**
 *  @brief 切换活跃通话
 *  @param item 需要变为活跃状态的 JCCallItem 对象
 *  @return 返回 true 表示正常执行调用流程,false 表示调用异常
 */
-(bool)becomeActive:(JCCallItem* __nonnull)item;

示例代码

//获取活跃通话对象
JCCallItem *item = [call getActiveCallItem];;
//开启或关闭静音
[call mute:item];
//开启关闭呼叫保持
[call hold:item];
//切换活跃通话
[call becomeActive:item];

# 通话中发送消息

调用下面的接口在通话中实现发消息的功能

/**
 *  @brief 通过通话建立的通道发送数据
 *  @param item 需要发送数据的 JCCallItem 对象
 *  @param type 文本消息类型,用户可以自定义,例如text、xml等
 *  @param content 消息内容
 *  @return 返回 true 表示正常执行调用流程,false 表示调用异常
 */
-(bool)sendMessage:(JCCallItem * __nonnull)item type:(NSString * __nonnull)type content:(NSString * __nonnull)content;

当通话中收到消息时,会收到 onMessageReceive 回调

/**
 *  @brief 通话中收到消息的回调
 *  @param item JCCallItem 对象
 *  @param type 消息类型
 *  @param content 消息内容
 */
-(void)onMessageReceive:(JCCallItem * __nonnull)item type:(NSString * __nonnull)type content:(NSString * __nonnull)content;

示例代码

call sendMessage:item type:@"text" content:@"消息内容"];

TIP

不建议在通话中发送图片类型的消息

# 相关回调

通话过程中,如果通话状态发生了改变,如开启关闭静音、开启关闭通话保持、活跃状态切换、网络变化等,将会收到通话状态更新的回调

/**
 *  @brief 通话状态更新回调(当上层收到此回调时,可以根据 JCCallItem 对象获得该通话的所有信息及状态,从而更新该通话相关UI)
 *  @param item JCCallItem 对象
 *  @param changeParam 更新标识类
 */
-(void)onCallItemUpdate:(JCCallItem* __nonnull)item changeParam:(JCCallChangeParam * __nullable)changeParam;

关于 JCCallChangeParam 的说明请参考 JCCallItem.h 文件。

TIP

静音状态、通话保持状态、活跃状态可通过 JCCallItem (opens new window) 对象获得。

示例代码

-(void)onCallItemUpdate:(JCCallItem* __nonnull)item changeParam:(JCCallChangeParam * __nullable)changeParam {
    JCCallItem* callItem = item;
    if (changeParam.mute) { // 开启静音
        ...
    } else if (changeParam.state) { // 通话状态变化
        ...
    } else if (changeParam.held) { // 被挂起变化
        ...
    } else if (changeParam.active) { // 活跃状态变化
        ...
    } else if (changeParam.netStatus) { // 网络状态变化
        ...
    }
    ...
}
最后更新时间: 2021/6/17 15:27:55