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

Captcha:テキストと言語設定のカスタマイズ

最終更新日:Jun 03, 2026

Captcha は 17 の組み込み言語をサポートしています。クライアント側コンポーネントの UI テキストと言語をカスタマイズできます。

サポートされている言語

説明

language パラメーターを使用して言語を設定します。

  • cn: Simplified Chinese

  • tw: Traditional Chinese

  • en: English

  • ar: Arabic

  • de: German

  • es: Spanish

  • fr: French

  • in: Indonesian

  • it: Italian

  • ja: Japanese

  • ko: Korean

  • pt: Portuguese

  • ru: Russian

  • ms: Malay

  • th: Thai

  • tr: Turkish

  • vi: Vietnamese

重要

空間推理の問題バンクは、簡体字中国語 (cn)、繁体字中国語 (tw)、英語 (en)、日本語 (ja)、韓国語 (ko) では選択した言語に一致します。その他の言語は、デフォルトで簡体字中国語 (cn) の問題バンクを使用します。

空間推理 CAPTCHA は提供を終了しました。 [Notice] Deprecation of the Spatial Reasoning CAPTCHA Type

コード例

この例では、言語ごとに CAPTCHA プロンプトのテキストをカスタマイズします。

説明

upLang: myLang パラメーターを渡し、myLang オブジェクトを定義することで、13 個のテキストプロンプトをカスタマイズします。

/**
 * 言語名。オプションには cn、tw、en が含まれます。カスタム言語を追加することもできます。
 * 言語の詳細は、キーと値の形式で指定します。
 */
var myLang = {
  cn: {
    // 埋め込み v3 UI のトリガーボタンのテキスト。
    START_VERIFY: "Click to start verification",
    // Captcha プロンプトのタイトルテキスト。すべての CAPTCHA タイプに適用されます。
    POPUP_TITLE: "Complete security verification",
    // CAPTCHA タイプごとの操作プロンプトテキスト。
    SLIDE_TIP: "Drag the slider all the way to the right.",
    CHECK_BOX_TIP: "Confirm you are not a robot",
    PUZZLE_TIP: "Drag the slider to complete the puzzle.",
    INPAINTING_TIP: "Drag the slider to restore the image.",
    // 検証プロセス中に表示されるプロンプトテキスト。スライダー CAPTCHA とワンクリック認証に適用されます。
    VERIFYING: "Verifying...",
    // 検証成功時のプロンプトテキスト。すべての CAPTCHA タイプに適用されます。
    SUCCESS: "Verified.",
    // 検証失敗時のプロンプトテキスト。スライダー CAPTCHA とワンクリック認証に適用されます。
    SLIDE_FAIL: "Verification failed. Refresh and try again.",
    // 検証失敗時のプロンプトテキスト。パズル CAPTCHA と画像修復 CAPTCHA に適用されます。
    CAPTCHA_FAIL: "Verification failed. Try again.",
    // ネットワークエラーのプロンプトテキスト。
    CONGESTION: "Network error. Please refresh and try again.",
    // 操作後、送信前に表示されるプロンプトテキスト。埋め込み v2 UI 固有で、送信は業務ボタンによってトリガーされます。
    CAPTCHA_COMPLETED: "Complete.",
    // 操作せずに送信を試行した場合のプロンプトテキスト。埋め込み v2 UI 固有で、送信は業務ボタンによってトリガーされます。
    FINISH_CAPTCHA: "Please complete the security verification first.",
    // 検証タイムアウトのプロンプトテキスト。埋め込み UI には閉じるボタンがありません。
    OVERTIME_TIP: "Verification timed out. Please close the Captcha and try again.",
    OVERTIME_TIP_BOX: "Verification timed out. Please click the Captcha box to try again.",
  },
  en: {
    // キーは上記と同じです。
    POPUP_TITLE: "Please complete captcha",
    // ...
  },
};

initAliyunCaptcha({
  ...
  upLang: "myLang",
  language: "cn", // Captcha の言語。例: "cn"。
  ...
});
重要
  1. カスタム言語を追加するには、initAliyunCaptchalanguage パラメーターをカスタム言語コードに設定し、myLang オブジェクト内の 13 個のテキストキーの翻訳を指定します。例: language: 'xx', "xx": { "POPUP_TITLE": "Your custom text here"}

  2. サポートされていない言語コードの場合、中国語のテキストにフォールバックします。カスタムテキストが指定されていないサポート対象言語の場合、その言語のデフォルトテキストにフォールバックします。

  3. 次のシステムテキストはカスタマイズできません: 「You have stayed on the page for too long. Please refresh and try again.」

テキストの表示箇所

myLang オブジェクトは、検証プロンプト、読み込みステータス、失敗メッセージなど、Captcha の表示テキストをすべて格納します。

キー

デフォルト

スライダー CAPTCHA

ワンクリック認証

パズル CAPTCHA

画像修復 CAPTCHA

説明

START_VERIFY

"Click to start verification"

/

/

image

image

埋め込み v3 UI におけるトリガーボタンのテキスト。

POPUP_TITLE

"Complete security verification"

image

image

image

image

CAPTCHA プロンプトのタイトルテキスト。すべての CAPTCHA タイプに適用されます。

  • SLIDE_TIP

  • CHECK_BOX_TIP

  • PUZZLE_TIP

  • INPAINTING_TIP

  • "Drag the slider all the way to the right."

  • "Confirm you are not a robot"

  • "Drag the slider to complete the puzzle."

  • "Drag the slider to restore the image."

image

image

image

image

CAPTCHA タイプごとの操作プロンプト。

VERIFYING

"Verifying..."

image

image

/

/

検証中に表示されます。スライダー CAPTCHA とワンクリック認証に適用されます。

SUCCESS

"Verified."

image

image

image

image

検証に成功した場合に表示されます。すべての CAPTCHA タイプに適用されます。

SLIDE_FAIL

"Verification failed. Refresh and try again."

image

image

/

/

検証に失敗した場合に表示されます。スライダー CAPTCHA とワンクリック認証に適用されます。

CAPTCHA_FAIL

"Verification failed. Try again."

/

/

image

image

検証に失敗した場合に表示されます。パズル CAPTCHA と画像修復 CAPTCHA に適用されます。

CONGESTION

"Network error. Please refresh and try again."

image

image

image

image

ネットワークエラー発生時に表示されます。

CAPTCHA_COMPLETED

"Complete."

image

/

image

image

操作後、送信前に表示されます。埋め込み v2 UI 固有で、送信は業務ボタンによってトリガーされます。

説明
  • より良いエクスペリエンスのため、埋め込み v3 UI を使用することを推奨します。

  • スライダー操作の直後に検証を即時送信するには、v2 で immediatetrue に設定します。

FINISH_CAPTCHA

"Please complete the security verification first."

image

image

image

image

操作せずに送信を試行した場合に表示されます。埋め込み v2 UI 固有で、送信は業務ボタンによってトリガーされます。

説明

このプロンプトの位置は固定です。より良いエクスペリエンスのため、埋め込み v3 UI を使用することを推奨します。

OVERTIME_TIP

OVERTIME_TIP_BOX

  • "Verification timed out. Please close the Captcha and try again."

  • "Verification timed out. Please click the Captcha box to try again."

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

検証タイムアウト時に表示されます。埋め込み UI には閉じるボタンがありません。