一、快速开始

集成指南

适用范围

本集成文档适用于iOS RTCPEngine SDK 2.0.0 ~ 3.0.2版本。

准备环境

• Xcode 9.0+。
• iOS 8.0+ 真机（iPhone 或 iPad）。
• 请确保你的项目已设置有效的开发者签名。

导入SDK

CocoaPods导入

• 通过 Cocoapods 下载地址：

pod 'RTCPEngine'

• 如果需要安装指定版本则使用以下方式（以 3.0.2 版本为例）：

pod 'RTCPEngine', '3.0.2'

手动导入

• 前往GitHub下载Demo，找到RTCPEngine.framework；

• 在Xcode中选择“Add files to 'Your project name'...”，将RTCPEngine.framework添加到你的工程目录中

• 打开General->Embedded Binaries中添加RTCPEngine.framework

权限说明

使用RTCPEngine SDK 前，需要对设备进行授权。打开 info.plist ，点击 + 图标开始添加：

• 添加设备使用「网络」的权限

  <key>NSAppTransportSecurity</key>
  <dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
  </dict>
  

• 添加设备使用「相机」的权限

  <key>NSCameraUsageDescription</key>
  <string>XXX请求访问相机用于...</string>
  

• 添加设备使用「麦克风」的权限

<key>NSMicrophoneUsageDescription</key>
<string>XXX请求访问麦克风用于...</string>

后台模式(Background Modes)

勾选Audio, AirPlay and Picture in Picture

开发指南

1. 初始化SDK

集成SDK后，还需对SDK进行初始化操作，建议在AppDelegate中完成。

1.1 导入头文件

#import <RTCPEngine/ARRtcpSDK.h>

1.2 配置开发者信息

调用initEngine:token:方法配置开发者信息，开发者信息可在anyRTC管理后台中获得，详见创建anyRTC账号

示例代码：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
//配置开发者信息
[ARRtcpEngine initEngine:appID token:token];
return YES;
}

2. 实例化实时直播对象

调用initWithDelegate:userId:userData:方法实例化实时直播对象，需实现ARRtcpKitDelegate中的回调方法。

示例代码：

- (void)itializationRTCPKit {
//实例化实时直播对象
self.rtcpKit = [[ARRtcpKit alloc] initWithDelegate:self userId:[NSString stringWithFormat:@"%d",arc4random() % 100000] userData:@""];   
}

3. 发布流

3.1 配置信息

调用ARRtcpOption类中的方法可对视频质量、帧率、码率、方向等进行配置。

示例代码：

//配置信息
ARRtcpOption *option = [ARRtcpOption defaultOption];
ARVideoConfig *config = [[ARVideoConfig alloc] init];
config.videoProfile = ARVideoProfile360x640;
config.cameraOrientation = ARCameraAuto;
option.videoConfig = config;

3.2 发布媒体

调用publishByToken:roomId:mediaType:isLive:方法发布媒体，第一个参数token为令牌，可为空，具体用法可参考安全指南，第二个参数type为发布类型，音视频（ARMediaVideoType）、音频（ARMediaAudioType）。

示例代码：

[self.rtcpKit publishByToken:nil roomId:[self randomAnyRTCString:6] mediaType:0 isLive:YES];

3.3 设置本地视频采集窗口

调用setLocalVideoCapturer方法设置本地视频采集窗口，第一个参数为本地视频显示窗口，第二个参数为配置信息。

示例代码：

[self.rtcpKit setLocalVideoCapturer:self.view option:option];

3.4 取消发布媒体

调用unPublish方法取消发布媒体，再次发布需调用setLocalVideoCapturer方法。

示例代码：

[self.rtcpKit unPublish];

4. 订阅流

4.1 订阅视频

调用subscribeByToken:pubId:方法订阅媒体，第一个参数token为令牌，可为空，具体用法可参考安全指南，第二个参数pubId为通道id。

示例代码：

[self.rtcpKit subscribeByToken:nil pubId:self.pubId];

4.2 设置显示其他人的视频窗口

