// 请在任何调用腾讯验证码服务的逻辑之前设置Captcha App ID
TencentCaptcha.setup { config in
// 请使用您的验证码App ID替换__YOUR_CAPTCHA_APP_ID__
   config.appID = __YOUR_CAPTCHA_APP_ID__ 
}

override func viewDidLoad() {
super.viewDidLoad()
// Do any additional setup after loading the view.
let contentController = WKUserContentController()
let config = WKWebViewConfiguration()
   config.userContentController = contentController
   webView = WKWebView(frame: self.view.bounds, configuration: config)
   webView.navigationDelegate = self
   webView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
self.view.addSubview(webView)
}

TencentCaptcha.userDidAcceptPrivacyPolicy = true

let options = TencentCaptchaOptions()
options.optionsCallback = { functionName, data in }
// TODO: 根据需要设置其它选项
TencentCaptcha.shared().requestCaptcha(withWebView: self.webView, options:options) { error, result in
    if let error = error {
    // 如果发生错误，则error为非空
    }
    else {
    // result为返回值
    }
}

let options = TencentCaptchaOptions()
        options.loadingEnabled = TencentCaptchaOptionsSwitchOn
        options.setExtractParameter(true, forName: "enableAutoCheck")

TencentCaptcha.shared().requestCaptcha(withWebView: self.webView, options:options) { error, result in
    // ...
}


/// 深夜模式选项
typedef enum : NSUInteger {
/// 默认
   TencentCaptchaOptionsDarkModeDefault,
/// 随系统开启
   TencentCaptchaOptionsDarkModeTrue,
/// 总是关闭
   TencentCaptchaOptionsDarkModeFalse,
/// 强制开启
   TencentCaptchaOptionsDarkModeForce,
} TencentCaptchaOptionsDarkMode;

/// 开关选项
typedef enum : NSUInteger {
    TencentCaptchaOptionsSwitchDefault,
    TencentCaptchaOptionsSwitchOn,
    TencentCaptchaOptionsSwitchOff,
} TencentCaptchaOptionsSwitch;

/// 验证码服务配置
/// - 用于在 `+[TencentCaptcha setupWithConfigurationHandler:]` 中配置服务
/// - SeeAlso:
///     - Objective C: `+[TencentCaptcha setupWithConfigurationHandler:]`,
///     - Swift: `TencentCaptcha.setup(configurationHandler:)`
@interface TencentCaptchaConfiguration : NSObject
 
- (nonnull instancetype)init NS_UNAVAILABLE;
 
@property (nonnull, nonatomic, copy) NSString *appID;
 
 
/// Tars服务器地址
/// - Note: 如果不清楚用途，请不要设置
@property (nullable, nonatomic, copy) NSURL *tarsServerURL;
 
/// 设置验证码页面的Host
/// - Note:
///     - 只能设置URL中的host部分，例如， `https://host/path/to/html` 中的host部分，其它部分目前不支持修改
///     - 如果host不合法，导致无法生成正确的页面URL，则该设置无效
///     - 设置为nil可以使其保持为默认值
///     - 如果不清楚用途，请不要设置
@property (nullable, nonatomic, copy) NSString *captchaPageHost;
 
/// 是否允许使用缓存的token以加速请求过程
/// - Note: 默认为YES，缓存策略能满足绝大多数场景的需求。如果您特别关注实时风险，请设置为NO
@property (nonatomic, assign) BOOL usesCacheToken;

/// 【停用，请统一使用timeout】 
/// 本地设备风险检测的请求超时时长，单位秒
@property (nonatomic, assign) NSTimeInterval timeoutForNativeRequest__attribute__((deprecated("NOT WORK! Use 'timeout' instead.")));

/// 【停用，请统一使用timeout】 
/// 本地设备风险检测的采集超时时长，单位秒
@property (nonatomic, assign) NSTimeInterval timeoutForNativePacking__attribute__((deprecated("NOT WORK! Use 'timeout' instead.")));

