在上一篇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
