El Web SDK - H5 admite la personalización del estilo de la interfaz. Puede personalizar los colores, los íconos y los estilos de los marcos en la página de guía, la página de captura de documentos, la página de edición de resultados de OCR y la página de detección de vida.
La personalización de la interfaz para el Web SDK - H5 solo está disponible en el modo de integración móvil. Para personalizar la PC, consulte Web SDK - PC UI Custom Configuration Instructions.
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 utiliza el valor predeterminado.
Configuración incremental: para reducir el tamaño del cuerpo de la solicitud, pase únicamente los elementos de configuración que necesite modificar. Los elementos no especificados conservan sus valores predeterminados.
La cadena JSON no debe contener caracteres especiales de expresiones regulares.
Página de guía (guidePage)
La página de guía es la primera página que ven los usuarios y muestra los pasos e instrucciones de verificación. Esta página solo está disponible en el flujo del Web SDK.
|
Property |
Type |
Default |
Description |
|
|
Color CSS |
|
Color de fondo de la página |
|
|
Color CSS |
|
Color de fondo del botón |
|
|
Color CSS |
|
Color del texto del botón |
|
|
Sombra del botón |
||
|
|
URL de imagen |
|
Ícono del paso 1 en la página de guía de eKYC (60 x 60 px) |
|
|
URL de imagen |
|
Ícono del paso 2 en la página de guía de eKYC (60 x 60 px) |
|
|
URL de imagen |
|
Barra conectora de pasos en el lado izquierdo de la página de guía de eKYC (6 x 414 px) |
|
|
URL de imagen |
|
Ilustración de reconocimiento facial (393 x 393 px) |
|
|
URL de imagen |
|
Ilustración de escaneo de documentos (396 x 393 px) |
|
|
URL de imagen |
|
Ilustración para evitar oclusiones (210 x 210 px) |
|
|
URL de imagen |
|
Ilustración de iluminación adecuada (210 x 210 px) |
|
|
URL de imagen |
|
Ilustración de posicionamiento del celular (210 x 210 px) |
Página de captura de documentos (ocrPage)
En esta página, los usuarios fotografían sus documentos de identidad (credenciales, pasaportes y documentos similares). Puede personalizar el fondo, la superposición, el marco del visor y los íconos.
|
Property |
Type |
Default |
Description |
|
|
|
Color de fondo y opacidad de la página |
|
|
|
Color CSS |
|
Color del texto sobre la superposición |
|
|
|
Color y opacidad de la superposición |
|
|
|
URL de imagen |
|
Ícono para salir (30 x 54 px) |
|
|
URL de imagen |
|
Ícono para enviar (240 x 240 px) |
|
|
URL de imagen |
|
Marco del visor de documentos (996 x 594 px). Reemplace este valor para adaptar el marco a distintas formas y colores de credenciales y pasaportes. |
|
|
URL de imagen |
|
Ícono del álbum (144 x 144 px) |
Página de edición de resultados de OCR (ocrResultPage)
Esta página muestra los datos extraídos del documento y permite a los usuarios revisar y corregir los resultados.
|
Property |
Type |
Default |
Description |
|
|
Color CSS |
|
Color de fondo de la página |
|
|
Color CSS |
|
Color de fondo de la sugerencia superior |
|
|
Color CSS |
|
Color del texto de la sugerencia superior |
|
|
Color CSS |
|
Color del texto de la información de OCR |
|
|
Color CSS |
|
Color de fondo del campo de entrada |
|
|
Color CSS |
|
Color de fondo del botón |
|
|
Color CSS |
|
Color del texto del botón |
|
|
|
Color y opacidad de la superposición |
|
|
|
URL de imagen |
|
Ícono para salir (30 x 54 px) |
Página de detección de vida (facePage)
La página de detección de vida guía a los usuarios durante el proceso de verificación facial.
|
Property |
Type |
Default |
Description |
|
|
Color CSS |
|
Color de fondo de la página |
|
|
Color CSS |
|
Color del texto del título (para el mensaje de instrucción, como "Tome su celular y parpadee") |
|
|
Arreglo de 3 colores CSS |
|
Colores de la barra de progreso alrededor del visor, de claro a oscuro |
|
|
|
Color y opacidad de la superposición |
|
|
|
Color CSS |
|
Color del texto sobre la superposición |
|
|
URL de imagen |
|
Ícono para salir (30 x 54 px) |
Especificaciones de los recursos de imagen
Todas las propiedades de imagen aceptan URL de acceso público. Las imágenes de reemplazo deben coincidir con las dimensiones que se indican a continuación.
|
Property |
Page |
Dimensions (px) |
Description |
|
|
Guía |
60 x 60 |
Ícono del paso 1 |
|
|
Guía |
60 x 60 |
Ícono del paso 2 |
|
|
Guía |
6 x 414 |
Barra conectora de pasos |
|
|
Guía |
393 x 393 |
Ilustración de reconocimiento facial |
|
|
Guía |
396 x 393 |
Ilustración de escaneo de documentos |
|
|
Guía |
210 x 210 |
Ilustración para evitar oclusiones |
|
|
Guía |
210 x 210 |
Ilustración de iluminación adecuada |
|
|
Guía |
210 x 210 |
Ilustración de posicionamiento del celular |
|
|
Captura de documentos |
996 x 594 |
Marco del visor de documentos |
|
|
Captura de documentos |
144 x 144 |
Ícono del álbum |
|
|
Captura de documentos |
240 x 240 |
Ícono para enviar |
|
|
Captura de documentos, edición de resultados de OCR, detección de vida |
30 x 54 |
Ícono para salir |
Plantilla de configuración
Copie la siguiente plantilla y modifique únicamente las propiedades que desee personalizar.
const styleConfig = {
guidePage: {
backgroundColor: "white",
btnBgColor: "#fb5d01",
btnTextColor: "white",
btnShadow: "0 16px 32px 0 rgba(251, 115, 38, 0.3)",
circle1Img: "",
circle2Img: "",
leftBorderImg: "",
faceImg: "",
ocrImg: "",
shelterFromImg: "",
lightImg: "",
phoneImg: ""
},
ocrPage: {
ocrBgColor: "rgba(2, 2, 2, 0.8)",
tipColor: "white",
maskColor: "rgba(2, 2, 2, 0.7)",
backIconImg: "",
submitIconImg: "",
ocrPhotoBorderImg: "",
albumIconImg: ""
},
ocrResultPage: {
backgroundColor: "white",
topTipBgColor: "white",
topTipTextColor: "black",
ocrTextColor: "#333333",
inputBgColor: "#f7f7f7",
btnBgColor: "#fb5d01",
btnTextColor: "white",
maskColor: "rgba(2, 2, 2, 0.7)",
backIconImg: ""
},
facePage: {
backgroundColor: "white",
topTipColor: "#333333",
processBarColor: ["#FFA500", "#FF8C00", "rgba(237,119,49,1)"],
maskColor: "rgba(0, 0, 0, 0.6)",
maskTipColor: "white",
backIconImg: ""
}
};{
"guidePage": {
"backgroundColor": "white",
"btnBgColor": "#fb5d01",
"btnTextColor": "white",
"btnShadow": "0 16px 32px 0 rgba(251, 115, 38, 0.3)",
"circle1Img": "",
"circle2Img": "",
"leftBorderImg": "",
"faceImg": "",
"ocrImg": "",
"shelterFromImg": "",
"lightImg": "",
"phoneImg": ""
},
"ocrPage": {
"ocrBgColor": "rgba(2, 2, 2, 0.8)",
"tipColor": "white",
"maskColor": "rgba(2, 2, 2, 0.7)",
"backIconImg": "",
"submitIconImg": "",
"ocrPhotoBorderImg": "",
"albumIconImg": ""
},
"ocrResultPage": {
"backgroundColor": "white",
"topTipBgColor": "white",
"topTipTextColor": "black",
"ocrTextColor": "#333333",
"inputBgColor": "#f7f7f7",
"btnBgColor": "#fb5d01",
"btnTextColor": "white",
"maskColor": "rgba(2, 2, 2, 0.7)",
"backIconImg": ""
},
"facePage": {
"backgroundColor": "white",
"topTipColor": "#333333",
"processBarColor": [
"#FFA500",
"#FF8C00",
"rgba(237,119,49,1)"
],
"maskColor": "rgba(0, 0, 0, 0.6)",
"maskTipColor": "white",
"backIconImg": ""
}
}