移動應用微信圖像接口開發指南 (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+開發文檔。