upgrade

SDK 升级指南

V1.2.8（2024.12.30）

一、版本介绍

修复bug

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.8'

V1.2.7（2024.10.17）

一、版本介绍

优化遮挡检测

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.7'

V1.2.6（2024.9.03）

一、版本介绍

优化TH IQA模型

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.6'

V1.2.5（2024.8.15）

一、版本介绍

扫描模型增加遮挡处理，目前仅对泰国生效

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.5'

V1.2.4（2024.7.19）

一、版本介绍

支持泰语

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.4'

V1.2.3.1（2024.4.30）

一、版本介绍

修复已知的崩溃

在相机关闭时，尽管我们捕获了 IOException，但由于未知原因在这里发生了 RuntimeException。我们改为捕获 Exception 而不是 IOException。

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.3.1'

V1.2.3（2024.4.22）

一、版本介绍

修复已知的崩溃

当调用Camera.stopPreview()来停止相机预览时，Camera API会抛出一个未处理的异常。我们使用了try-catch块来捕获这个异常。
在某些特定情况下，偶现图像处理空指针，我们增加了非空判断。
当GlobalIQAView没有完全初始化并且用户点击页面以执行GlobalIQAView.autoFocus()时，会导致内部出现NullPointerException。为了避免这个问题，我们添加了一个空值检查来处理这个异常。

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.3'

###

V1.2.2（2023.11.21）

一、版本介绍

bug 修复

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.2'

V1.2.1（2023.8.11）

一、版本介绍

支持设置最大扫描次数
UI 模块开源

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.1'

V1.2.0（2023.5.29）

一、版本介绍

提升扫描速度

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.0'

V1.0.9（2023.4.6）

一、版本介绍

token 鉴权改造

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.1.0'

V1.0.9（2023.3.6）

一、版本介绍

算法优化，提升扫描速度
默认情况下，去除扫描超时后转拍照的 3 秒转场动画

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.9'

V1.0.8（2022.11.4）

一、版本介绍

修改扫描页面的标题为Scan Document

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.8'

V1.0.7（2022.11.4）

一、版本介绍

修复 PAGIBG 卡片名称拼写错误的问题

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.7'

V1.0.6（2022.9.27）

一、版本介绍

增加多处 UI 自定义功能

相机控件上方文字支持传入富文本：


xxxxxxxxxx
SpannableString spannableString = new SpannableString("xxxxx");
spannableString.setSpan(....);
intent.putExtra(GlobalIQAActivity.EXTRA_SPANNABLE_ABOVE_CAMERA, spannableString);

拍照模式，相机控件下方提示语支持传入富文本：


xxxxxxxxxx
SpannableString spannableString = new SpannableString("xxxxx");
spannableString.setSpan(....);
intent.putExtra(GlobalIQAActivity.EXTRA_SPANNABLE_TIP_TEXT_OF_TAKE_PHOTO, spannableString);

拍照模式，拍照后预览时图像下方提示语支持传入富文本：


xxxxxxxxxx
SpannableString spannableString = new SpannableString("xxxxx");
spannableString.setSpan(....);
intent.putExtra(GlobalIQAActivity.EXTRA_SPANNABLE_PREVIEW_TIP_OF_TAKE_PHOTO, spannableString);

相机控件蒙版支持设置圆角（单位：px）：


xxxxxxxxxx
new UIExtras.Builder()
.setFrameRectCornerRadius(20)
.build()

拍照模式，相机控件下方提示语控件的背景色可以修改：


xxxxxxxxxx
new UIExtras.Builder()
.setTakePhotoTipViewBackgroundColor(your color value)
.build()

拍照模式，相机控件下方提示语控件左侧的图标可以设置隐藏：


xxxxxxxxxx
new UIExtras.Builder()
.takePhotoTipViewLeftIconVisible(false)
.build()

扫描模式，可以自定义底部提示语的样式：


