import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.common.profile.ClientProfile;
import com.tencentcloudapi.common.profile.HttpProfile;
import com.tencentcloudapi.common.exception.TencentCloudSDKException;
import com.tencentcloudapi.ocr.v20181119.OcrClient;
import com.tencentcloudapi.ocr.v20181119.models.*;

public class ApplyOcrToken {
    public static void main(String[] args) {
        try {
            // Instantiate an authentication object. Input parameters need to include secretId and secretKey of the Tencent Cloud account. Keep the confidentiality of the key pair.
            // The key can be obtained at https://console.tencentcloud.com/cam/capi.
            Credential cred = new Credential(
              System.getenv("TENCENTCLOUD_SECRET_ID"),
              System.getenv("TENCENTCLOUD_SECRET_KEY")
            );

            // Instantiate an HTTP option (optional). Skip it if there are no special requirements.
            HttpProfile httpProfile = new HttpProfile();
            httpProfile.setEndpoint("ocr.tencentcloudapi.com");

            // Instantiate a client option (optional). Skip it if there are no special requirements.
            ClientProfile clientProfile = new ClientProfile();
            clientProfile.setHttpProfile(httpProfile);

            // Instantiate the client object that requests the product. clientProfile is optional.
            OcrClient client = new OcrClient(cred, "ap-singapore", clientProfile);

            // Instantiate a request object. Each API will correspond to a request object.
            ApplyOcrTokenRequest req = new ApplyOcrTokenRequest();
            req.setNationality("HKG");
            req.setCardType("ID_CARD");
            req.setReturnHeadImage(true);

            // The returned resp is an instance of ApplyOcrTokenResponse, corresponding to the request object.
            ApplyOcrTokenResponse resp = client.ApplyOcrToken(req);

            // Output a string packet in JSON format.
            System.out.println(ApplyOcrTokenResponse.toJsonString(resp));

            String sdkToken = resp.getSdkToken();
            String encryptedConfig = resp.getEncryptedConfig();
            System.out.printf("SdkToken: %s, EncryptedConfig: %s", sdkToken, encryptedConfig);
        } catch (TencentCloudSDKException e) {
            System.out.println(e.toString());
        }
    }
}

import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.common.profile.ClientProfile;
import com.tencentcloudapi.common.profile.HttpProfile;
import com.tencentcloudapi.common.exception.TencentCloudSDKException;
import com.tencentcloudapi.ocr.v20181119.OcrClient;
import com.tencentcloudapi.ocr.v20181119.models.*;

public class GetOcrVerificationResult {
    public static void main(String[] args) {
        try {
            // Instantiate an authentication object. Input parameters need to include secretId and secretKey of the Tencent Cloud account. Keep the confidentiality of the key pair.
            // The key can be obtained at https://console.tencentcloud.com/cam/capi.
            Credential cred = new Credential(
              System.getenv("TENCENTCLOUD_SECRET_ID"),
              System.getenv("TENCENTCLOUD_SECRET_KEY")
            );

            // Instantiate an HTTP option (optional). Skip it if there are no special requirements.
            HttpProfile httpProfile = new HttpProfile();
            httpProfile.setEndpoint("ocr.tencentcloudapi.com");

            // Instantiate a client option (optional). Skip it if there are no special requirements.
            ClientProfile clientProfile = new ClientProfile();
            clientProfile.setHttpProfile(httpProfile);

            // Instantiate the client object that requests the product. clientProfile is optional.
            OcrClient client = new OcrClient(cred, "ap-singapore", clientProfile);

            // Instantiate a request object. Each API will correspond to a request object.
            GetOcrVerificationResultRequest req = new GetOcrVerificationResultRequest();
            req.setSdkToken("xxx"); // Enter the SdkToken returned in the ApplyOcrToken phase.

            // The returned resp is an instance of GetOcrVerificationResultResponse, corresponding to the request object.
            GetOcrVerificationResultResponse resp = client.GetOcrVerificationResult(req);

            // Output a string packet in JSON format.
            System.out.println(GetOcrVerificationResultResponse.toJsonString(resp));

            String status = resp.getStatus();
            String resultCode = resp.getResultCode();
            String cardInfo = resp.getCardInfo();

            if ("COMPLETE".equals(status) && "Success".equals(resultCode)) {
                // Recognition passed.
                System.out.println("Success");
                System.out.printf("CardInfo:%s", cardInfo);
            } else {
                // Recognition failed or not yet completed.
                System.out.printf("Status: %s, ResultCode: %s\\n", status, resultCode);
            }
        } catch (TencentCloudSDKException e) {
            System.out.println(e.toString());
        }
    }
}

// Step 1: Initialize in the onCreate method of the Application or business page (only once).
OcrOverseasCloudKit.getInstance().init(getApplicationContext());

