iOS_SDK

// easydl-stitch-ios/EasyDLStitch/EasyDLStitchParams.h

#define kThreshold 75 // 判断重合的阈值,0~100之间
#define kStrategy "phash" // 重合算法,类型：["ahash","phash","dhash"]
#define kThetaZ 60 // 手机倾斜Z轴角度阈值
#define kThetaXY 20 // 手机倾斜XY轴角度阈值
#define kOverLapControl true // 是否与遮罩重合才可以拍照
#define kOrientationControl true // 是否手机持握方向符合要求才可以拍照
#define kSkipFrames 3 // 跳过视频帧比对的数量，比如3为每3帧比对一次
#define kBrightnessLow -3 // 光线强度阈值，-99~99之间
#define kBrightnessHigh 5 // 光线强度阈值，-99~99之间
#define kBrightnessControl false // 是否光线符合要求才可以拍照

// easydl-stitch-ios/ViewController/StitchViewController.m

static int frameInterval = 1;//截帧间隔（秒）

UIAlertController *actionSheet = [UIAlertController alertControllerWithTitle:@"选择对象(视频长度不能超过60s)" message:nil preferredStyle:UIAlertControllerStyleActionSheet];

EasyDL-Image-Stitching-iOS
|- LIB
    |- include
        |- montage_algo/ // 手机端实时拼接功能库头文件
        |- EasyDL/       // 手机端实时拼接模糊图像检测引擎头文件
        |- paddlelite/   // 手机端实时拼接模糊图像检测引擎头文件
    |- libs
        |- opencv2.framework 		        // OpenCV库
        |- libmontage_algo.a 		        // 手机端实时拼接功能库
        |- libEasyDL.a                  // 手机端实时拼接模糊图像检测引擎
        |- libpaddle_api_full_bundled.a // 手机端实时拼接模糊图像检测引擎
|- EasyDLStitch
    |- images/              // 资源文件
    |- easydl-stitch-ios/   // Demo工程文件
    |- RES/
        |- conf.json       // API配置文件
        |- fuzzy_model/    // 模糊图像检测模型

{
  "ak": "Mz0zhObvEZ6lnG1K3renXXXX", // API Key的值

  "sk": "188fRHYvLPmlPrNCDpBnkhL3ydXXXXX", // Secret Key的值

  "apiUrl": "https://aip.baidubce.com/rpc/2.0/ai_custom_retail/v1/detection/XXXX"  // 定制商品检测服务API
}

- (void)createSpliceTaskWithConfig:(NSDictionary *)config successHandler:(SuccessBlock)successHandler failHandler:(FailureBlock)failHandler;

- (void)uploadImageWithConfig:(NSDictionary *)config successHandler:(SuccessBlock)successHandler failHandler:(FailureBlock)failHandler;

-(void)startSpliceTaskWithConfig:(NSDictionary *)config successHandler:(SuccessBlock)successHandler failHandler:(FailureBlock)failHandler;

-(void)queryTaskResultWithConfig:(NSDictionary *)config successHandler:(SuccessBlock)successHandler failHandler:(FailureBlock)failHandler;

-(void)listTaskWithConfig:(NSDictionary *)config successHandler:(SuccessBlock)successHandler failHandler:(FailureBlock)failHandler;

-(void)terminateTaskWithConfig:(NSDictionary *)config successHandler:(SuccessBlock)successHandler failHandler:(FailureBlock)failHandler;

- (void)prepare;

// 调用示例
[[EasyDLMBStitchApiService sharedService] prepare];

- (void)compareImage:(UIImage *)image firstFrame:(BOOL)isFirstFrame completionHandler:(CompletionHandler)completionHandler;

// 调用示例
[[EasyDLMBStitchApiService sharedService] compareImage:image firstFrame:_firstFrameCompare completionHandler:^(id responseObject, NSError *error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    } else {
      	// 回调结果
        CompareResult *compareResult = responseObject;
      	// do something
    }
}];

// montage_algo/EasyDLStitchAlgo.h

// 当前图片相对上一张参与拼接的图片的方位
@property(nonatomic) ImageDirection direction;
/**
 * 是否需要判断方向，如当拍摄完图片过近时，direction可能由于两图过于相似而不可靠，这种情况不需要判断方向，即该值=false
 * 一般direction不可靠时，该值=false
 * 对比的两张图是第一次对比时，该值=false
 * 当该值=true时，请在调用实时拼接API前确认方法是否合法，否则可能导致拼接失败
 */
@property(nonatomic, getter = needCheckDirection) BOOL checkDirection;
// 对比结果中的方位是否合法，非法的方位将无法完成拼接
@property(nonatomic) BOOL directionValid;
// 两张图片重叠部分的点位
@property(nonatomic, retain) NSArray<NSValue *> *points;
// 两张图片重叠状态
@property(nonatomic) OverlapStatus overlapStatus;
// 最后一次参与拼接的图片序号，从1开始
@property(nonatomic) int lastImgIndex;

switch (compareResult.overlapStatus) {
    case OverlapStatus_Correct:
        if (compareResult.needCheckDirection && !compareResult.directionValid) {
            // 非法，当前参与对比的图片方位不正确，无法拼接
        } else {
            // 合法
        }
        break;
    case OverlapStatus_TooFar:
        // 非法，两张图重叠度过低
        break;
    case OverlapStatus_TooClose:
        // 非法，两张图重叠度过高
        break;
}

