移动应用微信图像接口开发指南 (iOS版)

使用说明

本文档主要介绍微信图像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+开发文档。