// Step 2: Before requesting the sdkToken or serverParamInfo from the business backend,
// First, use createMetaData() to synchronously collect device and application metadata (encrypted inside the SDK), and submit it together with the application request.
// This field remains consistent with the server-side protocol so that the backend can pass it through when calling the cloud CreateOCRToken API for risk control and parameter validation.
String metaData = OcrOverseasCloudKit.getInstance().createMetaData();
// TODO: Submit metaData as a request parameter (for example, with the field name metaData) to the business backend. For more information, see app-public.
//       Implementation of TokenApiHelper#applyToken: body.put("metaData", OcrOverseasCloudKit.getInstance().createMetaData())

// Step 3: Obtain the sdkToken / serverParamInfo from the business backend.
String sdkToken = "...";          // Issued by the business backend.
String serverParamInfo = "...";   // Issued by the business backend as an encrypted string.

// Step 4: Construct the startup configuration.
OcrCloudConfig config = new OcrCloudConfig();
config.setSdkToken(sdkToken);
config.setServerParamInfo(serverParamInfo);
config.setLanguageStyle(LanguageStyle.SIMPLIFIED_CHINESE);
config.setShowPrivacyPolicyDialog(true);
// Optional: Customize the UI.
CustomConfigUi customConfigUi = new CustomConfigUi();
customConfigUi.setShowTitleBar(true);
config.setCustomConfigUi(customConfigUi);

// Step 5: Start recognition.
OcrOverseasCloudKit.getInstance().startCloudOcr(activity, config,
        new IOcrCloudResultListener() {
            @Override
            public void onSuccess(OcrCloudResult result) {
                // After recognition is complete, the business party can use result.getSdkToken() to pull the structured result from the server.
                if (result.getStatus() == OcrCloudStatus.SUCCESS) {
                    String token = result.getSdkToken();
                    // TODO: Notify the business backend to pull the recognition result.
                }
            }

            @Override
            public void onFailed(OcrCloudError error) {
                // Error handling: error.getErrorCode() / error.getErrorMsg()
            }
        });

// Step 6: Release resources at an appropriate time (for example, in the onDestroy method of the business page).
OcrOverseasCloudKit.getInstance().release();

# Keep the custom OcrSDKKit class and its members from being obfuscated.
-keep class com.tencent.ocr.sdk.** {*;}
# Keep third-party jar packages from being obfuscated.
-keep class com.tencent.youtu.** {*;}
# Do not obfuscate public library related content.
-keep class com.tencent.cloud.** {*;}

├── OcrOverseasSDKKit.xcframework
├── TXYRiskModuleSDK.xcframework
// Resource files
├── OcrModel.bundle
└── OcrSDK.bundle

<key>Privacy - Camera Usage Description</key>
<string>OCR recognition requires access to your camera for identification purposes.</string>

NSString *metaData = [OcrOverseasCloudKit createMetaData];

#import <OcrOverseasSDKKit/OcrOverseasCloudKit.h>

// Initialize at an appropriate time (such as viewDidLoad)
[[OcrOverseasCloudKit sharedInstance] initWithViewController:self];

#import <OcrOverseasSDKKit/OcrOverseasCloudKit.h>
#import <OcrOverseasSDKKit/OcrCloudConfig.h>
#import <OcrOverseasSDKKit/OcrOverseasCustomConfigUI.h>
#import <OcrOverseasSDKKit/OcrCloudResult.h>
#import <OcrOverseasSDKKit/OcrCloudError.h>

OcrCloudConfig *cloudConfig = [[OcrCloudConfig alloc] init];
// Business Token issued by the server.
cloudConfig.sdkToken = @"sdkToken obtained from the server";
// Encrypted parameter issued by the server.
cloudConfig.serverParamInfo = @"serverParamInfo obtained from the server";

// Optional: Customize the UI configuration.
OcrOverseasCustomConfigUI.h *customUI = [[OcrOverseasCustomConfigUI.h alloc] init];
customUI.isShowTips = YES;
cloudConfig.customConfigUI = customUI;

[[OcrOverseasCloudKit sharedInstance] startCloudOcr:cloudConfig
                                   withSucceedBlock:^(OcrCloudResult *result) {
    // After SDK collection is complete, use result.sdkToken to pull the recognition result from the server.
    NSString *token = result.sdkToken;
    NSLog(@"Collection successful, token: %@", token);
    // Step 4: Use the token to request the final recognition result from the server.
} withFailedBlock:^(OcrCloudError *error) {
    NSLog(@"Recognition failed, errorCode: %ld, errorMsg: %@", (long)error.errorCode, error.errorMsg);
    NSLog(@"token: %@", error.sdkToken);
}];