- (void)stitchImageWithCompareResult:(CompareResult *)compareResult completionHandler:(CompletionHandler)completionHandler;

// 调用示例
[[EasyDLMBStitchApiService sharedService] stitchImageWithCompareResult:_latestCompareResult completionHandler:^(id responseObject, NSError *error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    } else {
      	// 回调结果
        StitchResult *stitchResult = responseObject;
      	// do something
    }
}];

// 保存now.jpg示例
NSURL *workDirUrl = [EasyDLMBStitchApiService sharedService].currentTask.workDir;
/* 小图为拼接，大图为获得更好的商品检测效果 */
[EasyDLFileManager saveImage:image toUrl:[workDirUrl URLByAppendingPathComponent:FILENAME_IMAGE_NOW] andResizeTo:CGSizeMake(648, 864)];
// SDK默认使用保存的一系列`{index}.jpg`调用商品检测API并取得结果。
// 由于建议减小该系列图片尺寸以获得更优的拼接效率，但同时更小尺寸的图片对商品检测精度有一定影响，因此为提高精度，建议同时保存最佳尺寸的图片用于上传云端。
[EasyDLFileManager saveImageForBestInfer:image toUrl:[workDirUrl URLByAppendingPathComponent:[NSString stringWithFormat:@"%@/%@", DIR_NAME_FULL_IMAGE, FILENAME_IMAGE_NOW]]];

// montage_algo/EasyDLStitchAlgo.h

// 拼接错误码，0表示成功，其他为错误
@property(nonatomic) int errCode;
// 最近一张参与拼接的图片的序号
@property(nonatomic) int latestImgIndex;
// 缩略拼接图路径
@property(nonatomic, retain) NSURL *thumbnailUrl;
// 完整拼接图路径
@property(nonatomic, retain) NSURL *fullImageUrl;

// easydl-montage-ios/EasyDLStitch/EasyDLMBStitchApiService.h

@protocol EasyDLMBAPIStitchDelegate <NSObject>
- (void)onStitchThumbnailGenerated:(NSURL *)thumbnailURL;
- (void)onStitchFullImageGenerated:(NSURL *)fullImageURL;
@end
  
// 配置示例
[EasyDLMBStitchApiService sharedService].stitchDelegate = self;

- (void)mergeDetectedResultsWithCompletionHandler:(CompletionHandler)completionHandler;

// 调用示例
[[EasyDLMBStitchApiService sharedService] mergeDetectedResultsWithCompletionHandler:^(id responseObject, NSError *error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    } else {
      	// 回调结果
        MergeResult *mergeResult = responseObject;
      	// do something
    }
}];

// montage_algo/EasyDLStitchAlgo.h

// 错误码，0表示成功，其他为错误
@property(nonatomic) int errCode;
// 商品检测并去重合并后的结果
@property(nonatomic, retain) NSDictionary *correctSKUDict;

// easydl-montage-ios/EasyDLStitch/EasyDLMBStitchApiService.h

@protocol EasyDLMBAPIMergeDelegate <NSObject>
- (void)onMergeResultsStarted:(int)totalImageCount;
- (void)onMergeProgressUpdated:(int)totalImageCount completedCount:(int)completedCount;
@end
  
// 配置示例
[EasyDLMBStitchApiService sharedService].mergeDelegate = self;

- (void)undoLastTakenImageWithCompletionHandler:(CompletionHandler)completionHandler;

// 调用示例
[[EasyDLMBStitchApiService sharedService] undoLastTakenImageWithCompletionHandler:^(id responseObject, NSError *error) {
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    } else {
      	// 回调结果，包含撤销后，当前最后一次参与拼接的图片信息
        ImageInfo *lastImageInfo = responseObject;
      	// do something
    }
}];

// easydl-montage-ios/EasyDLStitch/EasyDLMBStitchApiService.h

// 图片序号
@property(nonatomic) int index;
// 图片列坐标
@property(nonatomic) int x;
// 图片行坐标
@property(nonatomic) int y;

// 模型初始化
- (NSError *)modelInit;
// 推理图像判断是否模糊
- (void)inferImage:(UIImage *)image completionHandler:(void (^)(BOOL fuzzy, NSError *error))completionHandler;

// 调用示例
FuzzyModelProxy *fuzzyModelProxy = [[FuzzyModelProxy alloc] init];
[fuzzyModelProxy modelInit];
if (fuzzyModelProxy && fuzzyModelProxy.engineActive) {
    [fuzzyModelProxy inferImage:image completionHandler:^(BOOL fuzzy, NSError *error) {
        if (!error && !fuzzy) {
            // 图像非模糊
        } else {
            // 图像模糊或推理失败
        }
    }];
}

// easydl-montage-ios/EasyDLStitch/EasyDLMBStitchApiService.h

/**
 * 最小拼接引导置信度
 */
@property(nonatomic) CGFloat minIOUThreshold;
/**
 * 最大拼接引导置信度
 */
@property(nonatomic) CGFloat maxIOUThreshold;
/**
 * 去重置信度
 */
@property(nonatomic) CGFloat nmsIOUThreshold;
/**
 * 商品检测API重试次数
 */
@property(nonatomic) int detectRetryTimes;
/**
 * 商品检测API最大并发数
 */
@property(nonatomic) int maxQPS;