初始化
说明:
- 只有初始化成功之后,其它接口才能被使用;
- 必须在主线程调用SDK的各个函数;
- SDK也将在主线程中回调;
- SDK反初始化时,将自动退出登录、离开参加的会议;
主线程消息派发器
为了让集成时不用过多考虑线程问题,所以需要将SDK的内部消息派发到主线程并在主线程与集成代码交互,
而c++没有一个标准的主线程消息队列,所以需要业务代码依据所用框架来提供一个主线程消息派发器,其作用为:
SDK将消息post给主线程消息队列,主线程在处理此消息时调用SDK的dealCRMsg接口来完成处理。
如下为Qt的主线程消息派发器实现代码:
//自定义消息对象:CRMsgEvent
class CRMsgEvent : public QEvent
{
public:
CRMsgEvent(uint32_t msgSN) : QEvent(QEvent::User), m_msgSN(msgSN) {}
uint32_t m_msgSN;
};
//Qt版本的主线程消息派发器
class CRMainThreadDispatch_Qt : public QObject, public CRMainThreadDispatch
{
public:
CRMainThreadDispatch_Qt(QObject *parent=nullptr) : QObject(parent){}
virtual void postCRMsg(uint32_t msgSN)
{
//向CRMainThreadDispatch_Qt发消息;
//CRMainThreadDispatch_Qt为主线程对象,等于消息派发给了主线程
//由于QCoreApplication::postEvent线程安全,所以无需提心多线程问题
QCoreApplication::postEvent(this, new CRMsgEvent(msgSN));
}
bool event(QEvent *e)
{
//主线程的CRMainThreadDispatch_Qt在处理QEvent::User消息时,
//调用SDK内部的dealCRMsg来完成消息的处理
if (e->type() == QEvent::User)
{
CRMsgEvent *pMsg = static_cast(e);
dealCRMsg(pMsg->m_msgSN);
return true;
}
return QObject::event(e);
}
};
CRMainThreadDispatch_Qt g_CRMainThreadDispatch;
创建SDK对象
将 SDK 集成到产品中时,需要先创建SDK对象
CRMeetingSDK* g_meetingSDK = createCRMeetingSDK();
init
使用前调用init完成SDK的初始化
CRMeetingSDK::SDKInitDat initDat;
initDat.pDispatch = &g_CRMainThreadDispatch; //主线程消息派发器
initDat.pCallBack = this; //消息回调
initDat.meetingAppPathName = meetingAppFileName.constData(); //会议程序路径文件名
initDat.SDKLogPath = logDir.constData(); //SDK 日志目录
initDat.server = server.constData(); //SDK 服务器地址
CRMEETINGSDK_ERR err = g_meetingSDK->init(initDat);
if( err!=CRMSDKERR_SUCCESS )
{
//初始化失败,失败原因:err
return;
}
uninit
使用完SDK,调用uninit执行sdk的反初始化:
g_meetingSDK->uninit();
销毁SDK对象
sdk对象不再需要时,调用destroy执行sdk的销毁处理:
g_meetingSDK->destroy();
g_meetingSDK = nullptr;