AIQKit iOS SDK
AIQKit iOS SDK 为您提供对强大的 AIQ Vision Search 平台的访问,以便集成到您的 iOS 应用中。
安装
使用 CocoaPods
使用 CocoaPods,将其添加到您的 podfile 中
pod 'AIQKit'
运行 pod install
下载 SDK 并将其安装到您的项目中,包括 SDK 的依赖项。
初始化
所需
在您的应用程序代理类中,使用从AIQ开发者门户获取的App ID和密钥初始化SDK
#import "iQKit.h"
[iQKit setAppID:@"APP-ID"
andAppSecret:@"APP-SECRET"];
可选
为了获得最佳结果,请报告一些关于用户的其他信息
[iQKit setUserAge:@(42)];
[iQKit setUserGender:@"f"];
年龄和性别可随时通过以下功能进行更新。
用法
视觉搜索
要启动一次视觉搜索,将以下代码添加到合适的视图控制器中
iQScannerViewController *scannerViewController = [[iQScannerViewController alloc] init];
scannerViewController.delegate = self;
[self presentViewController:scannerViewController animated:NO completion:nil];
搜索完成后,您将通过
- (void)scannerViewController:(iQScannerViewController *)scannerViewController didLoadSearchResponse:(iQAPISearchResponse *)searchResponse
{
[self dismissViewControllerAnimated:YES completion:^{
NSLog(@"Payload URL: %@", searchResponse.payload);
}];
}
在回调中,iQAPISearchResponse对象有一个payload属性,它是由搜索返回的URL。使用这个URL,通常用于加载Web视图或在iQNECT应用中打开。
图片搜索
这和关键字搜索相同,只是参数类型为UIImage
。
[[iQAPISearchRequest requestWithImage:image] runWithCompletionHandler:^(iQAPISearchResponse *response) {
NSLog(@"Payload: %@", response.payload);
}];
资源要求
由于SDK需要访问相机和照片库,您需要在项目的info.plist文件中声明这两个密钥
- 隐私 - 相机使用说明 ----> 此应用需要访问您的相机
- 隐私 - 照片库使用说明 ----> 此应用需要访问您的照片
FAQ
- 错误信息:"此应用程序试图访问隐私敏感数据但没有使用描述。应用程序的Info.plist必须包含一个NSPhotoLibraryUsageDescription键,并使用字符串值向用户说明应用程序如何使用此数据。" 这是由缺少隐私资源声明引起的,请参阅“资源要求”部分