订阅后视频即将显示的回调中可调用setRemoteVideoRender:pubId:方法用于显示订阅的视频窗口。

示例代码：

- (void)onRTCOpenRemoteVideoRender:(NSString *)pubId {
[self.rtcpKit setRemoteVideoRender:self.view pubId:pubId];
}

4.3 取消订阅

取消已订阅的流可调用unSubscribe方法。

示例代码：

[self.rtcpKit unSubscribe:self.pubId];

5. 离开房间

直播结束或离开房间需调用close方法。

示例代码：

[self.rtcpKit close];

二、API接口文档

ARRtcpEngine 接口类

1. 配置开发者信息

定义

+ (void)initEngine:(NSString *)appId token:(NSString *)token;

参数

说明

该方法为配置开发者信息，上述参数均可在https://www.anyrtc.io/ 应用管理中获得，建议在AppDelegate.m调用。

2. 配置私有云

定义

+ (void)configServerForPriCloud:(NSString *)address port:(int)port;

参数

说明

配置私有云信息，当使用私有云时才需要进行配置，默认无需配置。

3. 获取SDK版本号

定义

+ (NSString *)getSDKVersion;

返回值

RTCP SDK版本号

4. 设置打印日志级别

定义

+ (void)setLogLevel:(ARLogModel)levelModel;

参数

ARRtcpKit 接口类

1. 实例化RTCPKit对象

定义

- (instancetype)initWithDelegate:(id<ARRtcpKitDelegate>)delegate userId:(NSString *)userId userData:(NSString *)userData;

参数

返回

实时直播对象。

2. 监听房间

定义

- (void)listen:(NSString *)roomId;

参数

说明

监听房间号，用户发布取消发布的回调可以监听到，可以监听多个房间。

3. 取消监听房间

定义

- (void)unListen:(NSString *)roomId;

参数

说明

取消监听房间号，用户发布取消发布的回调不在回调。

4. 设置本地视频采集窗口

定义

- (void)setLocalVideoCapturer:(UIView *)render option:(ARRtcpOption *)option;

参数

5. 设置本地显示模式

定义

- (void)updateLocalVideoRenderModel:(ARVideoRenderMode)videoRenderMode;

参数

6. 设置本地音频是否传输

定义

- (void)setLocalAudioEnable:(BOOL)enable;

参数

7. 设置本地视频是否传输

定义

- (void)setLocalVideoEnable:(BOOL)enable;

参数

8. 获取本地音频传输是否打开

定义

- (BOOL)localAudioEnabled;

返回值

音频传输与否

9. 获取本地视频传输是否打开

定义

- (BOOL)localVideoEnabled;

返回值

视频传输与否

10. 设置扬声器开关

定义

- (void)setSpeakerOn:(BOOL)on;

参数

11. 切换前后摄像头

定义

- (void)switchCamera;

12. 设置本地前置摄像头镜像是否打开

定义

- (BOOL)setFontCameraMirrorEnable:(BOOL)enable;

参数

返回

本地前置摄像头镜像是否成功打开

13. 前置摄像头是否镜像

定义

- (BOOL)fontCameraMirror;

返回值

是否镜像，默认打开。

14. 禁止接收某人视频

定义

- (int)muteRemoteVideoStream:(BOOL)mute pubId:(NSString *)pubId;

参数

返回值

操作是否成功

15. 禁止接收某人音频

定义

- (int)muteRemoteAudioStream:(BOOL)mute pubId:(NSString *)pubId;

参数

返回值

操作是否成功

16. 发布媒体

定义

- (void)publishByToken:(NSString *_Nullable)token roomId:(NSString *)roomId mediaType:(ARMediaType)type isLive:(BOOL)live;

参数

17. 取消发布媒体

定义

- (void)unPublish;

说明

取消发布媒体之后，下次再发布的时候，还需要在调用setLocalVideoCapturer

18. 订阅视频

定义

- (void)subscribeByToken:(NSString *_Nullable)token pubId:(NSString *)pubId;

参数

19. 取消订阅媒体流

定义

- (void)unSubscribe:(NSString *)pubId;

参数

20. 设置显示其他人的视频窗口

