Agora iOS SDK-开始聊天

在上一篇Agora iOS SDK-快速入门中聊了如果配置Agora iOS SDK,这一篇将看下如何使用Agora如何进行聊天。
Agora封装了视频聊天的大多数常用功能,直接调用Agora API即可直接开始聊天。这篇文章的主要目标是结合文档完成一对一视频聊天的Demo。

初始化

AgoraRtcEngineKit是Agora SDK的入口,通过它就可以完成聊天的基本设置。比如设置远程视频、本地视频的配置、声音控制、以及设置摄像头等。
首先,新建一个ChatViewController用来实现聊天功能,在ChatViewController中声明一个AgoraRtcEngineKit的变量:

var agoraKit : AgoraRtcEngineKit!

初始化该变量需要实现委托:AgoraRtcEngineDelegate,它是AgoraRtcEngineKit的回调,在出现错误、离开频道….等情况出现的时候可以在该回调中得到通知。
它的其中一个方法- (void)rtcEngine:(AgoraRtcEngineKit *)engine firstRemoteVideoDecodedOfUid:(NSUInteger)uid size:(CGSize)size elapsed:(NSInteger)elapsed;的意思是在第一个用户准备好视频通信的情况下会触发该方法,这个时候就可以配置该用户的显示界面了,AgoraRtcEngineDelegate实现:

extension ChatViewController:AgoraRtcEngineDelegate{
    func rtcEngine(_ engine: AgoraRtcEngineKit!, firstRemoteVideoDecodedOfUid uid: UInt, size: CGSize, elapsed: Int) {
     
        
    }
    func rtcEngine(_ engine: AgoraRtcEngineKit!, didLeaveChannelWith stats: AgoraRtcStats!) {
        
    }

}

这里使用了extension扩展了ChatViewController用来实现AgoraRtcEngineDelegate
再实现了委托之后就可以实例化agoraKit了,实例化方法:

agoraKit=AgoraRtcEngineKit.sharedEngine(withAppId: AgoraSetting.AgoraAppId, delegate: self)

这样就完成了AgoraRtcEngineKit的初始化,初始化完成之后还需要设置视频显示,下面就先从远程视频的设置开始。

开启远程用户视频

远程视频的设置也比较简单,在AgoraRtcEngineDelegate中的方法func rtcEngine(_ engine: AgoraRtcEngineKit!, firstRemoteVideoDecodedOfUid uid: UInt, size: CGSize, elapsed: Int)被调用的时候,就可以开启该远程视频的显示,实现该方式就可以拿到该用户的信息。
在设置远程用户视频之前,还需要新建一个UIView用来显示远程视频,远程视频的显示会在该UIView内完成,新建一个UIView用来接收远程视频:

@IBOutlet weak var remoteView: UIView!

还需要一个VideoCanvas的实例,在该实例中配置远程视频的显示方式。

let videoCanvas = AgoraRtcVideoCanvas()

videoCanvas需要设置下下面几个参数:

  • uid 用来区分用户的唯一标识

  • view 用来设置显示远程视频的view

  • renderMode 视频显示模式包括三种模式:AgoraRtc_Render_Hidden、AgoraRtc_Render_Fit、AgoraRtc_Render_Adaptive

配置好videoCanvas之后,就可以在agoraKit中开启远程视频了:

agoraKit.setupRemoteVideo(videoCanvas)

使用Agora设置远程视频的播放就是如此简单,不用再关心底层的实现,减少了应用开发者在底层上的开发时间。当然本地视频的设置也是如此的简单。

本地视频

对于本地视频的配置,首先需要设置视频参数,包括分辨率、帧率、码率等,当设置的分辨率不被摄像头支持的时候,SDK会自动找到一个合适的分辨率来适配摄像头,但显示的仍然是指定的分辨率。
设置本地视频配置的方法:

setVideoProfile:(AgoraRtcVideoProfile)profile

swapWidthAndHeight:(BOOL)swapWidthAndHeight;

第一参数包含了分辨率、帧率、码率的配置,在SDK中已经有已经设置好的参数,在demo中使用的是._VideoProfile_360P,第二个参数表示是否交换宽和高,用来适应横屏和竖屏的显示。默认为false。
设置本地视频配置:

agoraKit.setVideoProfile(._VideoProfile_360P, swapWidthAndHeight: false)

和远程视频的设置一样,首先需要一个view用来接收本地视频的显示,定义一个本地显示本地视频的view:

@IBOutlet weak var localVideo: UIView!

本地视频的显示也需要实例化一个AgoraRtcVideoCanvas,还要配置AgoraRtcVideoCanvas的三个参数,然后把AgoraRtcVideoCanvas设置给agoraKit,完整代码如下:

