ID Verification Web SDK提供多语言自定义配置,开发者可以通过编写配置传入Initialize接口,来实现国际化的多语言。
概述
ID Verification Web SDK提供了多语言的能力,同时支持移动端(Mobile)和桌面端(PC)。
自定义语种需要编写配置文件,并通过Initialize接口的LanguageConfig字段传入。
若LanguageConfig字段设置为空,系统会自动识别设备设置的语种自适应匹配,若匹配失败默认展示英文。
已支持语种
目前如下语种仅适配移动端(Mobile)集成模式。
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 (Mobile)页面提供终端用户语种切换功能,设置的优先级如下:
页面显示语种切换按钮:终端用户主动切换的语种 > defaultLanguage > 系统设置语种(产品支持的语种)
页面隐藏语种切换按钮:defaultLanguage > 系统设置语种 (产品支持的语种)
OCR识别结果展示与编辑页面语种说明
ID Verification 卡证模块提供了可选OCR识别结果展示与编辑页面,由于该页面涉及通用操作文案和证件卡面原生字段的两种种类文案,产品基于体验一致性进行了如下限制:
通用操作文案:指识别页面中的字段,如按钮、导航等文案。
证件卡面原生字段:指识别出的证件字段,如姓名、性别、住址、宗教等。
eKYC和ID_OCR 方案支持7种证件类型,该页面多语种仅适配通用操作文案。
证件卡面原生字段仅支持中文、繁体中文和英文。
若defaultLanguage设置为卡面原生字段KEY不支持的语种时,原生字段KEY默认展示英文。
eKYC_PRO 支持全球多种卡证类型识别结果的展示,该页面多语种仅适配通用操作文案。
证件卡面原生字段基于固定规则展示。
证件卡面原生字段只有一种语种,字段优先展示卡面语种。
证件卡面原生字段存在英文时,字段优先展示英文。