本规范仅适用于使用游密实时音视频引擎(C++接口)开发多人实时语音功能的开发者。
语音SDK中有两个子文件夹:lib、include,下面依次介绍下这两个子文件夹。
include
:SDK的头文件。
详细介绍下inlude,所有接口都在这个文件夹中。
IYouMeVoiceEngine.h
封装了语音SDK的全部功能接口,集成方可通过IYouMeVoiceEngine::getInstance ()->…来调用语音SDK接口。IYouMeEventCallback.h
包含语音SDK的所有回调事件接口,例如初始化结果,频道加入成功等,都将通过此接口通知集成方。YouMeConstDefine.h
包含语音SDK的所有枚举类型定义,如错误码等。lib
:库文件。YOUME_EVENT_JOIN_OK
事件后,api.SetVideoCallback();
api.StartCapturer();
api.StopCapturer();
YOUME_EVENT_OTHERS_VIDEO_ON
事件,在该事件里绑定视频流和渲染组件
VideoRenderer.getInstance().addRender(String userId, SurfaceViewRenderer view);
。api.maskVideoByUserId()
api.SwitchCamera();
VideoRenderer.getInstance().deleteRender();
使用者要继承类IYouMeEventCallback并实现其纯虚函数(回调函数),在调用初始化函数时传入指向子类的指针。回调都在子线程中执行,不能用于更新UI等耗时操作。
首先声明一个类YouMeVoiceEngineImp(类名可自取)来注册回调事件:
class YouMeVoiceEngineImp : public IYouMeEventCallback
{
public:
static YouMeVoiceEngineImp *getInstance ();
virtual void onEvent(const YouMeEvent event, const YouMeErrorCode error, const char * channel, const char * param);
}
然后在该类YouMeVoiceEngineImp下必须实现以下方法:
//监听各类回调事件
void onEvent(const YouMeEvent event, const YouMeErrorCode error, const char * channel, const char * param)
{
switch (event)
{
//case案例只覆盖了部分,仅供参考,详情请查询枚举类型YouMeEvent
case YOUME_EVENT_INIT_OK:
//"初始化成功";
break;
case YOUME_EVENT_INIT_FAILED:
// "初始化失败,错误码:" + errorCode;
break;
case YOUME_EVENT_JOIN_OK:
//"加入频道成功";
break;
case YOUME_EVENT_LEAVED_ALL:
// "离开频道成功";
break;
case YOUME_EVENT_JOIN_FAILED:
//进入语音频道失败
break;
case YOUME_EVENT_REC_PERMISSION_STATUS:
// "通知录音权限状态,成功获取权限时错误码为YOUME_SUCCESS,获取失败为YOUME_ERROR_REC_NO_PERMISSION(此时不管麦克风mute状态如何,都没有声音输出)";
break;
case YOUME_EVENT_RECONNECTING:
//"断网了,正在重连";
break;
case YOUME_EVENT_RECONNECTED:
// "断网重连成功";
break;
case YOUME_EVENT_MEMBER_CHANGE:
//房间内成员列表变化
break;
case YOUME_EVENT_OTHERS_MIC_OFF:
//其他用户的麦克风关闭:
break;
case YOUME_EVENT_OTHERS_MIC_ON:
//其他用户的麦克风打开:
break;
case YOUME_EVENT_OTHERS_SPEAKER_ON:
//其他用户的扬声器打开:
break;
case YOUME_EVENT_OTHERS_SPEAKER_OFF:
//其他用户的扬声器关闭
break;
case YOUME_EVENT_OTHERS_VOICE_ON:
//其他用户开始讲话
break;
case YOUME_EVENT_OTHERS_VOICE_OFF:
//其他用户停止讲话
break;
case YOUME_EVENT_MY_MIC_LEVEL:
//麦克风的语音级别
break;
case YOUME_EVENT_MIC_CTR_ON:
//麦克风被其他用户打开
break;
case YOUME_EVENT_MIC_CTR_OFF:
//麦克风被其他用户关闭
break;
case YOUME_EVENT_SPEAKER_CTR_ON:
//扬声器被其他用户打开
break;
case YOUME_EVENT_SPEAKER_CTR_OFF:
//扬声器被其他用户关闭
break;
case YOUME_EVENT_LISTEN_OTHER_ON:
//取消屏蔽某人语音
break;
case YOUME_EVENT_LISTEN_OTHER_OFF:
//屏蔽某人语音
break;
//=====================视频相关=========================
case YOUME_EVENT_OTHERS_VIDEO_ON:
//其他用户视频流打开
//收到此事件即可以对该用户做视频渲染与显示操作
break;
case YOUME_EVENT_OTHERS_VIDEO_OFF:
//其他用户视频流断开
break;
case YOUME_EVENT_OTHERS_CAMERA_PAUSE:
//其他用户摄像头暂停
break;
case YOUME_EVENT_OTHERS_CAMERA_RESUME:
//其他用户摄像头恢复
break;
case YOUME_EVENT_MASK_VIDEO_BY_OTHER_USER:
//视频被其他用户屏蔽
break;
case YOUME_EVENT_RESUME_VIDEO_BY_OTHER_USER:
//视频被其他用户恢复
break;
case YOUME_EVENT_MASK_VIDEO_FOR_USER:
//屏蔽了谁的视频
break;
case YOUME_EVENT_RESUME_VIDEO_FOR_USER:
//恢复了谁的视频
break;
case YOUME_EVENT_OTHERS_VIDEO_SHUT_DOWN:
//其他用户视频断开
//包含以下情形:对方退出房间、对方网络不好、关闭了摄像头、屏蔽了对方的视频流
break;
case YOUME_EVENT_MEDIA_DATA_ROAD_PASS:
///音视频数据通路连通,定时检测,一开始收到数据会收到PASS事件,之后变化的时候会发送
break;
case YOUME_EVENT_MEDIA_DATA_ROAD_BLOCK:
///音视频数据通路不通
break;
case YOUME_EVENT_QUERY_USERS_VIDEO_INFO:
///查询用户视频信息返回
break;
case YOUME_EVENT_SET_USERS_VIDEO_INFO:
///设置用户接收视频信息返回
break;
default:
//"事件类型" + eventType + ",错误码" +
break;
}
}
YouMeErrorCode init(
const char* strAppKey,
const char* strAPPSecret,
YOUME_RTC_SERVER_REGION serverRegionId,
const char* strExtServerRegionName);
功能
初始化语音引擎,做APP验证和资源初始化。
参数说明
strAPPKey
:从游密申请到的 app key, 这个你们应用程序的唯一标识。
strAPPSecret
:对应 strAPPKey 的私钥, 这个需要妥善保存,不要暴露给其他人。
serverRegionId
:设置首选连接服务器的区域码,如果在初始化时不能确定区域,可以填RTC_DEFAULT_SERVER,后面确定时通过 SetServerRegion 设置。如果YOUME_RTC_SERVER_REGION定义的区域码不能满足要求,可以把这个参数设为 RTC_EXT_SERVER,然后通过后面的参数strExtServerRegionName 设置一个自定的区域值(如中国用 "cn" 或者 “ch"表示),然后把这个自定义的区域值同步给游密,我们将通过后台配置映射到最佳区域的服务器。
strExtServerRegionName
:自定义的扩展的服务器区域名。不能为null,可为空字符串“”。只有前一个参数serverRegionId设为RTC_EXT_SERVER时,此参数才有效(否则都将当空字符串“”处理)。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
//涉及到的主要回调事件有:
// YOUME_EVENT_INIT_OK - 表明初始化成功
// YOUME_EVENT_INIT_FAILED - 表明初始化失败,最常见的失败原因是网络错误或者 AppKey-AppSecret 错误
void onEvent (const char* strParam);
YouMeErrorCode joinChannelSingleMode (const char* strUserID, const char* strChannelID, int userRole);
功能
加入语音频道(单频道模式,每个时刻只能在一个语音频道里面)。
参数说明
strUserID
:全局唯一的用户标识,全局指在当前应用程序的范围内。
strChannelID
:全局唯一的频道标识,全局指在当前应用程序的范围内。
userRole
:用户在语音频道里面的角色,见YouMeUserRole定义。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
//涉及到的主要回调事件有:
//YOUME_EVENT_JOIN_OK - 成功进入语音频道
//YOUME_EVENT_JOIN_FAILED - 进入语音频道失败,可能原因是网络或服务器有问题
void onEvent (const char* strParam);
具体方法参见demo。
int createRender(const char * userId);
功能
根据用户ID创建渲染ID。
参数说明
userId
:用户ID。
YouMeErrorCode startCapture();
功能
捕获本机摄像头数据,以便发送给房间内其他人。