集成

• 手动集成
• CocoaPod (即将支持)

手动集成

1. 下载APPGear-iOS SDK 下载地址

2. 接入APPGear-iOS SDK

• 将APPGear-iOS SDK添加到工程
• 添加项目配置
• Build Settings -> Linking -> Ohter linker Flags 中添加-ObjC
• Build Settings -> Architectures -> Architectures中添加armv7s
• Build Settings -> Architectures -> Build Active Architecture Only 改为NO

3. 加入依赖库

• Build phases -> Link Binary With Libraries 中添加 libresolv.9.tbd
• Build phases -> Link Binary With Libraries 中添加 APPGear-iOS.framework

4. 初始化

• 在AppDelegate.m中添加 #import <APPGear/APPGear.h>
• 在(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中添加一下代码:

(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

///  配置API信息
[CDAAPIManager setUpConfigurationWithAppKey:@"JKsDV0zcWwrCL7qmqEJlaPU7Euue" appName:@"camsgear"];

///  配置用户信息
[CDAUserManager setUpUserConfiguration];

return YES;
}

功能模块

• 获取分享地址
• 用户模块
• 获取手机验证码
• 登录
• 邮箱登录
• 第三方登录
• 注销
• 获取账户余额
• 视频模块
• 获取视频数据
• 下拉获取最新数据
• 上拉获取更多视频数据
• 发布视频或图片
• 取消发布

获取分享地址

• 获取分享地址

获取分享地址

函数定义

// 返回分享视频地址
- (nonnull NSString *)getSharedVideoWithVideoId:(nonnull NSString *)videoId;

// 返回分享图片地址
- (nonnull NSString *)getSharedImageWithImageId:(nonnull NSString *)imageId;

用户模块

• 获取手机验证码
• 登录
• 邮箱登录
• 第三方登录
• 注销
• 获取账户余额

获取手机验证码

函数定义

- (void) getVerifyCodeWithPhone:(nonnull NSString *)phone type:(CDASignType)type success:(nonnull UserSuccessBlock)success failure:(nonnull UserFailureBlock)failure;

参数说明

• phoneNumber - 手机号码
• type - 验证类型 (signin:登录, signup:注册, signin_signup:登录注册通用)
• success - 成功回调
• failure - 失败回调

示例

[[CDAUserManager sharedManager]getVerifyCodeWithPhone:self.phoneNumber.text type:CDASignType_signin_signup success:^(id result) {

[SVProgressHUD showSuccessWithStatus:@"获取验证码成功,请注意查看短信"];

} failure:^(NSError *error) {
NSLog(@"%@",error);
[SVProgressHUD showErrorWithStatus:@"获取验证失败,请确认手机号是否输入正确"];
}];

---

登录

函数定义

- (void)signinOrSignup:(NSString *)phone
verificationCode:(NSString *)code
success:(UserSuccessBlock)success
failure:(UserFailureBlock)failure

参数说明

• phone - 手机号码
• code - 手机验证码
• success - 成功回调
• failure - 失败回调

示例

[[CDAUserManager sharedManager]signinOrSignup:self.phoneNumber.text
verificationCode:self.verificationCode.text
success:^(id result) {
[SVProgressHUD showSuccessWithStatus:@"登录成功"];
} failure:^(NSError *error) {
[SVProgressHUD showErrorWithStatus:@"登录失败,请确认手机号和验证码是否输入正确"];
}];

---

####邮箱登录 #####函数定义

- (void) signinWithE_MailAccount:( nonnull NSString *)mailAccount passWord:( nonnull NSString *)passWord success:( nonnull UserSuccessBlock)success failure:( nonnull UserFailureBlock)failure;

参数说明

• mailAccount - 邮箱账号
• pwassWord - 密码

示例

- (IBAction)clickE_MailSign:(id)sender {

[[CDAUserManager sharedManager]signinWithE_MailAccount:@"邮箱账号" passWord:@"密码" success:^(id  _Nonnull result) {

} failure:^(NSError * _Nonnull error) {

}];

}

第三方登录

#####函数定义

Objective-C
- (void) CamdoraSignIn: (nullable NSDictionary *)userInfo success:(nonnull UserSuccessBlock)success failure:(nonnull UserFailureBlock)failure Platform:(CDAThirdType)platform

参数说明

• userInfo - 第三方授权成功后的userInfo.originalResponse
• Platform -平台类型
• success - 成功回调
• failure - 失败回调

示例

[[CDAUserManager sharedManager]CamdoraSignIn:@{} success:^(id  _Nonnull result) {

} failure:^(NSError * _Nonnull error) {

} Platform:CDAThirdType_wechat];

注销

函数定义

- (void)signOut: (UserSuccessBlock)success failure: (UserFailureBlock)failure;

参数说明

• success - 成功回调
• failure - 失败回调

示例

- (IBAction)clickOnTheExitTheLogInButton:(id)sender {
[[CDAUserManager sharedManager]signOut:^(id result) {
[SVProgressHUD showSuccessWithStatus:@"注销成功"];
} failure:^(NSError *error) {
[SVProgressHUD showErrorWithStatus:@"注销失败"];
}];
}

获取账户余额

函数定义

- (void)getWalletSuccess:(nonnull APISuccessBlock)success failure:(nonnull APIFailureBlock)failure;

参数说明

• success - 成功回调
• failure - 失败回调

示例

[[CDAAPIManager sharedManager]getWalletSuccess:^(id result) {

[SVProgressHUD showSuccessWithStatus:[NSString stringWithFormat:@"%@",result]];
} failure:^(NSError *error) {
[SVProgressHUD showErrorWithStatus:@"获取失败"];
}];

---

视频模块

• 获取视频数据
• 下拉获取最新数据
• 上拉获取更多视频数据
• 发布视频

获取视频数据

函数定义

- (void) getLatestVideos: (APISuccessBlock)success failure:(APIFailureBlock)failure;

参数说明

• success - 成功回调
• failure - 失败回调

示例

//block返回的result已经是转过模型的CDAVideo对象,可直接使用
[[CDAAPIManager sharedManager]getLatestVideos:^(NSArray *result) {
[self.videos addObjectsFromArray:result];
[SVProgressHUD showSuccessWithStatus:[NSString stringWithFormat:@"加载了%ld条数据",(unsigned long)result.count]];
NSLog(@"--视频数据:%@",result);
} failure:^(NSError *error) {
[SVProgressHUD showErrorWithStatus:@"加载失败"];
}];

---

下拉获取最新数据

函数定义

- (void) getVideosBefore:(NSString *)videoId
UserId:(NSString *)userId
success:(APISuccessBlock)success
failure:(APIFailureBlock)failure

参数说明

• videoId - 当前列表的第一条video数据的id
• userId - 用户id为想获取视频的用户id,只能获取用户个人的数据,广场数据下拉请调用- (void) getLatestVideos: (APISuccessBlock)success failure:(APIFailureBlock)failure;
• success - 成功回调
• failure - 失败回调

示例

CDAVideo *firstVideo = [self.videos firstObject];
//tips: userid区分 获取广场数据,还是个人数据
[[CDAAPIManager sharedManager] getVideosBefore:firstVideo.id UserId:nil success:^(id result) {
NSLog(@"--下拉视频数据:%@",result);
} failure:^(NSError *error) {
}];

---

上拉获取更多视频数据

函数定义

- (void) getVideosAfter:(NSString *)videoId
UserId:(NSString *)userId
success:(APISuccessBlock)success
failure:(APIFailureBlock)failure;

参数说明

• videoId - 当前列表的最后一条video数据的id
• userId - 用户id
• success - 成功回调
• failure - 失败回调

示例

CDAVideo *lastVideo = self.videos.lastObject;
//tips: userid区分 获取广场数据,还是个人数据
[[CDAAPIManager sharedManager]getVideosAfter:lastVideo.id UserId:nil success:^(id result) {
NSLog(@"--上拉视频数据:%@",result);
} failure:^(NSError *error) {
}];

---

发布视频

函数定义

- (void)releaseMediaByLocalMedia:(nullable CDALocalMedia *)localMedia MediaType:(CDAMediaIsBelongToMe)mediaType image:(nullable UIImage *)image success:(nonnull APISuccessBlock)success uploadProgress:(nonnull APIUploadProgressBlock)progress failure:(nonnull APIFailureBlock)failure;

参数说明

• localMedia - 待上传的视频对象
• mediaType - 发布类型
• image - 视频封面，可为空，为空则取视频第一帧为封面
• success - 成功回调
• progress - Progress回调
• failure - 失败回调

示例

Objective-C
- (IBAction)clickPostVideo:(id)sender {

CDALocalMedia *localMedia = [[CDALocalMedia alloc] init];
localMedia.title = @"test";
localMedia.name = @"test";
NSString *mp4Path = [[NSBundle mainBundle]pathForResource:@"test" ofType:@"mp4"];
NSString *imagePath = [[NSBundle mainBundle]pathForResource:@"226.jpg" ofType:nil];
localMedia.mediaUrl = mp4Path;
localMedia.thumbnailUrl = imagePath;
localMedia.videoDescription = @"shahjahjkasjkg";
localMedia.id = [[NSUUID UUID]UUIDString];
localMedia.createdAt = [NSDate date];
localMedia.size = 36841966;
localMedia.duration = 130;
localMedia.width = [UIScreen mainScreen].bounds.size.width;
localMedia.height = [UIScreen mainScreen].bounds.size.width;
localMedia.mediaType = @"videos";

//如果是需要标定参数的视频,需要按如下要求传
localMedia.calibrationData = @"version=v1&type=1&data=0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.,0.0,0.0,0.0,0.0;0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0"; //第二组;

//如果MediaInfo没有 ,需要创建MediaInfo
CDACamdoraMediaInfo *mediaInfo = [CDACamdoraMediaInfo creatMediaInfoWithPicNum:CDAPicNum_2D width:1080 height:1080 fov:CDAFov_185 order:CDACamdoraMediaInfoOrderLeft2Right orientation:CDAOrientation_90 mount:CDACamdoraMediaInfoMountDesktop projection:CDACamdoraMediaInfoProjectionFisheye needStitch:YES fps:30];
localMedia.camdoraMediaInfo = mediaInfo;


[[CDAAPIManager sharedManager]releaseMediaByLocalMedia:localMedia MediaType:CDABeLongToMe_Video image:nil success:^(id result) {

[SVProgressHUD showSuccessWithStatus:@"发布成功"];
} uploadProgress:^(int64_t bytesSent, int64_t totalByteSent, int64_t totalBytesExpectedToSend) {
float percent = 0.8 + 0.2 * totalByteSent / totalBytesExpectedToSend;

[SVProgressHUD showProgress:percent];

} failure:^(NSError *error) {
[SVProgressHUD showErrorWithStatus:@"发布失败"];

}];


}

---

---

取消发布

函数定义

- (void)cancelReleaseWithMediaId:(nonnull NSString *)mediaId isPublish:(BOOL)isPublish success:(nonnull APISuccessBlock)success failure:(nonnull APIFailureBlock)failure;

参数说明

• mediaId - 视频获取图片ID
• isPublish - NO = 取消发布
• success - 成功回调
• failure - 失败回调

示例

- (IBAction)clickCancelReleaseButton:(id)sender {

CDAVideo *video = self.videos.firstObject;

[[CDAAPIManager sharedManager]cancelReleaseWithMediaId:video.id isPublish:NO success:^(id  _Nonnull result) {

} failure:^(id  _Nonnull error) {

}];

}