tencent cloud

游戏多媒体引擎

产品动态
产品介绍
产品概述
优势特性
产品功能
应用场景
安全合规认证
新手指引
产品计费
免费额度
购买指南
SDK 下载指引
产品功能体验
基本功能演示
场景化 Demo 体验
控制台指南
用量查看
服务开通
快速入门
快速接入 SDK
快速接入 Sample Project
基础功能开发指南
鉴权密钥
实时语音角色设置
音质选择
进阶功能开发指南
服务端录制
万人范围语音
3D 音效
音效与伴奏
网络音频流转发路由
自定义消息通道
如何应对公司防火墙限制
语言参数参考列表
房间管理功能
客户端 API
Unity SDK
Unreal Engine SDK
Cocos2D SDK
Windows SDK
iOS SDK
Android SDK
macOS SDK
H5SDK
Electron SDK
Flutter SDK
SDK 版本升级指引
错误码
编译工具链文档
服务端 API
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
常见问题
产品功能问题
问题解决指南
计费相关问题
Sample Project 使用问题
一般性问题
鉴权相关问题
实时语音进房失败问题
实时语音无声及音频问题
网络问题
语音转文本问题
工程导出问题
服务协议
服务等级协议
联系我们
词汇表
GME 政策
数据处理和安全协议
隐私协议
文档游戏多媒体引擎客户端 APISDK 版本升级指引

SDK 版本升级指引

PDF
聚焦模式
字号
最后更新时间： 2024-01-18 15:15:48
本文主要介绍适用于开发的接口升级技术文档。方便您调试和接入腾讯云游戏多媒体引擎 API。

GME 2.x 升级 GME 2.9

SDK 更新动态

动态库拆分。
修改 Android 包名。
GME SDK 更新后，除了 libgmesdk 外，新增以下库文件。

库文件对应功能

新版本的 GME 拆解了动态库，尽可能降低包体大小。可以根据自己的需求只引入相应的库文件。例如只需要变声功能，则只需引入 libgmesoundtouch。
库文件
对应功能
libgmefdkaac
1. 用于进入标准、高清音质房间
2. 用于播放 acc 格式伴奏文件
libgmefaad2
用于播放 mp4 格式伴奏文件
libgmeogg
用于播放 ogg 格式伴奏文件
libgmelamemp3
用于播放 mp3 格式伴奏文件
libgmesoundtouch
用于变声、变调功能

升级须知

iOS 端升级，需要参考 iOS 工程升级指引 进行相关配置。 Android 端升级，需要修改包名，将 Tencent 改为 GME，混淆配置也需要修改，参考 Android工程导出文档。 Unity 端升级，如果使用了标准音质或者高清音质，或者使用了伴奏，需要参考 Unity使用高清音质文档 进行解决。

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)

此接口用于设置实时语音伴奏升降调。
上一篇: 语音消息及转文本下一篇: 错误码

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