全部產品
Search
文件中心

ID Verification:Web SDK 自訂語種

更新時間:Aug 16, 2025

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識別結果展示與編輯頁面,由於該頁面涉及通用操作文案證件卡面原生欄位的兩種種類文案,產品基於體驗一致性進行了如下限制:

說明
  • 通用操作文案:指識別頁面中的欄位,如按鈕、導航等文案。

  • 證件卡面原生欄位:指識別出的證件欄位,如姓名、性別、住址、宗教等。

  1. eKYCID_OCR 方案支援7種證件類型,該頁面多語種僅適配通用操作文案

    • 證件卡面原生欄位僅支援中文、繁體中文和英文。

    • defaultLanguage設定為卡面原生欄位KEY不支援的語種時,原生欄位KEY預設展示英文。

  2. eKYC_PRO 支援全球多種卡證類型識別結果的展示,該頁面多語種僅適配通用操作文案

    • 證件卡面原生欄位基於關聯規則展示。

    • 證件卡面原生欄位只有一種語種,欄位優先展示卡面語種。

    • 證件卡面原生欄位存在英文時,欄位優先展示英文。