iOS_SDK

更新时间：2021-08-20

简介

本文档描述货架拼接iOS SDK如何使用。

系统支持

系统：iOS 9.0 以上

硬件：armv7 arm64 (Starndard architectures) （暂不支持模拟器）

Release Notes

时间	版本	说明
2021.03.09	3.0.1	新增光线和手机方向检测功能
2020.12.30	3.0.0	新增支持拍摄图片，云端拼接功能
2020.11.12	2.0.0	新增支持排面统计占比
2019.08.30	1.0.0	支持拍摄视频，端上抽帧，云端拼接

集成说明

货架拼接SDK全部为源代码，包括体验APP的UI部分和Http接口、重合度算法接口的定义和使用。没有打包动态库和静态库。用户拷贝相关功能代码至项目中即可，并修改相应文件名以避免符号冲突。

体验APP使用

SDK的工程结构如下：

${SDK_ROOT}
  ├─ EasyDLStitch  // Demo工程文件
  ├─ images         // 资源文件
  ├─ RES         // 配置文件

获取鉴权

进入EasyDL零售版的百度智能云控制台应用列表页面，如下图所示：

如果还未创建应用，请点击「创建应用」按钮进行创建。创建应用后，参考鉴权参考文档，使用API Key(AK)和Secret Key(SK)获取access_token

下载SDK包后，填写ak、sk等信息。在RES/conf.json相应位置填入：

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

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

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

视频拼接参数设置

体验APP中对视频截取帧的频率为1秒1帧，由于每个视频的帧数不能大于60，所以体验APP不能拼接长度大于60s的视频。开发者可根据实际情况调整截帧的频率，并相应限制视频长度。调整频率方法为修改easydl-stitch-ios/ViewController/StitchViewController.m中：

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

并在合适的地方提示视频长度限制：

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

图片拼接参数设置

体验APP中提供了图片拼接的摄像头代码和获取图片重合度算法的c++代码。通过调节摄像头和算法的参数，获取最佳的拍摄效果和拼接效果。修改easydl-stitch-ios/ViewController/ImagePickerViewController.mm：

// 以下为用户自定义配置
#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帧比对一次
#define kBrightnessLow -3 // 光线强度暗度阈值，-99~99之间
#define kBrightnessHigh 5 // 光线强度亮度阈值，-99~99之间
#define kBrightnessControl false // 是否光线符合要求才可以拍照

参数说明：

获取重合度有"ahash","phash","dhash"三种算法，返回0~100之间的数值，越大表示重合度越高。不同算法返回的数值有区别，需相应调整阈值
手机倾斜XY轴指左右倾斜，Z轴是前后倾斜，当倾斜角度过大会影响拼接效果
设置只有手机倾斜角度、待拍摄图片与上一张图片重合度、环境光线亮度等条件符合要求才拍摄图片，保证拍摄效果
相机默认为每秒30帧，修改kSkipFrames的值调节做重合度对比的速度，避免卡顿或拍摄状态切换过快

拼接API调用流程

创建任务：开始拼接整个流程
加货架图：上传图片
开始任务：启动货架拼接离线任务
查询任务：查询拼接任务的状态和结果

其他：

取消任务：取消正在进行或者等待的任务
任务列表：查询所有状态的任务列表
终止任务：终止正在进行或者等待的任务