为方便 Cocos2D 开发者调试和接入腾讯云游戏多媒体引擎产品 API,本文档主要为您介绍适用于 Cocos2D 开发的工程配置指引。
SDK 准备
1. 请下载相关 Demo 及 SDK,详情请参见 下载指引。 2. 解压获取到的 SDK 资源。
3. 文件夹内容如下:
GMESDK:游戏音视频 SDK framework 文件。
GMECocosDemo:游戏音视频 SDK 示例工程。
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 后导入到工程中。
本页内容是否解决了您的问题?