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 政策
数据处理和安全协议
隐私协议

工程配置

PDF
聚焦模式
字号
最后更新时间: 2024-01-18 15:11:45
为方便 Cocos2D 开发者调试和接入腾讯云游戏多媒体引擎产品 API,本文档主要为您介绍适用于 Cocos2D 开发的工程配置指引。

SDK 准备

1. 请下载相关 Demo 及 SDK,详情请参见 下载指引
2. 解压获取到的 SDK 资源。
3. 文件夹内容如下:
GMESDK:游戏音视频 SDK framework 文件。
GMECocosDemo:游戏音视频 SDK 示例工程。
说明:
SDK 支持在 Mac 系统上编译。

iOS Xcode 配置

1. 将 framework 添加到 Xcode 工程中并设置头文件引用位置。(GMESDK 文件夹中的 framework 文件,必须添加到工程中)
2. 添加依赖库,参考下图进行:




Android 配置

1. 将 gmesdk.jar 加入到 libs 库中。
2. 在 Activity 中导入 so 文件。示例如下:
public class AppActivity extends Cocos2dxActivity {
static final String TAG = "AppActivity";
static OpensdkGameWrapper gameWrapper ;
static {
OpensdkGameWrapper.loadSdkLibrary();
}
}
3. 在 oncreate 函数中进行初始化,顺序不能出错。
protected void onCreate(Bundle savedInstanceState) {
super.setEnableVirtualButton(false);
super.onCreate(savedInstanceState);
//初始化, 顺序不能错
gameWrapper = new OpensdkGameWrapper(this);
runOnGLThread(new Runnable() {
@Override
public void run() {
gameWrapper.initOpensdk();
}
});
}
4. 将自己的工程进行编译选项配置。请参考 GME Cocos Demo 中的 Android.mk。
路径:GMECocos/GMECocosDemo/proj.android-studio/app/jni/Android.mk。
preBuild.mk 文件的路径:/Users/username/Downloads/GMECocos/GMESDK/android/bin/preBuild.mk。

导出不同平台

从 Cocos2D 引擎导出不同平台,需要做相应的工程配置。

Android 平台

配置必要权限

在工程 AndroidManifest.xml 文件中添加以下权限
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
如果使用离线语音,请在清单文件 application 节点下添加:
<application android:usesCleartextTraffic="true" >

根据需求添加权限

请根据需求在工程 AndroidManifest.xml 文件中添加以下权限:
读写权限
蓝牙权限
读写权限不是必须添加的,请根据以下规则进行判断是否添加:
如果使用的是默认的日志路径(/sdcard/Android/data/xxx.xxx.xxx/files),即表示未对 SetLogPath 进行调用,则不需要 WRITE_EXTERNAL_STORAGE 权限。
如果调用 SetLogPath 接口将日志路径放在外部存储设备,以及使用语音消息功能在录制时的存储路径是在外部存储设备,则需要向用户申请 WRITE_EXTERNAL_STORAGE 权限,并得到用户明确批准。
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
需要根据以下规则判断如何添加蓝牙权限:
如果工程中的 targetSDKVersion 为 30 或者以下:
<uses-permission android:name="android.permission.BLUETOOTH"/>
如果工程中的 targetSDKVersion 为 31 或者以上:
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

iOS 平台

添加权限:
Microphone Usage Description:允许麦克风权限。
增加 Allow Arbitrary Loads 权限。如下图所示:




Windows 平台

需要到 下载指引 中下载 Windows SDK 后导入到工程中。

帮助和支持

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

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

文档反馈