趣拍直播SDKforIOS开发指南注册开发者账号在网站上，点击右上角的?http://vcs.qupai.me/console.html
「控制台」?链接，进入登录界面。如果已经是注册过用户，可以直接进行http://vcs.qupai.me/dq.html登录操作，
如果您不是我们的用户，请进行账号的http://vcs.qupai.me/dq.html注册。在注册界面填写邮箱、密码，然后点击注
册。注册成功后，邮箱会收到一封验证邮件。请按照邮件说明进行验证，完成账号激活操作。成功验证后，账户即可登录使用。二、创建应用，开通
直播创建应用，按要求填写相关信息，选择平台?iOS?，bundleID和应用名称一定要一一对应，填写完毕后进行提交。进入htt
p://vcs.qupai.me/console.html「控制台」，点击进入应用管理中我的应用选项。系统会自动为每个应用生成一个
唯一的appkey，即SDK初始化时要填写的appkey。appkey与应用是一一对应的，更换应用包名时，系统也会自动生成新的ap
pkey。一个账户可以创建最多5个应用。在集成SDK时，如果appkey、应用和资源包不匹配，会导致SDK无法正常运行。三、SDK
下载进入http://vcs.qupai.me/console.html「控制台」，点击进入SDK下载，选择直播SDKhttp:/
/static.qupaicloud.com/sdk/QupaiLive_iOS_1.0_beta.zip下载。四、SDK集成拖拽
sdk文件夹到自己的Xcode项目中。勾选Copyitemsifneeded，点击Finish。打开项目的appta
rget，在BuildPhases中的LinkBinaryWithLibraries添加以下依赖库。libz.tbd
VideoToolbox.frameworkAudioToolbox.frameworklibstdc++.tbdSystemCo
nfiguration.frameworkCoreTelephone.framework五、SDK初始化在AppDelegate.
m文件的头部引入#import?在AppDelegate.m的didFinishLaunchi
ngWithOptions方法中添加以下初始化代码：[[QPAuthshared]registerAppWithKey:你的
appkeysecret:你的appSecretspace:用户的uuidsuccess:^(NSStringacces
sToken){NSLog(@"accesstoken:%@",accessToken);}failure:^(NSE
rrorerror){NSLog(@"failed:%@",error.description);}];参数说明：1.
参数appKey，appSecret通过开发控制台上注册得到，进入「控制台」，点击进入应用管理中我的应用选项可查看。2.space
是发布推流为每一个用户设置的一个流名，同时也作为直播回放的空间名称，建议设置为用户的uuid（最大支持32位，如获取的uuid大于
32位请自行处理）。例如：A用户的uuid是110001，在paas平台的空间中为A用户生成一个110001的文件夹存放A用户上传
的内容。3.注册成功后就取得了对指定文件夹的上传权限，并取得accessToken。常见错误码1101Host（请求的域名）未
授权，通常都是域名地址错误导致1102appSecret不正确1103bundleId不正确1104包名和签名为空1105
包名或签名不正确1106存储空间里的目录不正确1107AppKey不正确六、直播功能的使用在需要直播功能的控制器头部导入#i
mport，并设置代理1.发起直播请求QPLiv
eRequestrequest=[[QPLiveRequestalloc]init];[requestrequest
CreateLiveWithDomain:你的域名success:^(NSStringpushUrl,NSString
pullUrl){//这里配置直播参数//开启直播}failure:^(NSErrorerror){NSLog(@"liv
eurlrequestfailed");}];注意：推流功能必须IOS8以上使用，请开发者在使用直播功能时对版本进行控制。原
因是直播服务使用了硬件编码。回放地址可以通过配置录制URL通知获取，详情参考直播API文档domain请进入「控制台」，进入空间管
理查看访问域名。2.设置直播参数QPLConfigurationconfiguration=[[QPLConfigurat
ionalloc]init];configuration.url=pushUrl;//设置推流地址configuratio
n.videoMaxBitRate=15001000;//设置最大码率，设置最大码率和最小码率后SDK会根据网络状况自动
调整码率configuration.videoBitRate=6001000;//设置当前视频码率configurati
on.videoMinBitRate=4001000;//设置最小码率configuration.audioBitRat
e=641000;//设置音频码率configuration.videoSize=CGSizeMake(360,6
40);//设置直播分辨率configuration.fps=20;//设置帧数configuration.preset=
AVCaptureSessionPresetiFrame1280x720;//设置采集质量configuration.positi
on=AVCaptureDevicePositionFront;//设置前置摄像头或后置摄像头3.创建直播session_li
veSession=[[QPLiveSessionalloc]initWithConfiguration:configur
ation];4.设置session代理_liveSession.delegate=self;5.开启直播预览[_liveSe
ssionstartPreview];6.开启直播[_liveSessionconnectServer];7.获取直播预览视图
[_liveSessionpreviewView]可将获取的直播视图添加到当前控制器上，实现直播预览功能。8.停止预览[_liv
eSessionstopPreview];注意：停止预览后将liveSession置为nil9.关闭直播[_liveSessio
ndisconnectServer];10.设置闪光灯模式_liveSession.torchMode=AVCaptureT
orchModeOn//关闭AVCaptureTorchModeOff11.开启美颜[_liveSessionsetEnable
Skin:YES]七、直播功能的相关代理方法1.直播出错的代理方法-(void)liveSession:(QPLiveSession)sessionerror:(NSError)error2.网速较慢时的代理方法-(void)liveSessionNetworkSlow:(QPLiveSession)session内部已经根据网络状况自动调整码率，这个方法不建议使用。如果有特殊需求可通过这个代理方法可手动更新码率。 |
|
