呼叫与应答

概述

呼叫与应答是SDK的核心功能之一，提供了完整的会议呼叫、应答和会议管理功能。支持点对点通话、多人会议、预约会议等多种场景。

使用流程

1. 发起呼叫

登录成功后，可以发起呼叫：

// 发起呼叫 - 使用会议URI
NemoSdkAdaptor::getInstance()->makeCall("meeting_uri", "display_name");

// 发起呼叫 - 使用会议号
NemoSdkAdaptor::getInstance()->makeCall("123456789", "张三");

2. 处理来电

当收到来电时，通过回调函数处理：

void onCallInvited(const XYString& caller, const XYString& callUri, const XYString& displayName)
{
    // 处理来电邀请
    qDebug() << "Incoming call from:" << caller.str() 
             << ", URI:" << callUri.str() 
             << ", Name:" << displayName.str();
}

3. 应答或拒绝

根据用户选择进行应答或拒绝：

// 接受呼叫
NemoSdkAdaptor::getInstance()->acceptCall();

// 拒绝呼叫
NemoSdkAdaptor::getInstance()->rejectCall();

4. 结束通话

通话结束后，可以挂断或结束会议：

// 挂断当前通话
NemoSdkAdaptor::getInstance()->hangup();

// 结束整个会议
NemoSdkAdaptor::getInstance()->endMeeting();

功能分类

1. 呼叫管理

发起呼叫

API: makeCall

参数:

callUri: 呼叫URI或会议号
displayName: 显示名称

示例:

// 发起点对点通话
NemoSdkAdaptor::getInstance()->makeCall("user@domain.com", "张三");

// 发起会议
NemoSdkAdaptor::getInstance()->makeCall("meeting_123", "项目讨论会");

挂断呼叫

API: hangup

示例:

NemoSdkAdaptor::getInstance()->hangup();

结束会议

API: endMeeting

示例:

NemoSdkAdaptor::getInstance()->endMeeting();

2. 应答处理

接受呼叫

API: acceptCall

示例:

NemoSdkAdaptor::getInstance()->acceptCall();

拒绝呼叫

API: rejectCall

示例:

NemoSdkAdaptor::getInstance()->rejectCall();

3. 会议信息

获取参会者信息

API: getParticipantInfo

示例:

NemoSdkAdaptor::getInstance()->getParticipantInfo("user_id");

获取呼叫URL信息

API: getCallUrlInfo

示例:

NemoSdkAdaptor::getInstance()->getCallUrlInfo("call_uri");

4. 历史记录

获取通话历史

API: getCallHistory

示例:

NemoSdkAdaptor::getInstance()->getCallHistory();

删除通话历史

API: deleteCallHistory

示例:

NemoSdkAdaptor::getInstance()->deleteCallHistory("call_id");

5. 预约会议

获取最新预约会议

API: getScheduledMeetingInfo

示例:

NemoSdkAdaptor::getInstance()->getScheduledMeetingInfo();

获取所有预约会议

API: getAllScheduledMeetingInfo

示例:

NemoSdkAdaptor::getInstance()->getAllScheduledMeetingInfo();

6. 会议冲突处理

获取会议冲突信息

API: getMeetingConlictInfo

示例:

NemoSdkAdaptor::getInstance()->getMeetingConlictInfo();

结束会议冲突

API: endMeetingConflict

示例:

NemoSdkAdaptor::getInstance()->endMeetingConflict("conflict_meeting_id");

完整示例代码

class CallManager {
private:
    bool _isInCall = false;
    QString _currentCallUri;
    QString _currentCaller;

public:
    void makeCall(const QString& callUri, const QString& displayName) {
        NemoSdkAdaptor::getInstance()->makeCall(
            callUri.toStdString(), 
            displayName.toStdString()
        );
    }

    void acceptCall() {
        NemoSdkAdaptor::getInstance()->acceptCall();
    }

    void rejectCall() {
        NemoSdkAdaptor::getInstance()->rejectCall();
    }

    void hangup() {
        NemoSdkAdaptor::getInstance()->hangup();
    }

    void endMeeting() {
        NemoSdkAdaptor::getInstance()->endMeeting();
    }

    void getCallHistory() {
        NemoSdkAdaptor::getInstance()->getCallHistory();
    }

    void getScheduledMeetings() {
        NemoSdkAdaptor::getInstance()->getAllScheduledMeetingInfo();
    }

    // 呼叫状态变化回调
    void onCallStateChanged(XYCallState state, const XYString& callUri) {
        QString uri(callUri.str());
        
        switch (state) {
            case XYCallState_Connecting:
                qDebug() << "Call connecting:" << uri;
                break;
            case XYCallState_Connected:
                qDebug() << "Call connected:" << uri;
                _isInCall = true;
                _currentCallUri = uri;
                break;
            case XYCallState_Disconnected:
                qDebug() << "Call disconnected:" << uri;
                _isInCall = false;
                _currentCallUri.clear();
                break;
            case XYCallState_Failed:
                qDebug() << "Call failed:" << uri;
                _isInCall = false;
                break;
        }
        
        emit callStateChanged(state, uri);
    }

