SDK 版本升级指引

最近更新时间:2020-09-24 14:49:37

本文主要介绍适用于开发的接口升级技术文档。方便您调试和接入腾讯云游戏多媒体引擎 API。

GME 2.2 升级 GME 2.3.5

SDK 更新动态

新增功能

  • 支持实时语音过程中使用离线语音。
  • 支持实时语音过滤,可识别暴恐、涉黄、涉政等信息。
  • 支持 H5 实时语音,实现全平台实时语音互通。
  • 新增 Android v8a 架构支持。
  • Android 低延时采集播放适配。

优化能力

  • 优化 SDK 的范围语音功能接口,降低接入门槛。
  • 语音降噪效果优化。
  • 大幅降低 SDK 内存消耗。

主要接口变更

EnterRoom

进房操作由同步改为异步调用,返回值为0时的,表示异步投递成功,等待回调函数进行处理,若返回值不为0时,则表示异步投递失败。

public abstract int EnterRoom();

ExitRoom

退房操作由同步改为异步调用,参照 RoomExitComplete 回调函数处理,返回值为 AV_OK 时,表示异步投递成功。

注意:

如果应用中有退房后立即进房的场景,在接口调用流程上,开发者无需要等待 ExitRoom 的回调 RoomExitComplete 通知,只需直接调用接口。

public abstract int ExitRoom();

错误码变更

  • 如需对所有错误码统一处理,请使用 !AV_OK。
  • 如需单独处理每一类错误,请关注接口返回的错误类型。
说明:

错误码“1”没有明确含义,且2.3.5以后版本不再返回,故删除。

其他接口变更

PauseAudio/ResumeAudio

public int PauseAudio()
public int ResumeAudio()

在2.3之前版本的 SDK 接口调用过程中,如有调用 ITMGAudioCtrl::PauseAudio/ResumeAudio 两个接口,可参照下表进行版本对比。

2.3 之前版本 升级 2.3 版本
使用目的为与其他模块互斥 将 PauseAudio 改为 Pause,将 ResumeAudio 改为 Resume
使用目的为在实时语音中使用离线语音 请将 PauseAudio 及 ResumeAudio 删除

SetLogLevel 接口参数变更

原接口

ITMGContext virtual void SetLogLevel(int logLevel, bool enableWrite, bool enablePrint)

新接口

ITMGContext virtual void SetLogLevel(ITMG_LOG_LEVEL levelWrite, ITMG_LOG_LEVEL levelPrint)

参数说明

参数 类型 说明
levelWrite ITMG_LOG_LEVEL 设置写入日志的等级,TMG_LOG_LEVEL_NONE 表示不写入
levelPrint ITMG_LOG_LEVEL 设置打印日志的等级,TMG_LOG_LEVEL_NONE 表示不打印

ITMG_LOG_LEVEL 类型

ITMG_LOG_LEVEL 说明
TMG_LOG_LEVEL_NONE=0 不打印日志
TMG_LOG_LEVEL_ERROR=1 打印错误日志(默认)
TMG_LOG_LEVEL_INFO=2 打印提示日志
TMG_LOG_LEVEL_DEBUG=3 打印开发调试日志
TMG_LOG_LEVEL_VERBOSE=4 打印高频日志

GME 2.3.5 升级 GME 2.5.1

增加接口

GetSendStreamLevel

此接口用于获取音频上行实时音量,返回值为 int 类型,取值范围为0到100。

ITMGContextGetInstance()->GetAudioCtrl()->GetSendStreamLevel();

GetRecvStreamLevel

此接口用于获取房间内其他成员下行实时音量,返回值为 int 类型,取值范围为0到100。

iter->second.level = ITMGContextGetInstance()->GetAudioCtrl()->GetRecvStreamLevel(iter->second.openid.c_str());

接口变更

语音消息及转文字接口变更返回值

以下接口返回值修改为 int 类型。

StartRecording
UploadRecordedFile
DownloadRecordedFile
PlayRecordedFile
SpeechToText

GME 2.5 升级 GME 2.7

增加接口

PlayRecordedFile(const char* filePath, ITMG_VOICE_TYPE voiceType)

此接口用于播放带有变声效果的语音消息。

SetAccompanyKey(int nKey)

此接口用于设置实时语音伴奏升降调。

目录