tencent cloud

dependencies {	
implementation fileTree(dir: 'libs', include: ['*.aar'])
}
defaultConfig {    
ndk {        
abiFilters "armeabi-v7a", "arm64-v8a"
}
}

<WebView    
android:id="@+id/tcaptchaWebview"    
android:layout_width="match_parent"    
android:layout_height="match_parent"/>

// Initialize
TencentCaptchaConfig.BuilderconfigBuilder =new
TencentCaptchaConfig.Builder(getApplicationContext(),
newITencentCaptchaPrivacyPolicy(){...},
newICaptchaDeviceInfoProvider(){...});
RetCoderet =TencentCaptcha.init(config.build());
...
// Required parameters
TencentCaptchaParam.BuildertencentCaptchaBuilder =new
TencentCaptchaParam.Builder
()
.setWebView(tcaptchaWebView)
.setCaptchaAppid(CaptchaAppid);
// Business start
TencentCaptcha.start(callback,tencentCaptchaBuilder.build());

TencentCaptchaCallback callback = new TencentCaptchaCallback() {    
@Override    
public void finish(RetCode ret, JSONObject resultObject) {...}    

@Override    
public void exception(Throwable t) {...}
};

/*** 
Initialize with the built configuration
*
* @param TencentCaptchaConfig
* @return RetCode
*/
RetCode init(TencentCaptchaConfig);
/** 
* Start Captcha detection
*
* @param TencentCaptchaCallback 
* @param TencentCaptchaParam 
* @return RetCode 
*/
RetCode start(TencentCaptchaCallback, TencentCaptchaParam);
/**
* Interrupt detection process
*/
void stop();

/**
* Create a TencentCaptcha.Builder object.
*
* @param Context
* @param ITencentCaptchaPrivacyPolicy API instance, [must pass implementation], any API call of the SDK will use this instance to ask the user if they have agreed to the privacy policy
* @param ICaptchaDeviceInfoProvider API instance, pass ANDROIDID, used for the validity check of the device identifier itself and to identify abnormal device environments to detect device risks*/
*/
Builder(Context, ITencentCaptchaPrivacyPolicy,
 ICaptchaDeviceInfoProvider);

/**
* Callback when Captcha verification ends, notifying the host to obtain verification ticket and other information.
*
* @param RetCode, when RetCode is not OK, please refer to [retcode values] section
* @param JSONObject, when RetCode is OK, please refer to [JSONObject return values] section for information
*/
void finish(RetCode, JSONObject);
/**
* Callback when an exception occurs in the SDK working thread
*
* @param Throwable
*/
void exception(Throwable);

/**
* Create a TencentCaptchaParam.Build object.
*
* @return TencentCaptchaParam
*/
TencentCaptchaParam build();
/**
* Set the CaptchaAppid, obtained from the tencent cloud console. Without this, the SDK will not work properly.
*
* @param String, CaptchaAppid.
* @return Build
*/
Builder setCaptchaAppid(String);
/**
* Set the WebView to display the Captcha.
*
* @param webView
* @return Builder
*/
Builder setWebView(WebView);

TencentCaptchaConfig.Builder configBuilder = new 
TencentCaptchaConfig.Builder(
    getApplicationContext(),
    new ITencentCaptchaPrivacyPolicy() {
        @Override
        public boolean userAgreement() {
            // Authorization Passed
            // true indicates authorization passed, the SDK can be used normally
           // false indicates unauthorized, subsequent calls to the start method will throw an exception
return false;
}
},
new ICaptchaDeviceInfoProvider() {
@Override
public String getAndroidId() {
return androidId; // Implementation to get AndroidId                
}
}
);

// Initialize the SDK
RetCode ret = TencentCaptcha.init(configBuilder.build());
if(ret == RetCode.OK) {
    // Initialized successfully
} else {
    // Initialization failed
    log.error("ret code: " + ret.getCode() + " msg:" + ret.getMsg()); }

