文档中心>游戏多媒体引擎

SDK 2.X升级 3.X指引

最近更新时间:2025-12-26 17:08:51

我的收藏

3.X SDK 版本新特性

1. 音频 3A 效果

3.X 版本的 3A(AGC、AEC、ANS)算法进行了全面的升级,并引入了 AI 降噪能力,不仅听得见,更能听的清,听得真。




2. 弱网络下表现

3.X 版本升级了网络模块,极大的提升了弱网络下的表现。




3. 全新升级的范围语音功能

在 2.X 版本的2种范围语音模式(小队模式+范围模式)基础上进行扩展,提供全新的11种范围语音模式,方便客户自由组合,实现多种语音玩法。
语音模式
功能
ITMG_RANGE_AUDIO_MODE_SND_ALL_REC_ALL
默认模式
音频发送给房间内所有用户
接收房间内所有玩家的音频
ITMG_RANGE_AUDIO_MODE_SND_ALL_REC_BOTH
主持人模式,主持人设置为该模式,可让房间内所有人都能听到主持人的声音,主持人只能接收附近和其他主持人的声音
音频发送给房间内所有用户,不管对方设置的是什么模式都能听到
接收附近范围内和同队用户的音频
ITMG_RANGE_AUDIO_MODE_SND_TEAM_REC_TEAM
小队模式
音频只发送给同队用户
只接收同队用户的音频
ITMG_RANGE_AUDIO_MODE_SND_TEAM_REC_PROX
音频发送给同队用户
只接收附近范围内用户的音频
ITMG_RANGE_AUDIO_MODE_SND_TEAM_REC_BOTH
音频发送给同队用户
接收附近范围内和同队用户的音频
ITMG_RANGE_AUDIO_MODE_SND_PROX_REC_TEAM
音频只发送给附近范围内的用户
只接收同队用户的音频
ITMG_RANGE_AUDIO_MODE_SND_PROX_REC_PROX
范围模式
音频只发送给附近范围内的用户
只接收附近范围内的用户的音频
ITMG_RANGE_AUDIO_MODE_SND_PROX_REC_BOTH
音频只发送给附近范围内的用户
接收附近范围内和同队用户的音频
ITMG_RANGE_AUDIO_MODE_SND_BOTH_REC_TEAM
音频发送给附近范围内和同队用户
只接收同队用户的音频
ITMG_RANGE_AUDIO_MODE_SND_BOTH_REC_PROX
音频发送给附近范围内和同队用户
只接收附近范围内的用户的音频
ITMG_RANGE_AUDIO_MODE_SND_BOTH_REC_BOTH
音频发送给附近范围内和同队用户
接收附近范围内和同队用户的音频

2.X 版本升级到 3.X 版本指引

说明:
由于 3.X 版本对语音多媒体服务器进行了全面升级,所以从 2.X 版本升级到 3.X 版本需要申请 GME 3.0 SDKAppid 配套使用。
3.X 版本的接口和 2.X 版本的保持一致,从2.X升级到3.X时GME SDK集成代码基本上不需要做改动。

1. 申请 APPID

在使用 GME 3.X SDK 之前需要申请新的新的 AppID,进入 腾讯云 GME 控制台,选择服务管理,单击新建3.0应用创建 GME 3.0应用并获取 APPID。



应用版本是GME 3.0 则为 GME 3.0应用,应用版本为 GME 则为GME 2.0 应用。不同的应用版本使用的 SDK 版本不同。

2. 下载 3.X 版本 SDK

下载 GME 3.X 版本 SDK,SDK 下载指引

3. 项目中接入 3.X 版本 SDK

在项目中接入 GME 3.X 版本 SDK 时可参考下列文档:

4. 日志路径

日志文件为 LiteAV_开头,后缀为 .clog 的文件。
日志所在目录如下:
平台
路径
Windows
%appdata%\\liteav\\log\\processName
iOS
Application/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Documents/log
Android
/sdcard/Android/data/xxx.xxx.xxx/files/log/liteav
Mac
/Users/userName/Library/Containers/packageName/Data/Documents
OHOS
/data/app/el2/100/base/包名/haps/模块名/files/log/liteav
如果是使用 Unity 引擎,并且在 Windows 端开发,Editor 运行的日志可以尝试在 %appdata%\\liteav\\log\\Unity.exe 路径下找到日志。
在 iOS 真机上,可以通过应用程序支持文件共享来取得日志,具体步骤如下:
1. 在应用程序的 Info.plist 文件中添加 UIFileSharingEnabled 键,并将键值设置为“YES”。
2. 将您希望共享的文件放在应用程序的 Documents 目录下。
3. 一旦设备插入到用户计算机,iTunes 就会在选中设备的 Apps 标签中显示一个 File Sharing 区域。
4. 此后,用户就可以向该目录添加文件或者将文件移动到桌面计算机中。

查看用量

查看实时语音、语音消息、语音转文本、文本翻译服务用量

在控制台中可以查看应用使用量。在服务管理中,针对需要查看用量的应用,单击查看用量




查看实时语音审核用量

实时语音审核用量及明细查询,需要在内容审核监控模块中查看。




云API支持情况

目前 3.0 支持的云API情况如下:
功能名称
接口
调用须知
剔除房间或房间成员
DeleteRoomMember
-
修改用户麦克风状态
ModifyUserMicStatus
通过参数 Uids 传入用户列表。
创建语音消息转文本热句模型
CreateCustomization
-
删除语音消息转文本热句模型
DeleteCustomization
-
查询语音消息转文本热句模型列表
GetCustomizationList
-
更新语音消息转文本热句模型
ModifyCustomization
-
修改语音消息转文本热句模型状态
ModifyCustomizationState
-