すべてのプロダクト
Search
ドキュメントセンター

ID Verification:Web SDK の言語をカスタマイズする

最終更新日:Nov 09, 2025

ID Verification Web SDK は言語のカスタマイズをサポートしています。国際化を実装するには、Initialize インターフェイスに構成を渡します。

概要

ID Verification Web SDK は、モバイル (Mobile) とデスクトップ (PC) の両方のデバイスで複数の言語をサポートしています。

言語をカスタマイズするには、構成ファイルを作成し、それを Initialize インターフェイスの LanguageConfig フィールドに渡します。

重要

LanguageConfig フィールドが空の場合、システムはデバイスの言語設定を自動的に検出します。検出に失敗した場合、インターフェイスはデフォルトで英語になります。

サポートされている言語

重要

以下の言語は、モバイル (Mobile) 統合モードでのみ利用可能です。

PC モードは、簡体字中国語、繁体字中国語、および英語のみをサポートしています。他の言語はサポートされていません。

言語

コード

簡体字中国語

zh

Simplified Chinese

繁体字中国語

TW

Traditional Chinese

英語

en

English

マレー語

ms

Bahasa Melayu

インドネシア語

id

Bahasa Indonesia

タイ語

th

タイ語

ベトナム語

vi

Tiếng Việt

日本語

ja

Japanese

韓国語

ko

フランス語

fr

Français

スペイン語

es

Español

ポルトガル語

pt

Português

ロシア語

ru

ロシア語

アラビア語

ar

デフォルト言語の構成

デフォルト言語を指定するには、defaultLanguage フィールドを対応する言語の code に設定します。

たとえば、デフォルト言語を英語に設定するには、LanguageConfig フィールドを次のように構成します。

{
  "defaultLanguage": "en"
}

新しい言語の追加

ID Verification には大量のテキストが含まれるため、互換性の問題を回避するために、新しいカスタム言語の追加はサポートされなくなりました。この変更は、以前に追加されたカスタム言語には影響しません。

ビジネスで新しい言語が必要な場合は、チケットを送信するか、ビジネス マネージャーに連絡してサポートを依頼してください。

言語設定の優先順位

ID Verification Web SDK のモバイル版では、エンドユーザー向けの言語切り替え機能が提供されています。言語設定の優先順位は次のとおりです。

  • 言語切り替えボタンが表示されている場合: エンドユーザーが選択した言語 > defaultLanguage > システム言語 (プロダクトでサポートされている場合)

  • 言語切り替えボタンが非表示の場合: defaultLanguage > システム言語 (プロダクトでサポートされている場合)

OCR 結果と編集ページの言語設定

ID Verification 証明書モジュールは、OCR 結果を表示および編集するためのオプションのページを提供します。このページには、一般的な操作テキストネイティブ証明書フィールドの 2 種類のテキストが含まれています。一貫したユーザーエクスペリエンスを確保するために、次の制限が適用されます。

説明
  • 一般的な操作テキスト: ボタンやナビゲーション要素など、認識ページのテキストを指します。

  • ネイティブ証明書フィールド: 名前、性別、住所、宗教など、証明書から認識されたフィールドを指します。

  1. eKYC および ID_OCR ソリューションの場合、このページの多言語設定は一般的な操作テキストにのみ適用されます。

    • ネイティブ証明書フィールドは、中国語、繁体字中国語、および英語のみをサポートしています。

    • defaultLanguage がネイティブ証明書フィールドでサポートされていない言語に設定されている場合、フィールド名はデフォルトで英語になります。

  2. eKYC_PRO ソリューションの場合、このページの多言語設定は一般的な操作テキストにのみ適用されます。

    • ネイティブ証明書フィールドは、固定のルールに基づいて表示されます。

    • ネイティブ証明書フィールドは単一の言語で表示されます。証明書に表示される言語が優先されます。

    • 証明書に英語が存在する場合、フィールドは英語で表示されます。