本文将为刚入门游戏多媒体引擎(GME)的用户提供一条学习的路径。
1. 熟悉游戏多媒体引擎
2. 游戏多媒体引擎的计费模式
3. 体验服务
在使用游戏多媒体引擎之前,您可以先体验产品效果:
基本功能演示:体验功能包括实时语音、语音消息、转文本、实时语音3D音效、实时语音基础变声功能。
场景化 Demo 体验:体验场景化语音效果。
4. 开通服务
在使用腾讯云游戏多媒体引擎之前,您需要 注册腾讯云账号。
在 腾讯云游戏多媒体控制台 开通服务,可根据所需要使用的功能,开通相应的功能服务。详情请参见 服务开通。
5. 获取接入参数
客户端接入参数
1. 在 腾讯云游戏多媒体控制台 中,找到您刚刚创建的应用,在操作列单击设置,进入应用设置页面。
2. 在页面中可以获取到对应的 AppID 和权限密钥。所需参数在控制台的位置截图如下:
在使用 Sample Project 时,需要 AppID 以及权限密钥作为参数填入 Sample Project 中。
在使用 SDK 时,初始化接口 Init 需要使用 AppID 作为参数,在本地鉴权生成接口 QAVAuthBuffer.GenAuthBuffer 中需要权限密钥作为参数传入。
云 API 接入参数
6. 阅读 SDK 接入说明
7. 跑通 Sample Project
GME 各个平台均提供了 SDK 以及 Sample Project。通过跑通 SampleProject,可以协助开发者了解 GME SDK 如何接入。
7.1 下载 Sample Project
7.2 跑通 Sample Project
8. 接入基础功能
8.1 下载 SDK
8.2 快速接入 SDK
通过快速接入文档,精简接入步骤,快速接入体验功能。快速接入文档中所介绍的功能包括:实时语音、流式语音消息转文本。
平台 | 快速接入文档 |
Unity | |
Unreal Engine | |
Windows、iOS、Mac、Android |
8.3 基础功能详细接入
8.4 接入协助文档
可能会使用到的文档:
文档 | 何时使用 |
如果对实时语音房间类型选择困难,可以参考这篇文档。 | |
希望自己的应用 GME 服务相关的鉴权部署更加安全。 | |
从以前的GME版本升级到新的版本,需要查看此文档,了解接口改动。 | |
接入 SDK 调试的过程中发现接口或者回调返回了错误码,可根据此文档进行解决。 |
9. 接入进阶功能
如果您想 | 您可以阅读 |
在实时语音服务中实现范围语音效果(类似吃鸡游戏全局、小队语音效果)。 | |
根据游戏角色的位置移动,感受到角色的说话声音带有方位的立体声效果,根据距离的远近声音也具有衰减效果,使游戏语音更具沉浸感。 | |
通过 SDK 接口实现对房间内成员的管理、以及对房间内成员上下麦、禁麦的管理,例如游戏中的队长想要关闭房间内其他玩家的麦克风,或者游戏主播想让听众上麦 | |
利用 GME 在实时语音房间里面播放伴奏,调节伴奏的 EQ,以及播放本地音效。 | |
对实时语音进行变声,玩家可将音色调整成“大叔音”、“萝莉音”等形式,增加趣味性 | |
在实时语音房间中,已经有了小队,又匹配上了其他玩家组了一个匹配队伍,如果想要自己的说话只给小队的人听,又想听到匹配队伍里面路人玩家的声音 | |
识别实时语音、音频文件以及语音消息中的涉黄、暴力、谩骂、广告及其它各类敏感或不良信息 | |
将玩家的实时语音流转成文本,呈现实时字幕的效果 |
10. 控制台运营指引
11. 常见问题
功能相关问题
开发过程中的问题
12. 出现接入问题
非常抱歉,您接入的过程如果出现了一些问题,可以参考以下思路进行解决:
判断问题
也可以根据使用的服务,判断应该查看的问题文档:
使用的服务 | 可以查看的文档 |
实时语音服务 | |
语音消息服务 | |
语转文本服务 |
错误码
举例:在使用 SDK 的过程中,调用 3D 音效相关接口后接口返回 7003 的错误,查看错误码文档可以得知出现此错误码的原因是没有调用 InitSpatializer,可根据此建议排查代码中是否有调用过 InitSpatializer,以及调用的顺序是否正确。
寻求帮助
13. 交流与建议
使用腾讯云游戏多媒体引擎产品和服务中有任何问题或建议,您可以通过以下渠道反馈,将有专人跟进解决您的问题:
如果发现产品文档的问题,如链接、内容、API 错误等,您可以单击文档页右侧文档反馈或选中存在问题的内容进行反馈。
如果遇到产品相关问题,您可咨询 在线客服 寻求帮助。
如果您有其他疑问,可前往 腾讯云开发者社区 进行提问。