初始化

说明:
  1. 只有初始化成功之后,其它接口才能被使用;
  2. 必须在主线程调用SDK的各个函数;
  3. SDK也将在主线程中回调;
  4. 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;

相关API

createCRMeetingSDK
init
uninit
destroy