└── src
    └── main
        ├── AndroidManifest.xml
        ├── assets
        ├── java
        └── res
            ├── values-zh-rCN
            │   └── custom_strings.xml
            └── values-zh-rHK
                └── custom_strings.xml

EkycHyConfig ekycHyConfig = new EkycHyConfig();
ekycHyConfig.setLanguageStyle(LanguageStyle.CUSTOMIZE_LANGUAGE);
ekycHyConfig.setLanguageCode("th-TH");

EkycHyConfig ekycHyConfig = new EkycHyConfig();

OcrUiConfig ocrUiConfig = new OcrUiConfig();
ocrUiConfig.setPortraitLayoutResId(R.layout.custom_ocr_layout);

ekycHyConfig.setOcrUiConfig(ocrUiConfig);

EkycHyConfig ekycHyConfig = new EkycHyConfig();

FaceAuthUiConfig faceAuthUiConfig = new FaceAuthUiConfig();
faceAuthUiConfig.setAuthLayoutResId(R.layout.custom_face_auth_layout);

ekycHyConfig.setFaceAuthUiConfig(faceAuthUiConfig);

EkycHySdk.setAuthEventCallBack(new HuiYanAuthEventCallBack() {
    @Override
    public void onMainViewCreate(View authView) {
        if (authView == null) {
            return;
        }
        // 获取自定义布局中的控件
        Button customButton = authView.findViewById(R.id.custom_button_id);
        if (customButton != null) {
            customButton.setOnClickListener(v -> {
                // 处理自定义按钮点击事件
                Log.d(TAG, "Custom button clicked");
            });
        }
    }

    @Override
    public void onMainViewDestroy() {
        // 界面销毁时的清理工作
        Log.d(TAG, "Auth view destroyed");
    }
});

<!-- 自定义导航栏容器，可自由设置背景色、高度 -->
<FrameLayout
    android:id="@+id/custom_nav_bar"
    android:layout_width="match_parent"
    android:layout_height="56dp"
    android:background="#2196F3"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent">

    <!-- 返回按钮：ID 必须为 txy_cancel_txt_btn，SDK 负责绑定退出事件 -->
    <TextView
        android:id="@+id/txy_cancel_txt_btn"
        android:layout_width="24dp"
        android:layout_height="24dp"
        android:layout_gravity="center_vertical|start"
        android:layout_marginStart="15dp"
        android:background="@drawable/ic_arrow_left" />

    <!-- 自定义标题，ID 自定义，需在 onMainViewCreate 中更新文字 -->
    <TextView
        android:id="@+id/custom_nav_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="Face Verification"
        android:textColor="@android:color/white"
        android:textSize="18sp" />

</FrameLayout>

FaceAuthUiConfig faceAuthUiConfig = new FaceAuthUiConfig();
faceAuthUiConfig.setAuthLayoutResId(R.layout.custom_face_auth_layout);
faceAuthUiConfig.setStatusBarColor(color); // 设置状态栏背景颜色，一般和自定义导航栏的背景一致

EkycHyConfig ekycHyConfig = new EkycHyConfig();
ekycHyConfig.setFaceAuthUiConfig(faceAuthUiConfig);

// 在 startEkycCheck() 之前注册
EkycHySdk.setOcrCloudEventListener(listener);

// 取消注册传 null
EkycHySdk.setOcrCloudEventListener(null);

