自定义
采集流程可用性
这些自定义选项仅在采集流程为 document-capture 或 liveness 时可用。
Android SDK 支持两个维度的自定义:语言和颜色。
语言
通过 setLocale 方法配置采集框中提示信息的语言:
- Kotlin
- Java
acessoBioBuilder.setLocale(LocaleTypes.EN_US)
acessoBioBuilder.setLocale(LocaleTypes.EN_US);
有关支持的 LocaleTypes 值的完整列表,请参阅 API 参考 > 枚举类型。
颜色
通过 acessoBioBuilder 上的 setTheme 应用自定义主题。颜色值可以作为颜色资源(R.color.your_color)或十六进制字符串("#FF0000")传入。
IAcessoBioTheme 接口根据采集类型暴露不同的方法。
自拍采集
| 方法 | 自定义内容 |
|---|---|
getColorBackground() | 自拍采集框的背景颜色 |
getColorBoxMessage() | 消息框的背景颜色 |
getColorTextMessage() | 消息框内的文字颜色 |
getColorSilhouetteSuccess() | 采集成功时轮廓的颜色 |
- Kotlin
- Java
val unicoTheme = object : IAcessoBioTheme {
override fun getColorBackground() = R.color.your_color
override fun getColorBoxMessage() = R.color.your_color
override fun getColorTextMessage() = R.color.your_color
override fun getColorSilhouetteSuccess() = R.color.your_color
}
acessoBioBuilder.setTheme(unicoTheme)
IAcessoBioTheme unicoTheme = new IAcessoBioTheme() {
@Override
public Object getColorBackground() { return R.color.your_color; }
@Override
public Object getColorBoxMessage() { return R.color.your_color; }
@Override
public Object getColorTextMessage() { return R.color.your_color; }
@Override
public Object getColorSilhouetteSuccess() { return R.color.your_color; }
};
acessoBioBuilder.setTheme(unicoTheme);
或者,在 colors.xml 中静态覆盖颜色:
<color name="unico_color_background">#YourColor</color>
<color name="unico_color_box_message">#YourColor</color>
<color name="unico_color_text_message">#YourColor</color>
<color name="unico_color_silhouette_success">#YourColor</color>
<color name="unico_color_button_cancel">#YourColor</color>
信息
unico_color_button_cancel 只能通过 colors.xml 使用——它未作为方法在 IAcessoBioTheme 中暴露。
证件采集
| 方法 | 自定义内容 |
|---|---|
getColorBackground() | 证件采集框的背景颜色 |
getColorBackgroundTakePictureButton() | 拍照按钮的背景颜色 |
getColorIconTakePictureButton() | 拍照按钮内的图标颜色 |
getColorBackgroundBottomDocument() | 底部栏的背景颜色 |
getColorTextBottomDocument() | 底部栏的文字颜色 |
- Kotlin
- Java
val unicoTheme = object : IAcessoBioTheme {
override fun getColorBackground() = R.color.your_color
override fun getColorBackgroundTakePictureButton() = R.color.your_color
override fun getColorIconTakePictureButton() = R.color.your_color
override fun getColorBackgroundBottomDocument() = R.color.your_color
override fun getColorTextBottomDocument() = R.color.your_color
}
acessoBioBuilder.setTheme(unicoTheme)
IAcessoBioTheme unicoTheme = new IAcessoBioTheme() {
@Override
public Object getColorBackground() { return R.color.your_color; }
@Override
public Object getColorBackgroundTakePictureButton() { return R.color.your_color; }
@Override
public Object getColorIconTakePictureButton() { return R.color.your_color; }
@Override
public Object getColorBackgroundBottomDocument() { return R.color.your_color; }
@Override
public Object getColorTextBottomDocument() { return R.color.your_color; }
};
acessoBioBuilder.setTheme(unicoTheme);
或者,在 colors.xml 中静态覆盖颜色:
<color name="unico_color_background">#YourColor</color>
<color name="unico_color_background_take_picture_button">#YourColor</color>
<color name="unico_color_icon_take_picture_button">#YourColor</color>
<color name="unico_color_background_bottom_document">#YourColor</color>
<color name="unico_color_text_bottom_document">#YourColor</color>
自定义范围
没有其他可用的自定义维度。原生 Android SDK 不提供自定义 UI 行为和布局。如果您需要专有 UI,请参阅 Capture Standard 选项(无界面 API 集成)。