TencentCaptchaCallback callback = new TencentCaptchaCallback() {    
@Override    
public void finish(RetCode ret, JSONObject resultObject) {        
if (ret == RetCode.OK) {            
// Success, execute business logic                
} else {            
// Failed            
log.error("code:" + ret.getCode() + " msg:" + ret.getMsg());        
}    
}    
@Override    
public void exception(Throwable t) {       
// Abnormal        
t.printStackTrace();    
}
};

TencentCaptchaParam.Builder paramBuilder = new 
TencentCaptchaParam.Builder()    
.setWebView(tcaptchaWebView)       // required, WebView to display Captcha    
.setCaptchaAppid("CaptchaAppid"); // required, CaptchaAppid

TencentCaptcha.start(callback, paramBuilder.build());

@Override
protected void onPause() {    
super.onPause();    
TencentCaptcha.stop();}

/**
* Get Error Code
*
* @return int
*/
int getCode();
/**
* Get Detailed Error Information
*
* @return String
*/
String getMsg();

/**
* Custom pass-through parameters, this field can be used by the business to pass a small amount of data, and the content of this field will be included in the callback object.
*
* @param Object
* @return Builder
*/
Builder setBizState(Object);
/**
* true: Enable adaptive night mode.
*
* @param boolean
* @return Builder
*/
Builder setEnableDarkMode(boolean);
/**
* "force": Enable forced night mode.
*
* @param String
* @return Builder
*/
Builder setEnableDarkMode(String);
/**
* false: Hide the help button.
*
* @param boolean
* @return Builder
*/
Builder setNeedFeedBack(boolean);
/**
* Custom help link: "URL".
*
* @param String
* @return Builder
*/
Builder setNeedFeedBack(String);
/**
* Specify the language of the Captcha prompt text, which takes precedence over console configuration.
* Supports passing the same value as navigator.language, the user's preferred language, case-insensitive.
* For details, see https://www.tencentcloud.com/zh/document/product/1159/49680?lang=zh&pg=#userLanguage.
*
* @param String
* @return Builder
*/
Builder setUserLanguage(String);
/**
* true: enable aging adaptation
* false: disable aging adaptation
*
* @param boolean
* @return Builder
*/
Builder setEnableAged(boolean);
/**
* Define the Captcha display method.
* popup: (default) Popup, displays the Captcha in a centered floating layer.
* full: Full Screen
*
* @param String
* @return Builder
*/
Builder setType(String);
/**
* Whether to show loading box during Captcha loading. If this parameter is not specified, the loading box is shown by default.
* true: show loading box
* false: do not show loading box
*
* @param boolean
* @return Builder
*/
Builder setLoading(boolean);
/**
* Set CaptchaAppId encrypted verification string, see encryption verification capability access guide for details
*
* @param String
* @return Builder
*/
Builder setAidEncrypted(String);
/**
* Callback for some internal Captcha information, see [TencentCaptchaParam.OptionsCallback description] for details.
*
* @param OptionsCallback
* @return Builder
*/
Builder setOptionsCallback(OptionsCallback);

/**
* Support flexible settings for corresponding key and value.
*
* @param String, corresponding key value
* @param Object, corresponding value
* If you set the key to enableAutoCheck and the value to true to enable it, auto-completion of verify selection for safe requests can be automatically performed, no action required by the user. Disabled by default if not set.
* @return
*/
Builder setExtractParameter(String, Object);

/**
* 1. When optFuncName is ready,
*   data returns the callback when the Captcha is loaded, with the actual width and height of the Captcha (unit: px):
*   {"sdkView": {
*       "width": number,
*       "height": number
*    }}
*   This parameter is only for viewing the Captcha dimensions, do not use this parameter to set the dimensions directly.
* 2. When optFuncName is showFn, data returns duration, rendering time + sid information.
*
* @param optFuncName, String
* @param data, String
*/
void onCallback(String optFuncName, String data); result callback, return value