FYRtcEngineKit *engineKit = [FYRtcEngineKit
sharedEngineWithAppId:@"AppId" AppToken:@"AppToken" delegate:self];
参数 | 是否必须 | 描述 |
---|---|---|
appId | 是 | 应用id |
appToken | 是 | 应用token |
FYRtcEngineKitDelegate | 否 | 提供 FYRtcEngineKit所有事件回调 |
[engineKit joinChannel:@"channelId" CallerUid:nil OptionData:nil JoinSuccess:nil];
参数 | 是否必须 | 描述 |
---|---|---|
channelId | 是 | 频道id,字符串,数字,_,长度不超过40位 |
uid | 否 | 用户id,为空时sdk会生成一个uid |
option | 否 | 选项,可以配置最大时长,是否录音和透传数据 |
[engineKit leaveChannel:nil];
[engineKit muteRemoteAudio:enable Uid:@"uid"]
参数 | 是否必须 | 描述 |
---|---|---|
uid | 是 | 指定用户ID |
enable | 是 | YES :停止播放指定用户ID音频 NO:恢复播放指定用户ID音频 |
[engineKit muteAllRemoteAudio:enable]
参数 | 是否必须 | 描述 |
---|---|---|
enable | 是 | YES :停止播放频道内所有用户音频 NO:恢复播放频道内所有用户音频 |
[engineKit muteOtherRemoteAudio:enable Uid:@"uid"]
参数 | 是否必须 | 描述 |
---|---|---|
uid | 是 | 指定用户ID |
enable | 是 | YES :停止播放除指定用户ID以外所有音频 NO:恢复播放除指定用户ID以外音频 |
[engineKit dialPeer:@"calleeUid"CallerUid:@"callerUid" OptionData:nil];
参数 | 是否必须 | 描述 |
---|---|---|
calleeUid | 是 | 被叫用户ID,被叫方调用calleePrepare()传入的uid必须与主叫calleeUid相同,否则无法呼叫到被叫 |
callerUid | 否 | 用户ID,为空时sdk会生成一个uid |
option | 否 | 选项,可以配置最大时长,是否录音和透传数据 |
[engineKit calleePrepare:@"uid" prepareSuccess:nil];
参数 | 是否必须 | 描述 |
---|---|---|
uid | 是 | 用户ID,主叫方调用dialPeer()传入的uid必须与主叫calleeUid相同,否则被叫无法收到主叫呼入 |
例如:主叫拨打calleeUid为“test1”,那么被叫在调用calleePrepare时把“test1”作为uid传入,这样被叫上线成功之后,就可以接到主叫来电。
注:调用此方法成功后,用户uid会上线一分钟等待接收主叫来电。1分钟后将会下线,收不到来电消息。
[engineKit endCall:nil]
[engineKit answerCall]
[engineKit muteLocalAudio:enable]
参数 | 是否必须 | 描述 |
---|---|---|
enable | 是 | YES :麦克风静音 NO:取消静音 |
[engineKit enabledSpeaker:enable]
参数 | 是否必须 | 描述 |
---|---|---|
enable | 是 | YES :打开扬声器 NO:关闭扬声器 |
[engineKit sendDtmf:@"dtmf"]
参数 | 是否必须 | 描述 |
---|---|---|
dtmf | 是 | char类型字符,包含’0’,’1’,’2’,’3’,’4’,’5’,’6’,’7’,’8’,’9’,’#’,’*’ |
只有在接通电话之后才可以发送dtmf
[engineKit setRing:@"path"]
参数 | 是否必须 | 描述 |
---|---|---|
path | 是 | 音频文件路径。音频文件必须是wav格式,16位采样且长度不能超过30秒。 |
[engineKit setLogfile:@"path"]
参数 | 是否必须 | 描述 |
---|---|---|
path | 是 | log将输出到开发者指定目录 |
[engineKit version]
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine didJoinOfUid:(NSString *)uid
有用户加入当前频道。当用户加入频道时已经有人在频道中,sdk也会将这些已经在频道中的用户上报
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine didLeaveOfUid:(NSString *)uid
提示有用户离开当前频道
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine didAudioMuted:(BOOL)muted Uid:(NSString *)uid
参数 | 描述 |
---|---|
muted | YES :静音 NO:取消静音 |
提示有用户用户被静音/取消静音
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine reportRtcStats:(FYRtcEngineStatus *)status
参数 | 描述 |
---|---|
status | downBandwidth :下行带宽 upBandwidth:上行带宽 sendLossRate:发送丢包率 recvLossRate:接受丢包率 sendBytes:发送字节数(累计值) recvBytes:接受字节数(累计值) |
该回调定期上报音频相关统计数据,每两秒回调一次
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine didJoinChannel:(NSString *)channelId Uid:(NSString *)uid
参数 | 描述 |
---|---|
channelId | 已加入频道号 |
uid | 如果用户在joinChannel()指定了uid则此处返回该uid,否则sdk将生成一个uid |
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine didLeaveChannel:(NSString *)channelId Stats:(FYRtcEngineStatus *)status;
参数 | 描述 |
---|---|
channelId | 已离开的频道号 |
status | downBandwidth :下行带宽 upBandwidth:上行带宽 sendLossRate:发送丢包率 recvLossRate:接受丢包率 sendBytes:发送字节数(累计值) recvBytes:接受字节数(累计值) |
当用户调用leaveChannel()成功之后调用该回调。
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine OutgoingCall:(NSString *)callee Uid:(NSString *)uid
参数 | 描述 |
---|---|
uid | 用户id,当调用dialPeer()指定了uid则此处返回该uid |
callee | 被叫号码 |
sdk正在建立UDP连接的时候触发此回调
- (void)onFYRtcEngineCallConnect:(FYRtcEngineKit *)engine
被叫已经开始接听点到点语音
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine CallEnd:(FYRtcEngineStatus *)status
参数 | 描述 |
---|---|
status | downBandwidth :下行带宽 upBandwidth:上行带宽 sendLossRate:发送丢包率 recvLossRate:接受丢包率 sendBytes:发送字节数(累计值) recvBytes:接受字节数(累计值) |
主叫或者被叫挂断时触发此回调
- (void)onFYRtcEngineCalleePrepareSucess:(FYRtcEngineKit *)engine
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine reportRtcStats:(FYRtcEngineStatus *)status
参数 | 描述 |
---|---|
status | downBandwidth :下行带宽 upBandwidth:上行带宽 sendLossRate:发送丢包率 recvLossRate:接受丢包率 sendBytes:发送字节数(累计值) recvBytes:接受字节数(累计值) |
该回调定期上报音频相关统计数据,每两秒回调一次
- (void)onFYRtcEngine:(FYRtcEngineKit *)engine OnError:(FYError *)error
参数 | 描述 |
---|---|
error | code:FYRtcEngineKit错误码 msg:错误消息 |
在使用sdk期间发生所有错误,都会触发该回调。