ID Verification Web SDK提供多语言自定义配置,开发者可以通过编写配置传入Initialize接口,来实现国际化的多语言。
概述
ID Verification Web SDK提供了多语言的能力,同时支持移动端(H5)和桌面端(PC)。
自定义语种需要编写配置文件,并通过Initialize接口的LanguageConfig字段传入。
若LanguageConfig字段设置为空,系统会自动识别设备设置的语种自适应匹配,若匹配失败默认展示英文。
已支持语种
目前如下语种仅适配移动端(H5)集成模式。
PC端仅支持简体中文、繁体中文和英文,其他语种暂不支持。
|
语言 |
code |
备注 |
|
简体中文 |
zh |
简体中文 |
|
繁体中文 |
TW |
繁體中文 |
|
英文 |
en |
English |
|
马来西亚语 |
ms |
Bahasa Melayu |
|
印尼语 |
id |
Bahasa Indonesia |
|
泰国语 |
th |
ภาษาไทย |
|
越南语 |
vi |
Tiếng Việt |
|
日语 |
ja |
日本語 |
|
韩语 |
ko |
한국어 |
|
法语 |
fr |
Français |
|
西班牙语 |
es |
Español |
|
葡萄牙语 |
pt |
Português |
|
俄语 |
ru |
Русский |
|
阿拉伯语 |
ar |
العربية |
如何配置默认语种
您可以通过 defaultLanguage 字段指定默认语种,值取对应语种的 code。
例如指定默认语种是英文,则LanguageConfig字段:
{
"defaultLanguage": "en"
}
如何新增语种
由于ID Verification 涉及文案较多,为了避免自定义设置带来的兼容性体验受损,将不再支持自定义新增语种(历史自定义新增语种不受影响)。
若您的业务有新的语种适配需求,您可以通过工单或者商务经理反馈,进行统一适配。
语种设置优先级说明
ID Verification Web SDK (H5)页面提供终端用户语种切换功能,设置的优先级如下:
-
页面显示语种切换按钮:终端用户主动切换的语种 > defaultLanguage > 系统设置语种(产品支持的语种)
-
页面隐藏语种切换按钮:defaultLanguage > 系统设置语种 (产品支持的语种)
OCR识别结果展示与编辑页面语种说明
ID Verification 卡证模块提供了可选OCR识别结果展示与编辑页面,由于该页面涉及通用操作文案和证件卡面原生字段的两种种类文案,产品基于体验一致性进行了如下限制:
-
通用操作文案:指识别页面中的字段,如按钮、导航等文案。
-
证件卡面原生字段:指识别出的证件字段,如姓名、性别、住址、宗教等。
-
eKYC和ID_OCR 方案支持7种证件类型,该页面多语种仅适配通用操作文案。
-
证件卡面原生字段仅支持中文、繁体中文和英文。
-
若defaultLanguage设置为卡面原生字段KEY不支持的语种时,原生字段KEY默认展示英文。
-
-
eKYC_PRO 支持全球多种卡证类型识别结果的展示,该页面多语种仅适配通用操作文案。
-
证件卡面原生字段基于固定规则展示。
-
证件卡面原生字段只有一种语种,字段优先展示卡面语种。
-
证件卡面原生字段存在英文时,字段优先展示英文。
-