一、前提条件
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"]}}
注意：业务客户端完成验证码接入后，服务端需二次核查验证码票据结果（未接入票据校验，会导致黑产轻易伪造验证结果，失去验证码人机对抗效果），详情请参见 接入票据校验（Web 及 App）。
五、常见问题
详情参见 接入相关问题。
六、更多信息
你可以登录 验证码控制台，在页面右下角单击快速咨询，了解更多详细信息。