使用说明
本文档主要介绍微信图像SDK(iOS版)使用方法,利用SDK可以准确搜索到用户上传的图像。
本文属于入门级文档,旨在帮助开发者快速学习iOS SDK的使用并应用到自身开发工作。具体 API 可到“资源下载 ”页下载《微信图像SDK(iOS版)开发手册》进行查询。
准备工作
第一步 创建移动应用
请到“管理中心”创建移动应用,点击“创建移动应用”,填写相关资料,然后将该应用提交审核,只有审核通过的应用才能进行开发。
注册完毕,我们会在 7 个工作日内完成审核工作。 审核通过之后,开放平台将分配给该移动应用全局唯一的AppID。
第二步 下载iOS SDK
进入“资源中心”的“资源下载”页,下载iOS SDK,压缩包中包括Demo+SDK+开发文档。其中的Demo使用SDK的各功能API;SDK包括.h和.a文件。
第三步 上传图片
每个 AppID 只能检索到自身上传的图片,图片上传位置:资源中心–>图像识别图片库,待图片审核通过,即可对此图片进行识图操作。
Demo介绍
为了更好的理解微信图像SDK的使用,下面将通过一个简单的实例来讲解一下 SDK各个关键 API接口的使用。
1. 工程配置
i. 导入 SDK 文件
WXImageSearch.h
libWXImageSearch.a
libmtaWXOsdk.a
ii. 引入系统框架
CoreTelephony.framework
SystemConfiguration.framework
libz.dylib
libsqlite3.dylib
iii. 设置 Build Settings
C++ Standard Library: libstdc++ 或 Compiler Default
Compile Sources As: Objective-C++ 或 将使用 SDK 的文件扩展名改为.mm
iv. 与其它SDK 冲突
如果与其它含有libmtaWXOsdk.a 文件的SDK 冲突,则删除多余的libmtaWXOsdk.a 文件即可。
2. SDK调用流程
i. 初始设置
[[WXImageSearch sharedImageSearch] setDelegate:self];
[[WXImageSearch sharedImageSearch] setAppID:@"***appID***"];
ii. 开始识别图像
[[WXImageSearch sharedImageSearch] startWithImage:image];
iii. 识别到结果的回调
- (void)imageSearchResultArray:(NSArray *)resultArray{
if (resultArray) {
NSLog(@"resultArray.count=%d", resultArray.count);
WXImageSearchResult *result = [resultArray objectAtIndex:0];
_resultLabel.text = @"";// @"识别成功";
[self.navigationItem setTitle:@"识别成功"];
_picDescLabel.text = [NSString stringWithFormat:@"picDesc:%@", result.picDesc];
_md5Label.text = [NSString stringWithFormat:@"MD5:%@",result.md5];
[self performSelectorInBackground:@selector(setImageUrl:) withObject:result.url];
} else {
_resultLabel.text = @"未找到对应图片";
[self.navigationItem setTitle:@"识别失败"];
}
}
iv. 出现错误的回调
- (void)imageSearchMakeError:(NSInteger)error{
_resultLabel.text = [NSString stringWithFormat:@"errorCode:%d",error];
[self.navigationItem setTitle:@"识别失败"];
}
3. 程序截图
更多内容在“资源下载”页下载SDK+Demo+开发文档。