前提条件
客户端接入前，需完成新建验证，并在验证列表获取所需的 CaptchaAppId 以及 AppSecretKey。步骤如下：
1. 登录 验证码控制台，左侧导航栏选择图形验证 > 验证管理，进入验证管理页面。
2. 单击新建验证，根据业务场景需求，设置验证名称、客户端类型、验证方式等参数。
3. 单击确定，完成新建验证，即可在验证列表中查看验证码 CaptchaAppId 及 AppSecretKey。
接入步骤
注意
App 客户端（Android/iOS/Harmony）当前仅支持通过 WebView 引入 H5页面进行接入。
iOS 接入主要流程
1. 在 iOS 中打开 WebView，通过 JSBridge 触发 HTML 页面 ，同时注入方法，供 HTML 调用传入验证结果。
2. 在 HTML 页面中接入验证码，详细请参见 Web 客户端接入，通过调用验证码 JS，渲染验证页面，并调用 iOS 注入的方法传入验证结果。
3. 通过 JSBridge 将验证结果返回到 iOS，并把相关参数（票据 ticket、随机数等）传入业务侧后端服务进行票据验证，详情请参见 接入票据校验(Web及App)。
iOS 接入的详细操作步骤
1. 在控制器或 view 中导入 WebKit 库。
#import <WebKit/WebKit.h>
2. 创建 WebView 并渲染。
-(WKWebView *)webView{if(_webView == nil){//创建网页配置对象WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];// 创建设置对象WKPreferences *preference = [[WKPreferences alloc]init];//设置是否支持 javaScript 默认是支持的preference.javaScriptEnabled = YES;// 在 iOS 上默认为 NO，表示是否允许不经过用户交互由 javaScript 自动打开窗口preference.javaScriptCanOpenWindowsAutomatically = YES;config.preferences = preference;//这个类主要用来做 native 与 JavaScript 的交互管理WKUserContentController * wkUController = [[WKUserContentController alloc] init];//注册一个name为jsToOcNoPrams的js方法 设置处理接收JS方法的对象[wkUController addScriptMessageHandler:self name:@"jsToOcNoPrams"];[wkUController addScriptMessageHandler:self name:@"jsToOcWithPrams"];config.userContentController = wkUController;_webView = [[WKWebView alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT) configuration:config];// UI 代理_webView.UIDelegate = self;// 导航代理_webView.navigationDelegate = self;//此处即需要渲染的网页NSString *path = [[NSBundle mainBundle] pathForResource:@"JStoOC.html" ofType:nil];NSString *htmlString = [[NSString alloc]initWithContentsOfFile:path encoding:NSUTF8StringEncoding error:nil];[_webView loadHTMLString:htmlString baseURL:[NSURL fileURLWithPath:[[NSBundle mainBundle] bundlePath]]];}return _webView;}[self.view addSubview:self.webView];
3. 代理方法，处理一些响应事件。
// 页面开始加载时调用-(void)webView:(WKWebView *)webView didStartProvisionalNavigation:(WKNavigation *)navigation {}// 页面加载失败时调用-(void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error {[self.progressView setProgress:0.0f animated:NO];}// 当内容开始返回时调用-(void)webView:(WKWebView *)webView didCommitNavigation:(WKNavigation *)navigation {}// 页面加载完成之后调用-(void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation {[self getCookie];}//提交发生错误时调用-(void)webView:(WKWebView *)webView didFailNavigation:(WKNavigation *)navigation withError:(NSError *)error {[self.progressView setProgress:0.0f animated:NO];}// 接收到服务器跳转请求即服务重定向时之后调用-(void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(WKNavigation *)navigation {}
4. JS 将参数传给 OC。
<p style="text-align:center"> <button id="btn2" type = "button" onclick = "jsToOcFunction()"> JS调用OC：带参数 </button> </p>function jsToOcFunction(){window.webkit.messageHandlers.jsToOcWithPrams.postMessage({"params":"res.randstr"});}
5. 将渲染好的 WebView 展示在视图上，调用验证码服务，将数据传给客户端。
-(void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message{//此处message.body即传给客户端的json数据//用message.body获得JS传出的参数体NSDictionary * parameter = message.body;//JS调用OCif([message.name isEqualToString:@"jsToOcWithPrams"]){//在此处客户端得到js透传数据 并对数据进行后续操作parameter[@"params"]}}
注意
常见问题
更多信息