定义

- (void)setRemoteVideoRender:(UIView *)render pubId:(NSString *)pubId;

参数

说明

该方法用于订阅成功通后，视频即将显示的回调中(onRTCRemoteOpenVideoRender)使用。

21. 设置其他人显示模式

定义

- (void)updateRTCVideoRenderModel:(ARVideoRenderMode)videoRenderMode;

参数

22. 关闭离开

定义

- (void)close;

23. 设置音频检测

定义

- (void)setAudioActiveCheck:(BOOL)on;

参数

24. 获取音频检测是否打开

定义

- (BOOL)audioActiveCheck;

25. 设置视频网络状态是否打开

定义

- (void)setNetworkStatus:(BOOL)enable;

参数

26. 获取当前视频网络状态是否打开

定义

- (BOOL)networkStatusEnabled;

ARRtcpKitDelegate 接口类

1. 发布媒体成功回调

定义

- (void)onRTCPublishOK:(NSString *)pubId liveInfo:(NSString *)liveInfo;

参数

2. 发布媒体失败回调

定义

- (void)onRTCPublishFailed:(ARRtcpCode)code reason:(NSString *)reason;

参数

3. 订阅通道成功的回调

定义

- (void)onRTCSubscribeOK:(NSString *)pubId;

参数

4. 订阅通道失败的回调

定义

- (void)onRTCSubscribeFailed:(NSString *)pubId code:(ARRtcpCode)code reason:(NSString *)reason;

参数

5. 订阅后音视频即将显示的回调

定义

- (void)onRTCOpenRemoteVideoRender:(NSString *)pubId;

参数

6. 订阅的音视频离开的回调

定义

- (void)onRTCCloseRemoteVideoRender:(NSString *)pubId;

参数

7. 订阅音频后成功的回调

定义

- (void)onRTCOpenRemoteAudioTrack:(NSString *)pubId;

参数

8. 订阅的音频离开的回调

定义

- (void)onRTCCloseRemoteAudioTrack:(NSString *)pubId;

参数

9. 本地视频第一帧

定义

- (void)onRTCFirstLocalVideoFrame:(CGSize)size;

参数

10. 远程视频第一帧

定义

- (void)onRTCFirstRemoteVideoFrame:(CGSize)size pubId:(NSString *)pubId;

参数

11. 本地窗口大小的回调

定义

- (void)onRTCLocalVideoViewChanged:(CGSize)size;

参数

12. 远程窗口大小的回调

定义

- (void)onRTCRemoteVideoViewChanged:(CGSize)size pubId:(NSString *)pubId;

参数

13. 其他发布者的音频检测回调

定义

- (void)onRTCRemoteAudioActive:(NSString *)pubId audioLevel:(int)level showTime:(int)time;

参数

说明

与会者关闭音频后（setLocalAudioEnable为NO）,该回调将不再回调。对方关闭音频检测后（setAudioActiveCheck为NO）,该回调也将不再回调。

14. 本地音频检测回调

定义

- (void)onRTCLocalAudioActive:(int)level showTime:(int)time;

参数

说明

本地关闭音频后（setLocalAudioEnable为NO）,该回调将不再回调。本地关闭音频检测后（setAudioActiveCheck为NO）,该回调也将不再回调。

15. 其他发布者的网络质量回调

定义

- (void)onRTCRemoteNetworkStatus:(NSString *)pubId netSpeed:(int)netSpeed packetLost:(int)packetLost netQuality:(ARNetQuality)netQuality;

参数

16. 本地网络质量回调

定义

- (void)onRTCLocalNetworkStatus:(int)netSpeed packetLost:(int)packetLost netQuality:(ARNetQuality)netQuality;

参数

三、更新日志

Version 3.0.2 （2020-02-12）

• 添加发布、取消发布的监听

Version 3.0.1 （2019-05-24）

• 修复观看端不操作锁屏问题

Version 3.0.0 （2019-05-15）

• SDK版本升级3.0，API接口变更

Version 2.0.0 （2017-09-30）

• SDK版本升级2.0，梳理、完善SDK