// 1. 注册事件监听器（在 startEkycCheck 之前）
EkycHySdk.setOcrCloudEventListener(new IOcrCloudEventListener() {
    @Override
    public void onMainViewCreate(View mainView) {
        // SDK OCR 识别页面主 View 创建，可在此添加自定义浮层
    }

    @Override
    public void onMainViewDestroy() {
        // 界面销毁，清理资源
    }

    @Override
    public void onEventParamMap(HashMap<String, Object> map) {
        // 接收 SDK 透传的额外参数
    }

    @Override
    public boolean onShowCloudErrorDialog(HashMap<String, Object> info,
                                          View parentView,
                                          Runnable retryBlock,
                                          Runnable exitBlock) {
        // info 包含: "title"(String), "message"(String), "errorCode"(Integer,可能不存在)
        String title = (String) info.get("title");
        String message = (String) info.get("message");
        new AlertDialog.Builder(parentView.getContext())
                .setTitle(title)
                .setMessage(message)
                // retryBlock 为 null 时表示不可重试
                .setPositiveButton(retryBlock != null ? "重试" : null,
                        retryBlock != null ? (d, w) -> retryBlock.run() : null)
                .setNegativeButton("退出", (d, w) -> exitBlock.run())
                .setCancelable(false)
                .show();
        return true; // 自行处理，SDK 不展示默认弹窗
    }

    @Override
    public boolean onShowBestFrameConfirmDialog(HashMap<String, Object> info,
                                                 View parentView,
                                                 ImageView imageView,
                                                 Runnable confirmBlock,
                                                 Runnable cancelBlock) {
        // imageView 已设好最佳帧图片，直接添加到布局中展示
        LinearLayout layout = new LinearLayout(parentView.getContext());
        layout.setOrientation(LinearLayout.VERTICAL);
        layout.setPadding(32, 32, 32, 0);
        imageView.setLayoutParams(new LinearLayout.LayoutParams(
                LinearLayout.LayoutParams.MATCH_PARENT, 400));
        imageView.setScaleType(ImageView.ScaleType.FIT_CENTER);
        layout.addView(imageView);

        new AlertDialog.Builder(parentView.getContext())
                .setTitle("最佳帧确认")
                .setView(layout)
                .setPositiveButton("确认使用", (d, w) -> confirmBlock.run())
                .setNegativeButton("重新拍摄", (d, w) -> cancelBlock.run())
                .setCancelable(false)
                .show();
        return true;
    }

    @Override
    public boolean onShowCameraPermissionDialog(HashMap<String, Object> info,
                                                 View parentView,
                                                 Runnable settingsBlock,
                                                 Runnable cancelBlock) {
        // settingsBlock: 跳转系统设置页  cancelBlock: 取消退出
        String title = (String) info.get("title");
        String message = (String) info.get("message");
        new AlertDialog.Builder(parentView.getContext())
                .setTitle(title)
                .setMessage(message)
                .setPositiveButton("前往设置", (d, w) -> settingsBlock.run())
                .setNegativeButton("取消", (d, w) -> cancelBlock.run())
                .setCancelable(false)
                .show();
        return true;
    }

    @Override
    public boolean onShowNextSideDialog(HashMap<String, Object> info,
                                         View parentView,
                                         Runnable confirmBlock) {
        // 双面证件翻面提示
        String title = (String) info.get("title");
        String message = (String) info.get("message");
        new AlertDialog.Builder(parentView.getContext())
                .setTitle(title)
                .setMessage(message)
                .setPositiveButton("确认翻面", (d, w) -> confirmBlock.run())
                .setCancelable(false)
                .show();
        return true;
    }

    @Override
    public boolean onShowChangeModeDialog(HashMap<String, Object> info,
                                           View parentView,
                                           Runnable confirmBlock,
                                           Runnable cancelBlock) {
        // 自动模式超时，提示切换手动拍照
        String title = (String) info.get("title");
        String message = (String) info.get("message");
        new AlertDialog.Builder(parentView.getContext())
                .setTitle(title)
                .setMessage(message)
                .setPositiveButton("切换手动", (d, w) -> confirmBlock.run())
                .setNegativeButton("继续等待", (d, w) -> cancelBlock.run())
                .setCancelable(false)
                .show();
        return true;
    }

    private ProgressDialog progressDialog;

    @Override
    public boolean onShowUploadLoading(View parentView) {
        // 自定义上传 loading，与 onHideUploadLoading 成对使用
        progressDialog = new ProgressDialog(parentView.getContext());
        progressDialog.setMessage("正在上传识别中...");
        progressDialog.setCancelable(false);
        progressDialog.show();
        return true; // 拦截 SDK 默认 loading
    }

    @Override
    public void onHideUploadLoading() {
        // 上传流程结束（成功、失败或重试）时回调，在此隐藏自定义 loading
        if (progressDialog != null && progressDialog.isShowing()) {
            progressDialog.dismiss();
            progressDialog = null;
        }
    }
});

// 2. 启动 eKYC 流程
EkycHySdk.startEkycCheck(activity, ekycToken, serverParamInfo, ekycHyConfig, ekycHyCallBack);