Todos los productos
Search
Centro de documentos

ID Verification:SDK web para la personalización de la interfaz de usuario de la PC

Última actualización: Sep 05, 2026

Personalice los iconos, los colores y los contextos de la página de guía, la página de captura de certificado, la página de edición de OCR y la página de detección de vida en el SDK web para la PC.

Método de configuración

Pase una cadena JSON con sus estilos personalizados al campo StyleConfig del método Initialize del lado del servidor.

Reglas y recomendaciones de configuración:

  • Herencia predeterminada: si no se especifica un elemento de configuración o su propiedad de estilo, el sistema usa el valor predeterminado.

  • Configuración incremental: para reducir el tamaño del cuerpo de la solicitud, pase únicamente los elementos de configuración que modifique. Los elementos no especificados usan sus valores predeterminados.

Nota

La cadena JSON no debe contener caracteres especiales de expresión regular.

Plantilla de configuración

JavaScript

const styleConfig = {
  guidePage: {
    step1Icon: "", // The icon for Step 1. The image dimensions (width × height) are 200 × 200.
    step2Icon: "", // The icon for Step 2. The image dimensions (width × height) are 200 × 200.
    pathIcon: "", // The icon for the connecting line between steps. The image dimensions (width × height) are 320 × 3.
    startBtnBgColor: "#FF6A00", // The background color of the Start Authentication button. Default value: #FF6A00.
    startBtnTextColor: "#FFFFFF", // The text color of the Start Authentication button. Default value: #FFFFFF.
  },
  ocrPage: {
    backIcon: "", // The icon for the Back button. The image dimensions (width × height) are 24 × 24.
    uploadIcon: "", // The icon for Upload. The image dimensions (width × height) are 16 × 16.
    uploadTextColor: "#FF6A00", // The color of the upload text. Default value: #FF6A00.
    submitBtnBgColor: "#FF6A00", // The background color of the Submit button. Default value: #FF6A00.
    submitBtnTextColor: "#FFFFFF", // The text color of the Submit button. Default value: #FFFFFF.
  },
  alert: {
    top: "45%", // The distance from the top of the pop-up window. Default value: 45%.
    left: "50%", // The distance from the left of the pop-up window. Default value: 50%.
    width: "480px", // The width of the pop-up window. Default value: 480px.
    primaryBtnBgColor: "#FF6A00", // The background color of the primary button. Default value: #FF6A00.
    primaryBtnTextColor: "#FFFFFF", // The text color of the primary button. Default value: #FFFFFF.
    btnBgColor: "#FFFFFF", // The background color of the secondary button. Default value: #FFFFFF.
    btnBgTextColor: "#FF6A00", // The text color of the secondary button. Default value: #FF6A00.
    btnBorder: "1px solid #FF6A00", // The border style of the secondary button. Default value: 1px solid #FF6A00.
  }
};

JSON

{
  "guidePage": {
    "step1Icon": "",
    "step2Icon": "",
    "pathIcon": "",
    "startBtnBgColor": "#FF6A00",
    "startBtnTextColor": "#FFFFFF"
  },
  "ocrPage": {
    "backIcon": "",
    "uploadIcon": "",
    "uploadTextColor": "#FF6A00",
    "submitBtnBgColor": "#FF6A00",
    "submitBtnTextColor": "#FFFFFF"
  },
  "alert": {
    "top": "45%",
    "left": "50%",
    "width": "480px",
    "primaryBtnBgColor": "#FF6A00",
    "primaryBtnTextColor": "#FFFFFF",
    "btnBgColor": "#FFFFFF",
    "btnBgTextColor": "#FF6A00",
    "btnBorder": "1px solid #FF6A00"
  }
}

Referencia de configuración

  • Colores de la página: reemplace los colores predeterminados de los componentes con valores de color personalizados.

  • Iconos: reemplace los iconos predeterminados con imágenes personalizadas. El tamaño y la posición son fijos.

  • Estilos de marco: reemplace los marcos predeterminados con recursos personalizados. El tamaño y la posición son fijos.

Página del módulo

Elemento

Descripción

Elemento de configuración

Detalles

Página de guía

Iconos de los pasos

Reemplazable

"guidePage": {
  "step1Icon": "",
  "step2Icon": "",
  "pathIcon": ""
}
  • Una URL de imagen accesible públicamente.

  • step1Icon y step2Icon: iconos de los pasos 1 y 2. Tamaño: 200 × 200.

  • pathIcon: icono de la línea que conecta los pasos. Tamaño: 320 × 3.

Color de contexto del botón/Color de fuente del botón

Ninguna

"guidePage": {
  "startBtnBgColor": "#FF6A00",
  "startBtnTextColor": "#FFFFFF"
}
  • startBtnBgColor: color de contexto del botón Start.

  • startBtnTextColor: color de texto del botón Start.

Página de captura de certificado

Icono del botón Atrás/Icono de cargue de imagen

Ninguna

"ocrPage": {
  "backIcon": "",
  "uploadIcon": ""
}
  • Una URL de imagen accesible públicamente.

  • backIcon: icono del botón Atrás. Tamaño: 24 × 24.

  • uploadIcon: icono de cargue de imagen. Tamaño: 16 × 16.

Estilo del texto de cargue

Ninguna

"ocrPage": {
  "uploadTextColor": "#FF6A00"
}

Color del texto de cargue. Predeterminado: #FF6A00.

Estilo del botón envíe

Ninguna

"ocrPage": {
  "submitBtnBgColor": "#FF6A00",
  "submitBtnTextColor": "#FFFFFF"
}
  • submitBtnBgColor: color de contexto. Predeterminado: #FF6A00.

  • submitBtnTextColor: color de texto. Predeterminado: #FFFFFF.

Estilo de diálogo

Distancia desde la parte superior

Ninguna

"alert": {
  "top": "45%"
}

Distancia desde la parte superior. Predeterminado: 45%.

Distancia desde la izquierda

Ninguna

"alert": {
  "left": "50%"
}

Distancia desde la izquierda. Predeterminado: 50%.

Ancho

Ninguna

"alert": {
  "width": "480px"
}

Ancho del diálogo. Predeterminado: 480px.

Estilo del botón principal:

  • Color de contexto

  • Color de texto

Ninguna

"alert": {
  "primaryBtnBgColor": "#FF6A00",
  "primaryBtnTextColor": "#FFFFFF"
}
  • primaryBtnBgColor: color de contexto. Predeterminado: #FF6A00.

  • primaryBtnTextColor: color de texto. Predeterminado: #FFFFFF.

Estilo del botón secundario:

  • Color de contexto

  • Color de texto

  • Estilo de borde

Ninguna

"alert": {
  "btnBgColor": "#FFFFFF",
  "btnBgTextColor": "#FF6A00",
  "btnBorder": "1px solid #FF6A00"
}
  • btnBgColor: color de contexto. Predeterminado: #FFFFFF.

  • btnBgTextColor: color de texto. Predeterminado: #FF6A00.

  • btnBorder: estilo de borde. Predeterminado: 1px solid #FF6A00.