为方便开发者调试和接入腾讯云游戏多媒体引擎产品,本文主要为您介绍适用于使用 Windows 平台第三方播放器伴奏功能的相关技术。
前提条件
已完成 GME 应用创建,并获取 SDK AppID 和 Key。请参考 服务开通指引。
已开通 GME 实时语音服务。请参考 服务开通指引。
GME 使用前请对工程进行配置,否则 SDK 不生效。
配置头文件
1. 请参考 配置文档,完成 GME 工程配置。
2. 将文件 tmg_adv_win.h 放置在 GME SDK(For Windows)下,与其他头文件保持同一目录。
3. 单击 下载,下载两个 dll 文件,路径与其他库文件一致。导出可执行文件后,应与可执行文件同目录。
调用接口
开始播放
调用此参数,将挂钩整个系统的声音,或者某播放器的声音。
函数原型
virtual int StartAccompany(const char* playerPath, int playerPathLength, const char* mediaFilePath, int mediaFilePathLenght, GMEAccompany_SourceType sourceType) = 0
参数 | 类型 | 含义 |
playerPath | const char* | 播放器路径 |
playerPathLength | int | 播放器路径长度 |
mediaFilePath | const char* | 音频资源路径,1. 某音频文件,2. 音频文件夹,可以不传(NULL) |
mediaFilePathLenght | int | 音频资源路径长度 |
sourceType | GMEAccompany_SourceType | 设置采集对象,详细见 下表 |
sourceType 说明:
参数 | 类型 |
AV_ACCOMPANY_SOURCE_TYPE_NONE = 0 | 代表不开启 |
AV_ACCOMPANY_SOURCE_TYPE_SYSTEM = 1 | 代表挂钩整个系统的声音,此时可以不传音频资源路径,但需要传一个已知文件路径作为播放器路径参数及播放器路径长度参数 |
AV_ACCOMPANY_SOURCE_TYPE_PROCESS = 2 | 代表挂钩某进程的声音,例如 QQ 音乐播放器 |
示例代码
const char* file = "C:\\\\1.txt";//当挂钩系统声音时,需要传入一个已知文件路径,请确保此文件存在int ret = ITMGAdcanceGetInstance()->StartAccompany(file, strlen(file), NULL, 0, AV_ACCOMPANY_SOURCE_TYPE_SYSTEM);
停止播放
调用此参数,将停止挂钩。
函数原型
virtual int StopAccompany() = 0
设置声音音量
调用此参数,将设置挂钩的声音音量大小,数值100表示音量不增大也不衰减。数值范围为0到200。
函数原型
virtual int SetAccompanyVolume(int value) = 0;
获取声音音量
调用此参数,将获取挂钩的声音音量大小。
函数原型
virtual int GetAccompanyVolume(int* pVolume) = 0;
获取实时声音音量
调用此参数,将获取挂钩的实时声音音量,可以用来展示实时音量能量条。
函数原型
virtual int GetAccompanyVolumeDynamic(int* pVolume) = 0;
设置采集设备音量
调用此参数,设置采集设备声音音量,默认数值为100,数值范围为0到100,0代表静音。
函数原型
virtual int SetMicDeviceVolume(int vol) = 0;
获取采集设备音量
调用此参数,将获取采集设备声音音量。
函数原型
virtual int GetMicDeviceVolume() = 0;
设置播放设备音量
调用此参数,设置播放设备声音音量,默认数值为100,数值范围为0到100,0代表静音。
函数原型
virtual int SetSpeakerDeviceVolume(int vol) = 0;
获取播放设备音量
调用此参数,将获取播放设备声音音量。
函数原型
virtual int GetSpeakerDeviceVolume() = 0;