Saltar al contenido principal

Búsqueda por imagen

El widget permite buscar productos a partir de una imagen, ya sea seleccionando un archivo del dispositivo o capturando con la cámara. El componente es ImageSearchModal.

Cómo funciona

  1. El usuario hace click en el botón "imagen" del input. Si features.imageSearch = false, el botón se oculta.
  2. Se abre el modal con dos vías:
    • Upload: drag & drop o <input type="file"> para JPG/PNG/WebP.
    • Cámara: getUserMedia({ video: true }) y captura en <canvas>.
  3. La imagen se envía al backend como multipart/form-data:
POST/api/widget/search/visual
curl -X POST https://api.neuroon.ai/api/widget/search/visual \
-H "X-Widget-Token: $WIDGET_TOKEN" \
-F "image=@product.jpg"

Controlador en WidgetSearchController.java.

  1. El backend extrae embeddings visuales, identifica posibles productos similares, genera un query en lenguaje natural y devuelve SearchResponse con aiResponse indicando la query usada.

Validaciones cliente-side

RestricciónValor
Formatosimage/jpeg, image/png, image/webp
Tamaño máximo10 MB
Resolución mínima recomendada256 × 256

Si el archivo no cumple, el modal muestra image.unsupportedFormat o image.fileTooLarge (requiere HTTPS y permiso explícito. Si el host aplicaPermissions-Policy, recomendamos camera=(self "https://cdn.neuroon.ai")`.

Próximas lecturas