    // 来电邀请回调
    void onCallInvited(const XYString& caller, const XYString& callUri, const XYString& displayName) {
        QString callerStr(caller.str());
        QString uri(callUri.str());
        QString name(displayName.str());
        
        _currentCaller = callerStr;
        _currentCallUri = uri;
        
        qDebug() << "Incoming call from:" << callerStr 
                 << ", URI:" << uri 
                 << ", Name:" << name;
        
        // 显示来电界面
        emit incomingCall(callerStr, uri, name);
    }

    // 会议邀请回调
    void onMeetingInvited(const XYString& meetingUri, const XYString& displayName) {
        QString uri(meetingUri.str());
        QString name(displayName.str());
        
        qDebug() << "Meeting invitation:" << uri << ", Name:" << name;
        
        emit meetingInvited(uri, name);
    }

    // 获取通话历史结果回调
    void onGetCallHistoryResult(const XYString& code, const XYArray& callHistory) {
        QString errCode(code.str());
        
        if (errCode == SDKError_NoError) {
            qDebug() << "Call history retrieved successfully";
            // 处理通话历史数据
            emit callHistoryReceived(callHistory);
        } else {
            qDebug() << "Failed to get call history:" << errCode;
        }
    }

    // 获取预约会议结果回调
    void onGetScheduledMeetingInfoResult(const XYString& code, const XYArray& meetings) {
        QString errCode(code.str());
        
        if (errCode == SDKError_NoError) {
            qDebug() << "Scheduled meetings retrieved successfully";
            emit scheduledMeetingsReceived(meetings);
        } else {
            qDebug() << "Failed to get scheduled meetings:" << errCode;
        }
    }

    // 呼叫错误回调
    void onCallError(XYCallError error, const XYString& callUri) {
        QString uri(callUri.str());
        qDebug() << "Call error:" << error << ", URI:" << uri;
        
        emit callError(error, uri);
    }

    bool isInCall() const {
        return _isInCall;
    }

    QString getCurrentCallUri() const {
        return _currentCallUri;
    }

    QString getCurrentCaller() const {
        return _currentCaller;
    }
};

呼叫状态说明

状态	说明
`XYCallState_Connecting`	正在连接中
`XYCallState_Connected`	已连接
`XYCallState_Disconnected`	已断开
`XYCallState_Failed`	连接失败

呼叫错误说明

错误	说明
`XYCallError_NoError`	正常
`XYCallError_Timeout`	超时
`XYCallError_NetworkError`	网络错误
`XYCallError_Rejected`	被拒绝
`XYCallError_Busy`	忙线
`XYCallError_NotFound`	未找到

注意事项

登录状态: 必须先登录成功才能发起或接收呼叫
权限检查: 确保有相应的呼叫权限
网络状态: 保持良好的网络连接以确保通话质量
资源释放: 通话结束后及时释放相关资源
错误处理: 正确处理各种呼叫错误情况

API 参考

呼叫管理

方法	描述	链接
makeCall	发起呼叫	查看详情
hangup	挂断呼叫	查看详情
endMeeting	结束会议	查看详情

应答处理

方法	描述	链接
acceptCall	接受呼叫	查看详情
rejectCall	拒绝呼叫	查看详情

会议信息

方法	描述	链接
getParticipantInfo	查询参会者信息	查看详情
getCallUrlInfo	获取呼叫URL信息	查看详情

历史记录

方法	描述	链接
getCallHistory	获取历史通话记录	查看详情
deleteCallHistory	删除指定历史通话记录	查看详情

预约会议

方法	描述	链接
getScheduledMeetingInfo	请求最新一次会议预约	查看详情
getAllScheduledMeetingInfo	请求全部会议预约	查看详情

会议冲突

方法	描述	链接
getMeetingConlictInfo	获取会议冲突信息	查看详情
endMeetingConflict	结束会议冲突	查看详情

回调相关

回调	描述	链接
onCallStateChanged	呼叫状态变化回调	查看详情
onCallInvited	来电邀请回调	查看详情
onMeetingInvited	会议邀请回调	查看详情
onCallError	呼叫错误回调	查看详情
onGetCallHistoryResult	获取通话历史结果回调	查看详情
onGetParticipantInfoResult	获取参会者信息结果回调	查看详情
onGetScheduledMeetingInfoResult	获取预约会议结果回调	查看详情
onGetAllScheduledMeetingInfoResult	获取所有预约会议结果回调	查看详情
onGetMeetingConlictInfoResult	获取会议冲突信息结果回调	查看详情
onEndMeetingConflictResult	结束会议冲突结果回调	查看详情
onScheduleMeetingNotification	预约会议通知回调	查看详情
onScheduleMeetingChanged	预约会议变化回调	查看详情

枚举	描述	链接
XYCallState	呼叫状态枚举	查看详情
XYCallError	呼叫错误枚举	查看详情

呼叫与应答

概述

使用流程

1. 发起呼叫

2. 处理来电

3. 应答或拒绝

4. 结束通话

功能分类

1. 呼叫管理

发起呼叫

挂断呼叫

结束会议

2. 应答处理

接受呼叫

拒绝呼叫

3. 会议信息

获取参会者信息

获取呼叫URL信息

4. 历史记录

获取通话历史

删除通话历史

5. 预约会议

获取最新预约会议

获取所有预约会议

6. 会议冲突处理

获取会议冲突信息

结束会议冲突

完整示例代码

呼叫状态说明

呼叫错误说明

注意事项

API 参考

呼叫管理

应答处理

会议信息

历史记录

预约会议

会议冲突

回调相关

相关枚举