Talk SDK for Cocos2d C++ 使用指南

适用范围

本规范仅适用于使用游密实时语音引擎Cocos2d-x接口(C++接口)开发多人实时语音功能的开发者。

SDK目录概述

语音SDK中有两个子文件夹:lib、include,下面依次介绍下这两个子文件夹。

  1. include:SDK的头文件。 详细介绍下inlude,所有接口都在这个文件夹中。
    • IYouMeVoiceEngine.h封装了语音SDK的全部功能接口,集成方可通过IYouMeVoiceEngine::getInstance ()->…来调用语音SDK接口。
    • IYouMeEventCallback.h包含语音SDK的所有回调事件接口,例如初始化结果,频道加入成功等,都将通过此接口通知集成方
    • YouMeConstDefine.h包含语音SDK的所有枚举类型定义,如错误码等。
  2. lib:库文件,分为Android平台和iOS平台。Android平台下包括ARMv5、ARMv7和X86三种CPU架构下的libyoume_voice_engine.so文件,还包括youme_voice_engine.jar。iOS平台下包含libyoume_voice_engine.a文件和libYouMeCommon.a文件。

开发环境集成

Cocos2d-x开发环境生成的目录结构如下图所示,将SDK目录更名为youme_voice_engine(内含“include”和“lib”两个子文件夹),并复制到游戏的根目录下,这个目录下包含了Android和iOS两个平台所需的所有C++头文件和库文件。

Android系统Eclipse开发环境配置

  1. 修改proj.android/jni/Android.mk文件,对应位置增加指定内容,分别对游密实时语音SDK的动态库进行预编译处理、添加头文件路径、链接动态库。

    
    LOCAL_PATH := $(call my-dir)
    include $(CLEAR_VARS)
    $(call import-add-path,$(LOCAL_PATH)/../../cocos2d)
    $(call import-add-path,$(LOCAL_PATH)/../../cocos2d/external)
    $(call import-add-path,$(LOCAL_PATH)/../../cocos2d/cocos)
    
    #======Youme 添加=========
    LOCAL_MODULE := youme_voice_engine
    LOCAL_SRC_FILES := ../$(LOCAL_PATH)/../../youme_voice_engine/lib/android/$(TARGET_ARCH_ABI)/libyoume_voice_engine.so
    include $(PREBUILT_SHARED_LIBRARY)
    #======结束 Youme 添加=======
    
    LOCAL_MODULE := cocos2dcpp_shared
    LOCAL_MODULE_FILENAME := libcocos2dcpp
    LOCAL_SRC_FILES := hellocpp/main.cpp \
                       ../../Classes/Helloworld.cpp
    #========Youme修改=========
    LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes \
                        $(LOCAL_PATH)/../../youme_voice_engine/include
    #======结束 Youme 修改=======
    
    # _COCOS_HEADER_ANDROID_BEGIN
    # _COCOS_HEADER_ANDROID_END
    LOCAL_STATIC_LIBRARIES := cocos2dx_static
    
    #======Youme 添加=========
    LOCAL_SHARED_LIBRARIES := youme_voice_engine
    #======结束 Youme 添加=======
    
    # _COCOS_LIB_ANDROID_BEGIN
    # _COCOS_LIB_ANDROID_END
    include $(BUILD_SHARED_LIBRARY)
    $(call import-module,.)
    # _COCOS_LIB_IMPORT_ANDROID_BEGIN
    # _COCOS_LIB_IMPORT_ANDROID_END
    
    1. 如果需要显示指定CPU架构则修改proj.android/jni/Application.mk文件,增加指定部分的内容(v5版本为APP_ABI := armeabi);如果不需要指定CPU架构Application.mk文件, 则不用修改。

      
      #======修改===========
      APP_ABI := armeabi-v7a
      #======结束修改=========
      
      APP_STL := gnustl_static
      APP_CPPFLAGS := -frtti -DCC_ENABLE_CHIPMUNK_INTEGRATION=1 -std=c++11 -fsigned-char
      APP_LDFLAGS := -latomic
      ifeq ($(NDK_DEBUG),1)
      APP_CPPFLAGS += -DCOCOS2D_DEBUG=1
      APP_OPTIM := debug
      else
      APP_CPPFLAGS += -DNDEBUG
      APP_OPTIM := release
      endif
    
    3. 复制youme_voice_engine/lib/android/youme_voice_engine.jar到proj.android/libs/ youme_voice_engine.jar。
    
    4. 修改proj.android/AndroidManifest.xml文件,确保声明了如下的权限:
    
    
    5. 打开eclipse,导入上一步Android工程,在项目的第一个启动的AppActivity(找到AppActivity.java文件)中导入package:
    

    import com.youme.voiceengine.mgr.YouMeManager; import com.youme.voiceengine.*;

    然后在onCreate方法里添加如下代码(没有此方法的话需要自己补上):
    

    @Override public void onCreate(Bundle savedInstanceState) { //以下两个函数调用顺序不能错 YouMeManager.Init(this); super.onCreate(savedInstanceState); }

iOS系统XCode开发环境配置

添加头文件和依赖库:

  1. 添加头文件路径:在Build Settings -> Search Paths -> Header Search Paths中添加../youme_voice_engine/include (建议直接将此include文件夹拖到xcode需要填入的位置,然后路径会自动生成);
  2. 添加库文件路径:在Build Settings -> Search Paths -> Library Search Paths中添加../youme_voice_engine/lib/ios (建议直接将此ios文件夹拖到xcode需要填入的位置,然后路径会自动生成);
  3. 添加依赖库:在Build Phases -> Link Binary With Libraries下添加:libc++.tbdlibsqlite3.0.tbdlibYouMeCommon.alibyoume_voice_engine.alibz.dyliblibz.1.2.5.tbdlibresolv.9.tbdSystemConfiguration.frameworkCoreTelephony.frameworkAVFoundation.frameworkAudioToolBox.frameworkCFNetwork.framework
  4. 为iOS10以上版本添加录音权限配置 iOS10系统使用录音权限,需要在target的info.plist中新加NSMicrophoneUsageDescription键,值为字符串(授权弹窗出现时提示给用户)。首次录音时会向用户申请权限。配置方式如下: iOS10录音权限配置

API接口调用流程

API调用的基本流程如下图所示,具体接口说明参见API接口手册。

接口调用基本流程

实现回调(参考api手册里面的实现回调) -> 初始化(init)->收到初始化成功回调通知 0(0表示sdk初始化成功)->加入语音单频道(joinChannelSingleMode )->收到加入频道成功回调通知 2(2表示进入语音频道成功)->打开麦克风(setMicrophoneMute (false))->收到麦克风已打开回调通知 29(29表示自己麦克风被打开)->打开扬声器(setSpeakerMute (false))->收到扬声器已打开回调通知 31(31表示自己扬声器被打开) ->设置音量(setVolume (70)(该音量建议70))->(到了前面一步已经可以和当前进入同一频道的人进行实时通话了)->使用其他接口 ->结束

以上回调事件通知状态码更多详细请查看对应的状态码