游密音视频引擎SDK接口调用都会立即返回,凡是本身需要较长耗时的接口调用都会采用异步回调的方式,所有接口都可以在主线程中直接使用。回调都在子线程中进行，请注意不要在回调中直接操作UI主线程。
API的调用可使用“[YMVoiceService getInstance]”来直接操作，接口使用的基本流程为初始化->收到初始化成功回调通知->加入语音频道->收到加入频道成功回调通知->使用其它接口->离开语音频道->反初始化，要确保严格按照上述的顺序使用接口。
在收到YOUME_EVENT_JOIN_OK事件后，
开关麦克风：[[YMVoiceService getInstance] setMicrophoneMute:false];
开关扬声器：[[YMVoiceService getInstance] setSpeakerMute:false];
控制自己的摄像头打开：[[YMVoiceService getInstance] startCapture];
控制自己的摄像头关闭：[[YMVoiceService getInstance] stopCapture];
[[YMVoiceService getInstance ] createRender:local_userid parentView:parentView];开启摄像头之后会渲染到返回的NSView里。YOUME_EVENT_OTHERS_VIDEO_ON 事件，在该事件里创建视频渲染组件[[YMVoiceService getInstance ] createRender:other_userid parentView:parentView];。
远端视频会渲染在返回的NSView里，同时会在以下事件里收到对应的视频数据回调，不过可以不做处理：// 软解
- (void)onVideoFrameCallback: (NSString*)userId data:(void*) data len:(int)len width:(int)width height:(int)height fmt:(int)fmt timestamp:(uint64_t)timestamp;
// 硬解
- (void)onVideoFrameCallbackForGLES:(NSString*)userId pixelBuffer:(CVPixelBufferRef)pixelBuffer timestamp:(uint64_t)timestamp;[[YMVoiceService getInstance] maskVideoByUserId:(NSString*) userId mask:(bool) mask];[[YMVoiceService getInstance] switchCamera];[[YMVoiceService getInstance] deleteRender:userid];使用者要遵守协议VoiceEngineCallback并实现相关函数（回调函数）。回调都在子线程中执行，不能用于更新UI等耗时操作。
首先要遵守协议VoiceEngineCallback来注册回调事件。
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param {
switch (eventType)
{
//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_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:
//麦克风的语音级别，值把iErrorCode转为整形即是音量值
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;
default:
//"事件类型" + eventType + ",错误码" +errcode
break;
}
}
//RestAPI回调
- (void)onRequestRestAPI: (int)requestID iErrorCode:(YouMeErrorCode_t) iErrorCode query:(NSString*) strQuery result:(NSString*) strResult {
}
//获取频道用户列表回调
- (void)onMemberChange:(NSString*) channelID changeList:(NSArray*) changeList {
NSLog(@"isUpdate:%d", isUpdate);
NSInteger count = [changeList count];
NSLog(@"MemberChagne:%@, count:%ld",channelID, count );
for( int i = 0 ; i < count ;i++ ){
MemberChangeOC* change = [changeList objectAtIndex:i ];
if( change.isJoin == 1 ){
NSLog(@"%@ 进入", change.userID);
}else{
NSLog(@"%@ 离开了", change.userID );
}
}
}
//SDK内置连麦抢麦接口对应的回调
- (void)onBroadcast:(YouMeBroadcast_t)bc strChannelID:(NSString*)channelID strParam1:(NSString*)param1 strParam2:(NSString*)param2 strContent:(NSString*)content{
}
//音视频通话码率、丢包率回调
- (void) onAVStatistic:(YouMeAVStatisticType_t)type userID:(NSString*)userID value:(int) value {
}- (void) setLogLevel:(YOUME_LOG_LEVEL_t) level;功能
设置日志等级。
level：日志等级。小于等于该等级的日志会打印。- (YouMeErrorCode_t)setUserLogPath:(NSString *)path;功能
设置用户自定义Log路径。
参数说明
path:Log文件的路径。
- (YouMeErrorCode_t)setTCPMode:(bool)bUseTcp;功能
设置是否使用TCP模式来收发数据，针对特殊网络没有UDP端口使用，必须在加入房间之前调用。
参数说明
bUseTcp:是否使用。
语法
-(YouMeErrorCode_t)initSDK:(id<VoiceEngineCallback>)delegate appkey:(NSString*)appKey appSecret:(NSString*)appSecret
regionId:(YOUME_RTC_SERVER_REGION_t)regionId
serverRegionName:(NSString*) serverRegionName;功能
初始化语音引擎，做APP验证和资源初始化。
参数说明
delegate：实现了回调函数的委托对象。
appKey：从游密申请到的 app key, 这个你们应用程序的唯一标识。
appSecret：对应 appKey 的私钥, 这个需要妥善保存，不要暴露给其他人。
regionId：设置首选连接服务器的区域码，如果在初始化时不能确定区域，可以填RTC_DEFAULT_SERVER，后面确定时通过 setServerRegion 设置。如果YOUME_RTC_SERVER_REGION定义的区域码不能满足要求，可以把这个参数设为 RTC_EXT_SERVER，然后通过后面的参数serverRegionName 设置一个自定的区域值（如中国用 "cn" 或者 “ch"表示），然后把这个自定义的区域值同步给游密，我们将通过后台配置映射到最佳区域的服务器。
serverRegionName：自定义的扩展的服务器区域名。不能为null，可为空字符串“”。只有前一个参数serverRegionId设为RTC_EXT_SERVER时，此参数才有效（否则都将当空字符串“”处理）。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 涉及到的主要回调事件有：
// YOUME_EVENT_INIT_OK - 表明初始化成功
// YOUME_EVENT_INIT_FAILED - 表明初始化失败，最常见的失败原因是网络错误或者 AppKey-AppSecret 错误
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(bool) isInited;功能
判断是否初始化完成。
语法
-(YouMeErrorCode_t) joinChannelSingleMode:(NSString *)strUserID channelID:(NSString *)strChannelID userRole:(YouMeUserRole_t)userRole autoRecv:(bool)autoRecv;功能
加入语音频道（单频道模式，每个时刻只能在一个语音频道里面），多次调用，会进入最后调用指定的频道。
参数说明
strUserID：全局唯一的用户标识，全局指在当前应用程序的范围内。
strChannelID：全局唯一的频道标识，全局指在当前应用程序的范围内。
userRole：用户在语音频道里面的角色，见YouMeUserRole定义。
autoRecv：进入房间后是否自动接收视频, 为 true 时自动接收，为 false 时，需要调用 setUsersVideoInfo 后才会接收对方的视频流。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 涉及到的主要回调事件有：
// YOUME_EVENT_JOIN_OK - 成功进入语音频道
// YOUME_EVENT_JOIN_FAILED - 进入语音频道失败，可能原因是网络或服务器有问题，或是bCheckRoomExist为true时频道还未创建
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t) joinChannelMultiMode:(NSString *)strUserID channelID:(NSString *)strChannelID userRole:(YouMeUserRole_t)userRole;功能
加入语音频道（多频道模式，可以同时听多个语音频道的内容，但每个时刻只能对着一个频道讲话）。
参数说明
strUserID：全局唯一的用户标识，全局指在当前应用程序的范围内。
strChannelID：全局唯一的频道标识，全局指在当前应用程序的范围内。
userRole：用户在语音频道里面的角色，见YouMeUserRole定义。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 涉及到的主要回调事件有：
// YOUME_EVENT_JOIN_OK - 成功进入语音频道
// YOUME_EVENT_JOIN_FAILED - 进入语音频道失败，可能原因是网络或服务器有问题，或是bCheckRoomExist为true时频道还未创建
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t) speakToChannel:(NSString *)strChannelID;功能
多频道模式下，指定当前要讲话的频道。
参数说明
strChannelID：全局唯一的频道标识，全局指在当前应用程序的范围内。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 涉及到的主要回调事件有：
// YOUME_EVENT_SPEAK_SUCCESS - 成功切入到指定语音频道
// YOUME_EVENT_SPEAK_FAILED - 切入指定语音频道失败，可能原因是网络或服务器有问题
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;-(YouMeErrorCode_t)leaveChannelMultiMode:(NSString *)strChannelID;功能
多频道模式下，退出指定的语音频道。
参数说明
strChannelID：全局唯一的频道标识，全局指在当前应用程序的范围内。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
//涉及到的主要回调事件有：
//YOUME_EVENT_LEAVED_ONE - 成功退出指定语音频道
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t)leaveChannelAll;功能
退出所有的语音频道（单频道模式下直接调用此函数离开频道即可）。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
//涉及到的主要回调事件有：
//YOUME_EVENT_LEAVED_ALL - 成功退出所有语音频道
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t)setUserRole:(YouMeUserRole_t)eUserRole;功能
切换身份(仅支持单频道模式，进入房间以后设置)。
参数说明
eUserRole：用户身份。
语法
-(YouMeUserRole_t) getUserRole;功能
获取身份(仅支持单频道模式)。
语法
-(bool) isInChannel:(NSString*) strChannelID;功能
查询是否在某个语音频道内。
语法
-(bool) isInChannel;功能
查询是否在语音频道内。
语法
-(YouMeErrorCode_t) setWhiteUserList:(NSString*) channelID whiteUserList:(NSString*) whiteUserList;功能
设置当前用户的语音消息接收白名单，其语音消息只会转发到白名单的用户，不设置该接口则默认转发至频道内所有人。
参数说明
strChannelID：要设置的频道(兼容多频道模式，单频道模式下传入当前频道即可)。
strWhiteUserList：白名单用户列表, 以|分隔，如：User1|User2|User3；"all"表示转发至频道内所有人；设置为自己表示不转发至任何用户。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 涉及到的主要回调事件有：
//YOUME_EVENT_SET_WHITE_USER_LIST_OK - 成功在指定语音频道设置白名单，有异常用户会返回错误码YOUME_ERROR_WHITE_SOMEUSER_ABNORMAL
//YOUME_EVENT_SET_WHITE_USER_LIST_FAILED - 在指定语音频道设置白名单失败，可能原因是网络或服务器有问题
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;-(void)setSpeakerMute:(bool)mute;功能
打开/关闭扬声器。该状态值在加入房间成功后设置才有效。
mute:true——关闭扬声器，false——开启扬声器。语法
(bool)getSpeakerMute;功能
获取当前扬声器状态。
语法
-(void)setMicrophoneMute:(bool)mute;功能
打开／关闭麦克风。该状态值在加入房间成功后设置才有效。
mute:true——关闭麦克风，false——开启麦克风。语法
(bool)getMicrophoneMute;功能
获取当前麦克风状态。
语法
-(void)setAutoSendStatus:(bool)bAutoSend;语法
-(void)setVolume:(unsigned int)uiVolume;功能
设置当前程序输出音量大小。建议该状态值在加入房间成功后按需再重置一次。
uiVolume:当前音量大小，范围[0-100]。语法
(unsigned int)getVolume;功能
获取当前程序输出音量大小，此音量值为程序内部的音量，与系统音量相乘得到程序使用的实际音量。
语法
-(void)setUseMobileNetworkEnabled:(bool)bEnabled;功能
设置是否允许使用移动网络。在WIFI和移动网络都可用的情况下会优先使用WIFI，在没有WIFI的情况下，如果设置允许使用移动网络，那么会使用移动网络进行语音通信，否则通信会失败。该接口需要在初始化后，加入房间前设置。
bEnabled:true——允许使用移动网络，false——禁止使用移动网络。语法
(bool) getUseMobileNetworkEnabled;功能
获取是否允许SDK在没有WIFI的情况使用移动网络进行语音通信。
语法
-(void) setOtherMicMute:(NSString *)strUserID mute:(bool) mute;功能
控制他人的麦克风状态。
参数说明
strUserID：要控制的用户ID。
mute：是否静音。true:静音别人的麦克风，false：开启别人的麦克风。
语法
-(void) setOtherSpeakerMute: (NSString *)strUserID mute:(bool) mute;功能
控制他人的扬声器状态。
参数说明
strUserID：要控制的用户ID。
mute：是否静音。true:静音别人的扬声器，false：开启别人的扬声器。
语法
-(void) setListenOtherVoice: (NSString *)strUserID isOn:(bool) isOn;功能
设置是否听某人的语音。
参数说明
strUserID：要控制的用户ID。
on：true表示开启接收指定用户的语音，false表示屏蔽指定用户的语音。
语法
-(YouMeErrorCode_t) setReleaseMicWhenMute:(bool) enabled;功能
设置当麦克风静音时，是否释放麦克风设备（需要在初始化成功后，加入房间之前调用）。
参数说明
enabled： true--当麦克风静音时，释放麦克风设备，此时允许第三方模块使用麦克风设备录音。在Android上，语音通过媒体音轨，而不是通话音轨输出；false--不管麦克风是否静音，麦克风设备都会被占用。
语法
-(YouMeErrorCode_t) setExitCommModeWhenHeadsetPlugin:(bool) enabled;功能
设置插入耳机时，是否自动退出系统通话模式(禁用手机硬件提供的回声消除等信号前处理)。
系统提供的前处理效果包括回声消除、自动增益等，有助于抑制战歌等回声噪音，减少系统资源消耗。
由于插入耳机可从物理上阻断回声产生，故可设置禁用该效果以保留战歌的原生音质效果。
注：Windows和macOS不支持该接口。
参数说明
enabled： true--当插入耳机时，自动禁用系统硬件信号前处理，拔出时还原；false--插拔耳机不做处理。
语法
-(YouMeErrorCode_t)pauseChannel;功能
暂停通话，释放对麦克风等设备资源的占用。当需要用第三方模块临时录音时，可调用这个接口。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 主要回调事件：
// YOUME_EVENT_PAUSED - 暂停语音频道完成
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t)resumeChannel;功能
恢复通话，调用PauseChannel暂停通话后，可调用这个接口恢复通话。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 主要回调事件：
// YOUME_EVENT_RESUMED - 恢复语音频道完成
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t)setVadCallbackEnabled:(bool)enabled功能
设置是否开启语音检测回调，开启后频道内有人正在讲话与结束讲话都会发起相应回调通知。该状态值在加入房间成功后设置才有效。
参数说明
enabled:true——打开，false——关闭。
语法
-(YouMeErrorCode_t) setMicLevelCallback:(int) maxLevel;功能
设置是否开启讲话音量级别回调, 并设置相应的参数。
参数说明
maxLevel:音量最大时对应的级别，需大于1，最大可设100。根据实际需要设置小于100的值可以减少回调的次数（注意设置较高的值可能会产生大量回调，特别在Unity上会影响其它事件到达，一般建议不超过30）。比如你只在UI上呈现10级的音量变化，那就设10就可以了。设 0 表示关闭回调。
语法
-(YouMeErrorCode_t) setFarendVoiceLevelCallback:(int) maxLevel maxMixedLevel:(int)maxMixedLevel;功能
设置是否开启远端语音音量级别回调, 并设置相应的参数。
参数说明
maxLevel:音量最大时对应的级别，需大于1，最大可设100。比如你只在UI上呈现10级的音量变化，那就设10就可以了。设 0 表示关闭回调。
maxMixedLevel:所有用户音量混合后的最大时对应的级别，需大于1，最大可设100。比如你只在UI上呈现10级的音量变化，那就设10就可以了。设 0 表示关闭回调。
语法
-(YouMeErrorCode_t)playBackgroundMusic:(NSString *)path repeat:(bool)repeat;功能
播放指定的音乐文件。播放的音乐将会通过扬声器输出，并和语音混合后发送给接收方。这个功能适合于主播/指挥等使用。
参数说明
path：音乐文件的路径。
repeat：是否重复播放，true——重复播放，false——只播放一次就停止播放。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
// 主要回调事件：
// YOUME_EVENT_BGM_STOPPED - 通知战歌播放结束
// YOUME_EVENT_BGM_FAILED - 通知战歌播放失败
-(void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;语法
-(YouMeErrorCode_t)stopBackgroundMusic;功能
停止播放当前正在播放的战歌。
这是一个同步调用接口，函数返回时，音乐播放也就停止了。
- (YouMeErrorCode_t)pauseBackgroundMusic;功能
如果当前正在播放战歌的话，暂停播放。
- (YouMeErrorCode_t)resumeBackgroundMusic;功能
如果当前正在播放战歌的话，恢复播放。
- (bool) isBackgroundMusicPlaying;功能
是否在播放战歌。
语法
-(YouMeErrorCode_t)setBackgroundMusicVolume:(unsigned int)bgVolume;功能
设定战歌的音量。这个接口用于调整战歌和语音之间的相对音量，使得战歌和语音混合听起来协调。
这是一个同步调用接口。
参数说明
bgVolume:战歌的音量，范围 [0-100]。
语法
-(YouMeErrorCode_t)setHeadsetMonitorMicOn:(bool)micEnabled BgmOn:(bool)bgmEnabled;功能
设置是否用耳机监听自己的声音，当不插耳机或外部输入模式时，这个设置不起作用。
这是一个同步调用接口。
参数说明
micEnabled:是否监听麦克风 true 监听，false 不监听。
bgmEnabled:是否监听战歌 true 监听，false 不监听。
语法
-(YouMeErrorCode_t)setReverbEnabled:(bool)enabled;功能
设置是否开启混响音效，这个主要对主播/指挥有用。
参数说明
enabled:true——打开，false——关闭。
语法
-(void) setRecordingTimeMs:(unsigned int)timeMs;功能
设置当前录音的时间戳。当通过录游戏脚本进行直播时，要保证观众端音画同步，在主播端需要进行时间对齐。
这个接口设置的就是当前游戏画面录制已经进行到哪个时间点了。
参数说明
timeMs:当前游戏画面对应的时间点，单位为毫秒。
语法
-(void) setPlayingTimeMs:(unsigned int)timeMs;功能
设置当前声音播放的时间戳。当通过录游戏脚本进行直播时，要保证观众端音画同步，游戏画面的播放需要和声音播放进行时间对齐。
这个接口设置的就是当前游戏画面播放已经进行到哪个时间点了。
参数说明
timeMs:当前游戏画面播放对应的时间点，单位为毫秒。
语法
-(void)setServerRegion:(YOUME_RTC_SERVER_REGION_OC)serverRegionId regionName:(NSString*)regionName bAppend:(bool)bAppend;功能
设置首选连接服务器的区域码.
serverRegionId：如果YOUME_RTC_SERVER_REGION定义的区域码不能满足要求，可以把这个参数设为 RTC_EXT_SERVER，然后通过后面的参数regionName 设置一个自定的区域值（如中国用 "cn" 或者 “ch"表示），然后把这个自定义的区域值同步给游密，我们将通过后台配置映射到最佳区域的服务器。regionName：自定义的扩展的服务器区域名。不能为null，可为空字符串“”。只有前一个参数serverRegionId设为RTC_EXT_SERVER时，此参数才有效（否则都将当空字符串“”处理）。bAppend：true表示添加，false表示替换。语法
-(YouMeErrorCode_t) getChannelUserList:(NSString*) channelID maxCount:(int)maxCount notifyMemChange:(bool)notifyMemChange ;功能
查询频道当前的用户列表， 并设置是否获取频道用户进出的通知。（必须自己在频道中）
参数说明
channelID：要查询的频道ID。
maxCount：想要获取的最大人数。-1表示获取全部列表。
notifyMemChange：其他用户进出房间时，是否要收到通知。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
异步回调
// channelID:频道ID
// changeList:查询获得的用户列表，或变更列表。
-(void)onMemberChange:(NSString*) channelID changeList:(NSArray*) changeList {
}- (YouMeErrorCode_t) setGrabMicOption:(NSString*) channelID mode:(int)mode maxAllowCount:(int)maxAllowCount maxTalkTime:(int)maxTalkTime voteTime:(unsigned int)voteTime;功能
抢麦相关设置（抢麦活动发起前调用此接口进行设置）。
参数说明
pChannelID：抢麦活动的频道id。
mode：抢麦模式（1:先到先得模式；2:按权重分配模式）。先到先得模式中，抢麦活动会持续，用户可以继续抢其他用户释放的麦。
maxAllowCount：允许能抢到麦的最大人数（要大于0）。
maxTalkTime：允许抢到麦后使用麦的最大时间（单位：秒，要大于0）。
voteTime：抢麦仲裁时间（单位：秒，要大于0），过了X秒后服务器将进行仲裁谁最终获得麦（仅在按权重分配模式下有效）。
- (YouMeErrorCode_t) startGrabMicAction:(NSString*) channelID strContent:(NSString*) pContent;功能
发起抢麦活动。接口需要加入房间后再调用。
参数说明
pChannelID：抢麦活动的频道id。
pContent：游戏传入的上下文内容，通知回调会传回此内容（目前只支持纯文本格式）。
- (YouMeErrorCode_t) stopGrabMicAction:(NSString*) channelID strContent:(NSString*) pContent;功能
停止抢麦活动。先到先得模式下，抢麦成功后，调用停止抢麦不会把当前抢麦人踢下麦。
参数说明
pChannelID：抢麦活动的频道id。
pContent：游戏传入的上下文内容，通知回调会传回此内容（目前只支持纯文本格式）。
- (YouMeErrorCode_t) requestGrabMic:(NSString*) channelID score:(int)score isAutoOpenMic:(bool)isAutoOpenMic strContent:(NSString*) pContent;功能
发起抢麦请求。
参数说明
pChannelID：抢麦的频道id。
score：积分（权重分配模式下有效，游戏根据自己实际情况设置）。
isAutoOpenMic：抢麦成功后是否自动开启麦克风权限。
pContent：游戏传入的上下文内容，通知回调会传回此内容（目前只支持纯文本格式）。
- (YouMeErrorCode_t) releaseGrabMic:(NSString*) channelID;功能
释放抢到的麦。
参数说明
pChannelID：抢麦的频道id。
- (YouMeErrorCode_t) setInviteMicOption:(NSString*) channelID waitTimeout:(int)waitTimeout maxTalkTime:(int)maxTalkTime;功能
连麦相关设置（角色是频道的管理者或者主播时调用此接口进行频道内的连麦设置）。
参数说明
pChannelID：连麦的频道id。
waitTimeout：等待对方响应超时时间（秒）。
maxTalkTime：最大通话时间（秒）。
- (YouMeErrorCode_t) requestInviteMic:(NSString*) channelID strUserID:(NSString*)pUserID strContent:(NSString*) pContent;功能
发起与某人的连麦请求（主动呼叫）。支持跨频道发起连麦。
参数说明
pUserID：被叫方的用户id。
pContent：游戏传入的上下文内容，通知回调会传回此内容（目前只支持纯文本格式）。
- (YouMeErrorCode_t) responseInviteMic:(NSString*) pUserID isAccept:(bool)isAccept strContent:(NSString*) pContent;功能
对连麦请求做出回应（被动应答）。
参数说明
pUserID：主叫方的用户id。
isAccept：是否同意连麦。
pContent：游戏传入的上下文内容，通知回调会传回此内容（目前只支持纯文本格式）。
- (YouMeErrorCode_t) stopInviteMic;功能
停止连麦。
- (YouMeErrorCode_t) sendMessage:(NSString*) channelID strContent:(NSString*) strContent requestID:(int*) requestID;功能
在语音频道内，广播一个文本消息。
参数说明
pChannelID：频道ID（自己需要进入这个频道）。
pContent：要广播的文本内容。
requestID：用于标识消息的ID。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
//VoiceEngineCallback
//event:YOUME_EVENT_SEND_MESSAGE_RESULT: 发送消息的结果回调，param为requestID的字符串
//event:YOUME_EVENT_MESSAGE_NOTIFY:频道内其他人收到消息的通知。param为文本内容
- (void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;- (YouMeErrorCode_t) kickOtherFromChannel:(NSString*) userID channelID:(NSString*)channelID lastTime:(int) lastTime;功能
把人踢出房间。
参数说明
userID：被踢的用户ID。
channelID：从哪个房间踢出（自己需要在房间）。
lastTime：踢出后，多长时间内不允许再次进入。
返回值
返回YOUME_SUCCESS才会有异步回调通知。其它返回值请参考YouMeErrorCode类型定义。
//VoiceEngineCallback
//event:YOUME_EVENT_KICK_RESULT: 踢人方收到，发送消息的结果回调，param为被踢者ID
//event:YOUME_EVENT_KICK_NOTIFY: 被踢方收到，被踢通知，会自动退出所在频道。param: （踢人者ID，被踢原因，被禁时间）
- (void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;- (YouMeErrorCode_t)startCapture;返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (YouMeErrorCode_t)stopCapture;返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (int) getCameraCount;返回值
int - 数目，摄像头id为0-count。
- (NSString*) getCameraName:(int)cameraId;返回值
成功:非空name 失败:空字符串。
- (YouMeErrorCode_t) setOpenCameraId:(int)cameraId;返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (int) getRecordDeviceCount;功能
获取macos平台，audio采集设备数量。
- (boolean_t) getRecordDeviceInfo:(int)index deviceName:(NSString**)deviceName deviceUId:(NSString**)deviceUId;功能
获取macos平台 record设备 对应信息。
参数说明
index:列表中的位置。
deviceName:设备名称。
deviceUid:设备唯一ID，用于设置设备。
- (YouMeErrorCode_t) setRecordDevice:(NSString*) deviceUId;功能
设置macos平台打开record设备id。
参数说明
deviceUId: record设备的Uid。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (int)setLocalVideoPreviewMirror:(bool) enable;enable: 预览是否开启镜像功能。- (YouMeErrorCode_t)setVideoFps:(int)fps;参数说明
fps: 帧率（3-30），默认15帧。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (YouMeErrorCode_t)setVideoLocalResolutionWidth:(int)width height:(int)height;参数说明
width: 宽。
height: 高。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
设置视频网络传输过程的分辨率（第一路高分辨率）。 接受方收到视频回调的分辨率，等于发送方设置的网络分辨率。
- (YouMeErrorCode_t)setVideoNetResolutionWidth:(int)width height:(int)height;参数说明
width: 宽。
height: 高。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
进房间前设置。
- (void) setVideoCodeBitrate:(unsigned int) maxBitrate minBitrate:(unsigned int ) minBitrate;参数说明
maxBitrate: 最大码率，单位kbps。
minBitrate: 最小码率，单位kbps。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
设置视频编码是否采用VBR动态码率方式。 需要在进入房间前设置。
- (YouMeErrorCode_t) setVBR:( bool) useVBR;参数说明
useVBR: 默认为false，true表示使用VBR模式，允许码率在约1.5倍范围内波动。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
设置小流视频编码是否采用VBR动态码率方式。 需要在进入房间前设置。
- (YouMeErrorCode_t) setVBRForSecond:( bool) useVBR;参数说明
useVBR: 默认为false，true表示使用VBR模式，允许码率在约1.5倍范围内波动。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
进房间前设置。
- (YouMeErrorCode_t)setVideoNetAdjustmode:(int)mode;参数说明
mode: 模式 0:自动调整，1:手动调整。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
进房间前设置或进房间后动态设置。
- (YouMeErrorCode_t)setVideoSmooth:(int)enable;参数说明
enable: 开关 0:关闭平滑，1:打开平滑。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (unsigned int) getCurrentVideoCodeBitrate;返回值
视频数据上行的当前码率。
- (void) setAVStatisticInterval:(int) interval ;功能
设置音视频统计数据时间间隔, 按间隔回调 "onAVStatistic"。
参数说明
interval: 时间间隔，单位毫秒。
实际是否开启硬解，还跟服务器配置及硬件是否支持有关，要全部支持开启才会使用硬解。并且如果硬编硬解失败，也会切换回软解。 进房间前设置。
- (void) setVideoHardwareCodeEnable:(bool) bEnable;bEnable: true:开启，false:不开启。实际是否开启硬解，还跟服务器配置及硬件是否支持有关，要全部支持开启才会使用硬解。并且如果硬编硬解失败，也会切换回软解。 进房间前设置。
- (bool) getVideoHardwareCodeEnable;设置无视频帧渲染的等待超时时间。连接中的视频，超过设置的timeout时间没有收到数据，会得到YOUME_EVENT_OTHERS_VIDEO_SHUT_DOWN通知。
- (void) setVideoNoFrameTimeout:(int) timeout;timeout: 单位毫秒。-(NSView*) createRender:(NSString*) userId parentView:(NSView*)parentView;
参数说明
userId: userId 用户ID。
parentView: 渲染父视图。
返回值
@return 返回渲染视图OpenGLESView对象。
视频数据回调。-(void) deleteRender:(NSString*) userId;
-(void) cleanRender:(NSString*) userId;userId: 用户ID。-(void) deleteAllRender;- (int)setRenderMode:(NSString*)userId mode:(YouMeVideoRenderMode_t) mode;userId: 用户ID。mode: YouMeVideoRenderMode枚举类型。OpenGLESView
//显示视频数据到View
- (void)displayYUV420pData:(void *)data width:(NSInteger)w height:(NSInteger)h;
//显示视频数据到View
- (void)displayPixelBuffer:(CVPixelBufferRef)pixelBuffer;
//设置渲染的背景色
- (void)setRenderBackgroudColor:(UIColor*) color;
//清除画面，清除后显示背景色
- (void)clearFrame;//protocol VoiceEngineCallback
- (void)onVideoFrameCallback: (NSString*)userId data:(void*) data len:(int)len width:(int)width height:(int)height fmt:(int)fmt timestamp:(uint64_t)timestamp;参数说明
userId: 远端视频数据对应的userId。
data: 视频数据。
len: 数据长度。
width: 视频宽。
height: 视频高。
fmt: 视频数据格式，参见YOUME_VIDEO_FMT。
timestamp: 时间戳。
//protocol VoiceEngineCallback
- (void)onVideoFrameCallbackForGLES:(NSString*)userId pixelBuffer:(CVPixelBufferRef)pixelBuffer timestamp:(uint64_t)timestamp;参数说明
userId: 远端视频数据对应的userId。
pixelBuffer: 视频数据。
timestamp: 时间戳。
//protocol VoiceEngineCallback
- (void)onVideoFrameMixedCallback: (void*) data len:(int)len width:(int)width height:(int)height fmt:(int)fmt timestamp:(uint64_t)timestamp;参数说明
data: 视频数据。
len: 数据长度。
width: 视频宽。
height: 视频高。
fmt: 视频数据格式，参见YOUME_VIDEO_FMT。
timestamp: 时间戳。
//protocol VoiceEngineCallback
- (void)onVideoFrameMixedCallbackForGLES:(CVPixelBufferRef)pixelBuffer timestamp:(uint64_t)timestamp;参数说明
pixelBuffer: 视频数据。
timestamp: 时间戳。
//protocol VoiceEngineCallback
- (void)onAudioFrameCallback: (NSString*)userId data:(void*) data len:(int)len timestamp:(uint64_t)timestamp;
参数说明
userId: userID。
data: 视频帧数据。
Len: 视频数据大小。
timestamp: 时间戳，毫秒。
//protocol VoiceEngineCallback
- (void)onAudioFrameMixedCallback: (void*)data len:(int)len timestamp:(uint64_t)timestamp;
参数说明
data: 视频帧数据。
Len: 视频数据大小。
timestamp: 时间戳，毫秒。
SDK支持向服务器上传品质不同的两路流（不同的分辨率和码率），观看方根据自己的情况，设置拉取不同的流。 默认不上传第二路流。
设置视频上传第二路流的网络传输过程的分辨率。 接受方收到视频回调的分辨率，等于发送方设置的网络分辨率。 默认不传第二路流。如果设置了第二路流的分辨率，则会上传。
- (YouMeErrorCode_t)setVideoNetResolutionForSecond:(int)width height:(int)height;参数说明
width: 宽。
height: 高。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码
设置第二路流的上行码率范围。 进房间前设置。
- (void) setVideoCodeBitrateForSecond:(unsigned int) maxBitrate minBitrate:(unsigned int ) minBitrate;参数说明
maxBitrate: 最大码率，单位kbps。
minBitrate: 最小码率，单位kbps。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码
查询多个用户支持哪种流。
- (YouMeErrorCode_t) queryUsersVideoInfo:(NSMutableArray*)userArray;参数说明
userArray: 用户ID列表。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
//eventType:YOUME_EVENT_QUERY_USERS_VIDEO_INFO
- (void)onYouMeEvent:(YouMeEvent_t)eventType errcode:(YouMeErrorCode_t)iErrorCode roomid:(NSString *)roomid param:(NSString *)param;设置观看用户的哪一路流。如果设置了不支持的流，则采用默认的第一路流。
- (YouMeErrorCode_t) setUsersVideoInfo:(NSMutableArray*)userArray resolutionArray:(NSMutableArray*)resolutionArray;参数说明
userArray: 用户ID列表。
resolutionArray: 用户对应分辨率列表(每一项为"0"-第一路流/"1"-第二路流)。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
默认使用内部采集。 如果使用外部采集，需要自己采集音视频，然后把数据传入SDK。 在Init之前调用。
- (void)setExternalInputMode:(bool)bInputModeEnabled;参数说明
bInputModeEnabled: true:外部输入模式，false:SDK内部采集模式。
- (YouMeErrorCode_t) setExternalInputSampleRate:(YOUME_SAMPLE_RATE_t)inputSampleRate mixedCallbackSampleRate:(YOUME_SAMPLE_RATE_t)mixedCallbackSampleRate;功能
设置外部输入模式的语音采样率。
参数说明
inputSampleRate:输入语音采样率。
mixedCallbackSampleRate:mix后输出语音采样率。
- (BOOL)inputAudioFrame:(void *)data Len:(int)len Timestamp:(uint64_t)timestamp;参数说明
data: 指向PCM数据的缓冲区。
len: 音频数据的大小。
timestamp: 时间戳，单位毫秒。
- (BOOL)inputAudioFrameEx:(void *)data Len:(int)len Timestamp:(uint64_t)timestamp ChannelNum:(int)channelnum bInterleaved:(bool)binterleaved;参数说明
data: 指向PCM数据的缓冲区。
len: 音频数据的大小。
timestamp: 时间戳，单位毫秒。
channelnum: 声道数，1:单声道，2:双声道，其它非法。
binterleaved: 音频数据打包格式（仅对双声道有效）。
视频数据输入(房间内其它用户会收到YOUME_EVENT_OTHERS_VIDEO_INPUT_START事件)。
- (BOOL)inputVideoFrame:(void *)data Len:(int)len Width:(int)width Height:(int)height Fmt:(int)fmt Rotation:(int)rotation Mirror:(int)mirror Timestamp:(uint64_t)timestamp;参数说明
data: 视频帧数据。
Len: 视频数据大小。
Width: 视频图像宽。
Height: 视频图像高。
Fmt: 视频格式。
Rotation: 视频旋转角度。
Mirror: 是否镜像。
Timestamp: 时间戳，单位毫秒。
视频数据输入(房间内其它用户会收到YOUME_EVENT_OTHERS_VIDEO_INPUT_START事件)。
- (BOOL)inputPixelBuffer:(CVPixelBufferRef)PixelBufferRef Width:(int)width Height:(int)height Fmt:(int)fmt Rotation:(int)rotation Mirror:(int)mirror Timestamp:(uint64_t)timestamp;参数说明
data: 视频帧数据。
Width: 视频图像宽。
Height: 视频图像高。
Fmt: 视频格式。
Rotation: 视频旋转角度。
Mirror: 是否镜像。
Timestamp: 时间戳，单位毫秒。
停止视频数据输入(在inputVideoFrame之后调用，房间内其它用户会收到YOUME_EVENT_OTHERS_VIDEO_INPUT_STOP事件)。
- (void)stopInputVideoFrame;把远端的视频和本地自己的视频合到一个画面，称为合流。本接口设置合流画面总的尺寸。
- (void)setMixVideoWidth:(int)width Height:(int)height;参数说明
width: 宽。
height: 高。
设置user的视频数据在合流画面中展现的位置和尺寸。
- (void)addMixOverlayVideoUserId:(NSString*)userId PosX:(int)x PosY:(int)y PosZ:(int)z Width:(int)width Height:(int)height;参数说明
userId: 宽。
PosX: x坐标。
PosY: y坐标。
PosZ: z坐标，影响视频的展示层级。
Width: 宽。
Height: 高。
取消对user的合流。
- (void)removeMixOverlayVideoUserId:(NSString*)userId;参数说明
userId: user ID。
取消对所有user的合流。
- (void)removeAllOverlayVideo;- (int)setLocalVideoMirrorMode:(YouMeVideoMirrorMode_t) mode;参数
mode:镜像模式，参见YouMeVideoMirrorMode类型。
- (YouMeErrorCode_t) openBeautify:(bool) open ;参数说明
open: true-开启美颜，false-关闭美颜。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (YouMeErrorCode_t) beautifyChanged:(float) param ;参数说明
param: 美颜参数，0.0 - 1.0 ，默认为0，几乎没有美颜效果，0.5左右效果明显。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
- (YouMeErrorCode_t) stretchFace:(bool) stretch ;参数说明
stretch: true 开启瘦脸，false关闭，默认 false。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
-(bool)setExternalFilterEnabled:(bool)enabled;参数说明
enabled: true 开启外部扩展滤镜回调，false关闭，默认 false。
//protocol VoiceEngineCallback
- (void)onCustomDataCallback: (const void*)data len:(int)len timestamp:(uint64_t)timestamp;参数说明
data: 视频帧数据。
timestamp: 时间戳，单位毫秒。
- (YouMeErrorCode_t) inputCustomData:(const void *)data Len:(int)len Timestamp:(uint64_t)timestamp;data: 自定义数据，要广播的自定义数据。len: 数据长度，不能大于1024。timestamp: 时间戳。- (YouMeErrorCode_t) maskVideoByUserId:(NSString*) strUserId mask:(bool) mask;参数说明
userId: 用户ID。
mask: true - 屏蔽, false - 恢复不屏蔽。
返回值
错误码，YOUME_SUCCESS - 表示成功,其他 - 具体错误码。
-(YouMeErrorCode_t) translateText:(unsigned int*) requestID text:(NSString*)text destLangCode:(YouMeLanguageCode_t)destLangCode srcLangCode:(YouMeLanguageCode_t)srcLangCode;功能
翻译一段文字为指定语言。
参数说明
requestID: 翻译请求的ID，传出参数，用于在回调中确定翻译结果是对应哪次请求。
text: 要翻译的内容。
destLangCode:要翻译成什么语言。
srcLangCode:要翻译的是什么语言。
返回值
如果成功则返回YOUME_SUCCESS，其它具体参见YouMeErrorCode类型定义。
//errorcode：错误码
//requestID：请求ID（与translateText接口输出参数requestID一致）
//text：翻译结果
//srcLangCode：源语言编码
//destLangCode：目标语言编码
- (void)onTranslateTextComplete:(YouMeErrorCode_t)errorcode requestID:(unsigned int)requestID text:(NSString*)text srcLangCode:(YouMeLanguageCode_t)srcLangCode destLangCode:(YouMeLanguageCode_t)destLangCode;语法
-(YouMeErrorCode_t)unInit;功能
反初始化引擎，可在退出游戏时调用，以释放SDK所有资源。
屏幕共享功能必须实在进入房间之后才可以打开，但是屏幕共享的参数设置可以在进入房间之前设置；屏幕共享和摄像头是分离的，可以单独打开视频共享。
注意：在一个房间内，同时只能有一个用户打开视频共享。
- (YouMeErrorCode_t)checkSharePermission;- (NSArray*) getWindowList;功能
获取当前窗口列表信息(包括窗口名称和窗口句柄)，主要用于在窗口共享模式下给用户选择窗口句柄并在共享视频参数设置接口设置给SDK。
参数说明
pWinOwner: 窗口owner列表。
pWinName: 窗口Name列表。
pWinId: 窗口id列表。
winCount: 获取到的窗口数量。
- (YouMeErrorCode_t)setShareExclusiveWnd:(int)windowid;功能
屏幕共享时，排除指定的窗口, 建议在开始共享前设置。
参数说明
windowid: 窗口句柄。屏幕共享时，将被排除。
-(void) enableShareBorder:(bool) bEnable;功能
共享屏幕或者共享窗口时，是否打开绘制边框的功能，在SDK初始化之后，开始共享前调用。
参数说明
bEnable: true,共享时绘制边框；false，共享时，不绘制边框。
- (YouMeErrorCode_t)startShare:(int) mode windowid:(int)windowid;功能
开始共享，并将(屏幕/窗口)共享视频流实时发送到房间内其他人。
参数说明
mode: 共享视频采集模式 1：采集设备 2：采集指定窗口 3：采集桌面。
windowid: 共享窗口时，传窗口句柄；共享屏幕时，传屏幕id（0 或者 1）。
- (void)stopShare;功能
停止共享，停止发送(屏幕/窗口)共享视频流。
参数说明
无。
- (YouMeErrorCode_t)startSaveScreen:(NSString*) filePath;功能
开始本地录制，将当前会议屏幕录制，存储在本地路径。
参数说明
filePath: 录像文件路径，目前只支持mp4格式。
- (void)stopSaveScreen;功能
停止本地录制。
参数说明
无。