func setupLocalVideo(){
        agoraKit.setVideoProfile(._VideoProfile_360P, swapWidthAndHeight: false)
        let videoCanvas=AgoraRtcVideoCanvas()
        videoCanvas.uid=0
        videoCanvas.view=localVideo
        videoCanvas.renderMode = .render_Adaptive
        agoraKit.setupLocalVideo(videoCanvas)
    }

上面完成了本地视频和远程视频的设置和显示,在需要和人一起聊天之前,还要两个人都加入到一个频道中。

加入一个频道

频道:在同一个频道内的用户可以互相通话,如果多个用户加入了一个频道就可以群聊,一个用户只能加入一个频道。切换频道必须从当前频道中退出。
先看加入频道的代码:

 func joinChannel(){
        agoraKit.joinChannel(byKey: nil, channelName: "demo", info: nil, uid: 0){[weak self](sid,uid,elapsed)->Void in
            if let weakSelf = self{
                weakSelf.agoraKit.setEnableSpeakerphone(true)
                UIApplication.shared.isIdleTimerDisabled = true
            }
            
    }

下面简单说下各个参数的含义:

  • byKey 可选参数,使用nil或者App ID都可以,如果对于安全要求极高的话可以使用申请Channel Key

  • channelName 频道名称

  • info 开发可以附件信息,该信息不会给用户看到

  • uid 用户唯一标识

  • joinChannelSuccessBlock 一个加入成功的回调block,在加入频道成功之后通过设置isIdleTimerDisabled来阻止用户锁屏。

通过agoraKit.leaveChannel()可以离开频道,只有离开一个频道才能进入下一个频道,leaveChannel是异步操作,调用时并没有真正的退出频道,在真正的退出频道后,会触发didLeaveChannelWithStats回调。
在一个频道中的用户就可以正式的开始聊天了。
在聊天过程中特别是会议聊天时,有时需要禁止自己的声音,防止打扰别人说话,Agora SDK也提供了对于声音和摄像头的控制。

声音控制

聊天中对于声音的控制有很多种方式,下面介绍下几种比较常用的方式:

声音开关

muteLocalAudioStream 可以设置本地声音的开关,使用方式也比较简单,通过一个Button控制本地声音的开启:

@IBAction func mute(_ sender: UIButton) {
        sender.isSelected = !sender.isSelected
        agoraKit.muteLocalAudioStream(sender.isSelected)
    }

muteAllRemoteAudioStreams 的作用是禁止所有的远程视频的声音,使用方式和muteLocalAudioStream一样。
如果想禁止某一个用户的声音可以可以使用方法:

-(int)muteRemoteAudioStream:(NSUInteger)uid muted:(BOOL)muted;

其中uid是用户的唯一标识,利用uid就可以针对某一个用户开启/关闭该用户的声音。

开启扬声器

通过方法:

-(int)setEnableSpeakerphone:(BOOL)enableSpeaker;

可以设置使用扬声器或听筒,其中YES是输出声音到扬声器,NO是使用听筒。

监听声音

在多人聊天的过程中,我们还需要知道是谁在说话,这个时候就需要设置监听用户的声音状态,通过方法:

-(int)enableAudioVolumeIndication:(NSInteger)interval smooth:(NSInteger)smooth;

就可以监听远程用户的声音状态,设置该方法之后可以在AgoraRtcEngineDelegate中的reportAudioVolumeIndicationOfSpeakers中收到谁在说话以及他说话的音量。

上面是针对声音的方法,更多的设置可以参考官方的文档,下面再看下针对摄像头的方法

摄像头

对于摄像头的控制方法也有很多的方式,下面以几个比较常用方法为主简单介绍下。

开启本地预览

在demo中的频道列表中使用的背景是本地视频的预览,本地预览相关的有两个方法:

startPreview(开启预览)
stopPreview(停止预览)

注意开启视频预览之前必须先设置本地的视频显示属性以及预览的UIView,详细的设置可以参考demo。

摄像头切换

视频聊天中常常需要对前置/后置摄像头进行切换,切换摄像头的代码为:

 @IBAction func switchCamera(_ sender: UIButton) {
        agoraKit.switchCamera()
    }

使用该方法,SDK会判断当前摄像头的状态,并对摄像头进行切换。

视频开关

和声音开关类似,也可以通过API暂停发送视频,暂定发送本地视频流的方法:

-(int)muteLocalVideoStream:(BOOL)mute;

暂停所有远程视频流的方法:

-(int)muteAllRemoteVideoStreams:(BOOL)mute;

暂停某一个远程用户视频的方法:

-(int)muteRemoteVideoStream:(NSUInteger)uid mute:(BOOL)mute;

通过该例子可以实现一对一的视频聊天,下一篇文章将介绍下如果进行多人视频聊天。

源代码地址:https://github.com/jjz/agora-swift
参考文档:https://docs.agora.io/cn/user_guide/API/ios_api.html

    原文作者:姜家志
    原文地址: https://segmentfault.com/a/1190000009320166
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