游戏多媒体引擎 快速入门

二、1、获取单例

在使用语音功能时，需要首先获取 ITMGContext 对象。

三、示例代码

ITMGContext* context = ITMGContextGetInstance();context->SetTMGDelegate(this);

四、2、初始化 SDK

参数获取请查看 接入指引。
此接口需要来自腾讯云控制台的 AppID 号码作为参数，再加上 openID，这个 openID 是唯一标识一个用户，规则由 App 开发者自行制定，App 内不重复即可（目前只支持 INT64）。

注意：初始化 SDK 之后才可以进房。

五、函数原型

ITMGContext virtual int Init(const char* sdkAppId, const char* openID)

六、示例代码

#define SDKAPPID3RD "1400089356"cosnt char* openId="10001";ITMGContext* context = ITMGContextGetInstance();context->Init(SDKAPPID3RD, openId);

七、3、触发事件回调

通过在 update 里面周期的调用 Poll 可以触发事件回调。

八、函数原型

class ITMGContext {protected: virtual ~ITMGContext() {}public: virtual void Poll()= 0;}

九、示例代码

ITMGContextGetInstance()->Poll();

十、4、鉴权信息

生成 AuthBuffer，用于相关功能的加密和鉴权，如正式发布请使用后台部署密钥，后台部署请参考 鉴权密钥。离线语音获取鉴权时，房间号参数必须填 null。

十一、函数原型

int QAVSDK_AuthBuffer_GenAuthBuffer(unsigned int dwSdkAppID, const char* strRoomID, const char* strOpenID, const char* strKey, unsigned char* strAuthBuffer, unsigned int bufferLength);

十二、示例代码

unsigned int bufferLen = 512;unsigned char retAuthBuff[512] = {0};QAVSDK_AuthBuffer_GenAuthBuffer(atoi(SDKAPPID3RD), roomId, "10001", AUTHKEY,retAuthBuff,bufferLen);

十三、5、加入房间

用生成的鉴权信息进房，会收到消息为 ITMG_MAIN_EVENT_TYPE_ENTER_ROOM 的回调。加入房间默认不打开麦克风及扬声器。返回值为 AV_OK 的时候代表成功。
如果普通语音进房，业务方面无涉及范围语音需求，则使用普通进房接口。详细信息请查看 范围语音。

十四、函数原型

ITMGContext virtual int EnterRoom(const char* roomID, ITMG_ROOM_TYPE roomType, const char* authBuff, int buffLen)

房间音频类型请参考 音质选择。

十五、示例代码

ITMGContext* context = ITMGContextGetInstance();context->EnterRoom(roomID, ITMG_ROOM_TYPE_STANDARD, (char*)retAuthBuff,bufferLen);

十六、6、加入房间事件的回调

加入房间完成后会发送信息 ITMG_MAIN_EVENT_TYPE_ENTER_ROOM，在 OnEvent 函数中进行判断。

十七、示例代码

void TMGTestScene::OnEvent(ITMG_MAIN_EVENT_TYPE eventType,const char* data){ switch (eventType) { case ITMG_MAIN_EVENT_TYPE_ENTER_ROOM: { //进行处理 break; } }}

十八、7、开启关闭麦克风

此接口用来开启关闭麦克风。加入房间默认不打开麦克风及扬声器。

十九、函数原型

ITMGAudioCtrl virtual int EnableMic(bool bEnabled)

20、示例代码

ITMGContextGetInstance()->GetAudioCtrl()->EnableMic(true);

21、8、开启关闭扬声器

此接口用于开启关闭扬声器。

22、函数原型

ITMGAudioCtrl virtual int EnableSpeaker(bool enabled)

23、示例代码

ITMGContextGetInstance()->GetAudioCtrl()->EnableSpeaker(true);