xxxxxxxxxx
TipViewUIElements elements = new TipViewUIElements();
elements.setNoCardDrawableResId(R.drawable.xxx);// 未检测到卡片
elements.setHoldSteadilyDrawableResId(R.drawable.xxx);// 请扶稳手机
elements.setCardPoorQualityDrawableResId(R.drawable.xxx);// 卡片质量差：模糊/光斑/过暗
elements.setCardIncompleteDrawableResId(R.drawable.xxx);// 卡片不完整
elements.setCardTooSmallDrawableResId(R.drawable.xxx);// 卡片过小
elements.setViewWidthPercentRelativeToCameraView(1f); // 提示语控件相对于相机控件的宽度比例，如：设置为1表示何相机控件等宽
elements.setAspectRatio(0.25f);// 控件宽高比

new UIExtras.Builder()
.setPortraitTipViewBackgrounds(elements)// 竖屏
.setLandscapeTipViewBackgrounds(landscapeElements)// 横屏
.build()

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.6'

V1.0.5（2022.9.15）

一、版本介绍

增加以下几种卡片的识别
- VOTERID
- NATIONALID
- PRC
- PAGIBG
- POSTALID

二、版本升级

implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.5'

V1.0.4（2022.8.10）

一、版本介绍

增加 maven 仓库，可以进行在线依赖，删除您项目中已依赖的 guardian_global_iqa_v1.0.x.aar 和 guardian_core_vx.x.aar，并按照如下方式进行依赖：

在您项目根目录下的build.gradle增加 maven 仓库依赖


xxxxxxxxxx
allprojects {
    repositories {
        google()
        jcenter()
        ...
        maven {
            url 'http://public-n3.advai.net/repository/maven-releases/'
            // 若您的 gradle 版本大于 7.0，需要增加如下配置允许通过 http 拉取 aar
            allowInsecureProtocol = true
        }
    }
}

在app/build.gradle中增加增加包依赖


xxxxxxxxxx
dependencies {
     ...
    // 版本记录查看：http://public-n3.advai.net/repository/maven-releases/ai/advance/mobile-sdk/android/global-iqa/maven-metadata.xml
    implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.4' 
}

V1.0.3（2022.7.1）

一、版本介绍

增加多个自定义 UI 方法，具体请参考集成文档


xxxxxxxxxx
...
.setPagePortraitBackgroundResource(R.drawable.xxx)//竖屏状态下页面的背景图片
                .setPageLandscapeBackgroundResource(R.drawable.xxx)//横屏状态下页面的背景图片
                .setPageLandscapeTitleBgResource(R.drawable.xxx)//横屏状态下页面标题部分背景图片
                .setPagePortraitTitleBgResource(R.drawable.xxx)//竖屏状态下页面标题部分背景图片
                .setCameraWidthPercentInPortraitState(0.8f)// 竖屏状态相机控件占屏幕的百分比，取值0～1
                .setCameraHeightPercentInLandscapeState(0.7)// 竖屏状态相机控件占屏幕的百分比，取值0～0.7
                .setRetakeBtnTextColor(your colorRes)//拍照模式重拍按钮文字颜色
                .setContinueBtnTextColor(your colorRes)//拍照模式继续按钮文字颜色
                .setTakePhotoTipDialogShowSeconds(3)//扫描超时提示框倒计时秒数设置，设置为0则不会弹框
                .setScanLimitSeconds(20)// 扫描超时时间设置，单位秒，取值5～60
                .setCountdownTimerVisible(true)// 扫描模式是否显示倒计时控件，默认显示(此设置不会影响倒计时逻辑，仅决定控件是否显示)

二、版本升级

使用 guardian_global_iqa_v1.0.3 替换旧版本 aar，同时修改 gradle 中的依赖关系即可

V1.0.2（2022.6.7）

一、版本介绍

增加方法用于获取图片类型


xxxxxxxxxx
String pictureType = GlobalIQAResult.getPictureType();// 图片类型，takePhoto 表示拍照，scan 表示扫描

二、版本升级

使用 guardian_global_iqa_v1.0.2.aar 替换旧版本 aar，同时修改 gradle 中的依赖关系即可

V1.0.1（2022.4.13）

一、版本介绍

增加护照类型卡片支持

二、版本升级

使用 guardian_global_iqa_v1.0.1 ，guardian_core_v3.0.aar 替换旧版本 aar，同时修改 gradle 中的依赖关系即可