/// 【停用，请统一使用timeout】
/// 页面加载的超时时长，单位秒
@property (nonatomic, assign) NSTimeInterval timeoutForWebViewLoading__attribute__((deprecated("NOT WORK! Use 'timeout' instead.")));

/// 统一超时设置，单位秒，内部会进行各个阶段的超时控制分配，简化超时设置逻辑
@property (nonatomic, assign) NSTimeInterval timeout;
 
@end


/// 验证码服务的实现类
/// - 提供主要的验证码服务能力
/// - Example:
/// ```swift
/// // Step 1. 引导用户同意用户隐私协议，然后设置`userDidAcceptPrivacyPolicy`
/// TencentCaptcha.userDidAcceptPrivacyPolicy = true
/// // Step 2. 初始化SDK
/// TencentCaptcha.setup(...)
/// // Step 3. 生成WebView并配置
/// webView = WKWebView(...)
/// self.view.addSubview(webView)
/// // Step 4. 生成和展示验证码
/// TencentCaptcha.requestCaptcha(...)
///
@interface TencentCaptcha : NSObject
 
- (nonnull instancetype)init NS_UNAVAILABLE;
 
/// 验证码服务的单例
+ (nonnull instancetype)sharedService NS_SWIFT_NAME(shared());
 
/// 用户是否已同意隐私政策
/// 调用任何SDK功能前，请先引导用户同意隐私协议，然后先将此类属性设为 `YES` / `true`
/// - Example:
/// ```swift
///     // 用户同意隐私协议后
///     TencentCaptcha.userDidAcceptPrivacyPolicy = true
/// ```
/// - Warning: 用户未同意隐私协议前，SDK不提供验证码服务
@property (nonatomic, assign, class) BOOL userDidAcceptPrivacyPolicy;
 
@property (nonatomic, readonly, nonnull, class) TencentCaptchaConfiguration *configuration;
 
/// 配置服务选项
/// - Parameters:
///     - configurationHandler: 如需修改配置，请修改此回调函数中提供的configuration中的属性
///
/// - Example: 最小化设置
/// ```
/// TencentCaptcha.setup { config in
///     config.appID = __YOUR_CAPTCHA_APP_ID__ // 请使用您的验证码App ID替换__YOUR_CAPTCHA_APP_ID__
/// }
/// ```
/// - Note: 请在尽可能靠前的时机配置服务，并确保在使用服务前配置
/// - SeeAlso: `TencentCaptchaConfiguration`
+ (void)setupWithConfigurationHandler:(nonnull void(^)(TencentCaptchaConfiguration *_Nonnull))configurationHandler NS_SWIFT_NAME(setup(configurationHandler:));
 
/// 请求验证码
/// - Parameters:
///   - webView: 用于展示验证码的网页视图，需要由调用方初始化
///   - options: 验证码请求参数
///   - completionHandler: 验证结束的回调
///
/// - Example:
/// ```swift
/// TencentCaptcha.shared().requestCaptcha(withWebView: webView, options: options) { error, result in
///     if let result = result {
///         // 当token不为空时，验证码验证成功
///     }
///     else {
///         // 否则error会输出错误，具体错误域和错误号请参见文档
///     }
/// }
/// ```
///
/// - Warning: 由于某些系统限制，SDK暂时无法接收来自StoryBoard生成的WKWebView。请使用代码方式初始化一个WKWeView并传递给SDK，例如：
/// ```swfit
///     let contentController = WKUserContentController()
///     let config = WKWebViewConfiguration()
///     config.userContentController = contentController
///     webView = WKWebView(frame: self.view.bounds, configuration: config)
///     webView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
///     self.view.addSubview(webView)
/// ```
- (void)requestCaptchaWithWebView:(nonnull WKWebView *)webView options:(nullable TencentCaptchaOptions *)options withCompletionHandler:(nonnull void(^)(NSError *_Nullable error, NSDictionary *_Nullable result))completionHandler NS_SWIFT_NAME(requestCaptcha(withWebView:options:withCompletionHandler:));
 
@end