# 小程序信息管理
这个模块主要是获取小程序信息的一些Api介绍。
# 1. 搜索小程序
要搜索小程序,需要两步:
- 确保在初始化SDK的时候,配置了该服务器信息;
- 调用该api搜索小程序
/// 搜索小程序
/// @param request 搜索的request
/// @param completion 搜索结果
- (void)searchAppletsWithRequest:(FATSearchAppletRequest *)request
completion:(void (^)(NSDictionary *result, FATError *aError))completion;
示例代码:
FATSearchAppletRequest *searchRequest = [[FATSearchAppletRequest alloc] init];
searchRequest.apiServer = @"https://api.finclip.com";
searchRequest.text = @"小程序";
[[FATClient sharedClient] searchAppletsWithRequest:searchRequest completion:^(NSDictionary *result, FATError *aError) {
NSLog(@"");
}];
# 2. 获取小程序对象信息
/// 获取当前正在运行的小程序对象
- (FATAppletInfo *)currentApplet;
# 3. 获取小程序当前WebView信息
# 3.1 获取当前webView的URL
如果当前页面加载的不是H5,则会返回nil;如果加载的是H5,则会返回H5对应的NSURL。
/**
获取当前加载H5的URL
如果小程序当前页面加载的不是H5,则返回nil
*/
- (NSURL *)getCurrentWebViewURL;
# 3.2 获取当前webView的UserAgent
/**
获取小程序当前页面webView的userAgent
*/
- (void)getCurrentWebViewUserAgentWithCompletion:(void (^)(NSString *userAgent, NSError * error))completionHandler;
# 4. 获取小程序页面截图
注意:这里生成的截图的宽高比是5:4。会从导航栏以下(0,0)绘制开始截取。
/**
生成当前页面截图
*/
- (UIImage*)getCurrentAppletImage;
# 5. 获取使用过的小程序列表
获取打开过的所有小程序列表,已删除的小程序不包含。
/**
获取本地的小程序
@return 小程序数组<FATAppletInfo>
*/
- (NSArray *)getAppletsFromLocalCache;
# 6. 微信小程序二维码信息转换为FinClip小程序
/// 解析微信小程序二维码,得到凡泰小程序信息
/// @param qrCode 微信二维码
/// @param apiServer 解析服务器url
/// @param completion 结果回调
- (void)parseAppletInfoFromWXQrCode:(NSString *)qrCode apiServer:(NSString *)apiServer completion:(void (^)(FATAppletSimpleInfo *appInfo, FATError *aError))completion;
该API的使用场景是当某小程序在微信和FinClip服务上都上架之后,可以在FinClip平台关联微信的小程序。这时FinClip平台上的线上版二维码,既可以用微信扫码打开,也可以用 FinClip App 或其他集成了FinClip 小程序 SDK的APP扫码打开。
流程是先扫描该二维码,得到二维码内容,然后调用该接口获取FinClip 小程序id,最后调用打开小程序的API即可。
# 7. 个人信息与权限管理页面
展示打开过的小程序使用的个人信息和权限
/// 打开个人信息与权限管理页面
/// @param parentViewController 父控制器,打开的个人信息与权限管理页面会在父控制器上模态弹出
- (void)openPrivacyManage:(UIViewController *)parentViewController;