开放平台

一、直播SDK接口说明

1、进入和退出直播间

（1）进入直播间

-(void)joinLiveWithLiveReq:(QSLiveReq *)liveReq delegate:(id<QSLiveSDKProtocol>)delegate completion:(void(^)(BOOL succeed, NSError * _Nullable error))completion

注意：当处于直播间小窗状态时，进入其他直播间前需要SDK集成方先退出上一场直播间，否则会直接调起上一场直播间。

（2）退出直播间

当退出直播间界面时，会自动退出直播间

（3）显示直播间界面

在进入调用进入直播间成功后，此时需要将直播间视图控制器加入到容器页面中，否则无法展示出直播间界面

- (void)onShowLiveRoom:(UIViewController *)viewController；

（4）监听直播间进入结果

- (void)onLiveStatusChanged:(QSLiveStatus)status;

 接口说明可参考快速开始接口的参数说明

 对于快速集成的客户来说，可以不关心该接口。

2、获取直播间信息

获取直播间相关的信息，主要信息如下：

- (nullable QSLiveRoomInfo *)getLiveRoomInfo;
> 对于快速集成的客户来说，可以不关心该接口。

相关接口：[[QSLiveSDK getShareInstance] getLiveRoomInfo]

3、设置日志路径

 相关接口：
 - (void)setLogsDirectory:(NSString *)logsDirectory

4、分享功能设置

/添加分享所需要的数据,可多次调用
location:所使用的场景功能（默认为在直播间分享中使用）
list：传入自定义分享的数据
insertTop:YES:头部插入， NO：尾部插入
/

接口：- (void)addCustomShareTypes:(QSLiveShareLocation)location shareList:(NSArray<QSLiveCustomShareData *> *)list insertTop:(BOOL)insertTop;

使用方式查看Demo使用样例，在joinLiveWithLiveReq入会前调用。构造QSLiveCustomShareData数据源，并存入数组。自定义数据源在类QSAuthRequest.h中可查看。
调用方法解释：
1.如只需使用app基本分享功能，调用如下方法，数据源传空即可

[[QSLiveSDK getShareInstance] addCustomShareTypes:QSLiveShareLocation_LiveShare shareList:nil insertTop:YES];
[[QSLiveSDK getShareInstance] addCustomShareTypes:QSLiveShareLocation_Notice shareList:nil insertTop:YES];

2.如果需要构造自定义分享，则必须传入数据源数组，Demo演示内容为自定义微信分享。自定义分享不提供实现，只提供回调方法和回调参数。
如：

// 构造分享数据源，在全时默认功能前插入
[[QSLiveSDK getShareInstance] addCustomShareTypes:QSLiveShareLocation_LiveShare shareList:self.firstShareArray insertTop:YES];
// 构造分享数据源，在全时默认功能后插入
[[QSLiveSDK getShareInstance] addCustomShareTypes:QSLiveShareLocation_LiveShare shareList:self.lastShareArray insertTop:NO];
// 构造海报页面数据源，在全时默认功能前插入
[[QSLiveSDK getShareInstance] addCustomShareTypes:QSLiveShareLocation_Notice shareList:self.firstNoticeArray insertTop:YES];
// 构造海报页面数据源，在全时默认功能后插入
[[QSLiveSDK getShareInstance] addCustomShareTypes:QSLiveShareLocation_Notice shareList:self.lastNoticeArray insertTop:NO];

如Demo中所示；QSVQuickJoinLiveViewController类中添加实例代码：
在调用 joinLiveWithReq方法之前调用QSLiveReq所提供的方法：
linkEnabel:分享链接是否可用
codeEnable:分享直播码是否可用
posterEnable:分享海报是否可用
posterDownloadEnable:下载海报是否可用-----分享海报页面参数

- (void)setShareLinkEnable:(BOOL)linkEnabel codeEnable:(BOOL)codeEnable posterEnable:(BOOL)posterEnable posterDownloadEnable:(BOOL)posterDownloadEnable;

调用方式如下： [req setShareLinkEnable:YES codeEnable:YES posterEnable:NO posterDownloadEnable:YES]; SDK中内置的分享功能，如需要使用传YES，否则不展示，默认为YES。