Documentación Técnica y API

Principios de Integración

Garantice la identidad de sus usuarios con biometría de voz robusta siguiendo nuestras directrices tecnológicas:

• UX Cero Fricción: Procesos de identidad ágiles sin necesidad de configuraciones técnicas por parte del usuario.
• Captura Inteligente (VAD): El sistema detecta automáticamente cuándo el usuario empieza a hablar, eliminando la rigidez de los cronómetros.
• Integridad Forense: Auditoría en tiempo real para garantizar la autenticidad de cada muestra de identidad.
• Simplicidad de Grado Bancario: Flujo orquestado que reduce la complejidad técnica a un protocolo ágil y seguro.

Arquitectura de Comunicación

El sistema está diseñado para delegar la complejidad biométrica en el **Identity Hub**, permitiendo que su aplicación se enfoque en la experiencia del usuario:

Detalles del Canal de Identidad

El Identity Hub procesa audio **16-bit PCM RAW** a una frecuencia de muestreo de **16,000 Hz** (Mono). Incluye tecnología **Auto-Trigger** para sincronizar la captura exactamente con el habla del usuario.

Etapa 1 — Negociación Forense

1. Servidor Listo (Handshake) — El Identity Hub confirma la conexión segura y el inicio de la sesión forense.
2. Activación por Voz (Auto-Trigger) — El servidor notifica mediante "voice_started" cuando detecta el inicio del habla del usuario.
3. Canal Seguro Habilitado — El servidor activa la recepción de datos para la validación de identidad.

Etapa 2 — Ingesta de Tramas Binarias

1. Envío de Tramas de Audio — Streaming de audio seguro optimizado para una validación de identidad instantánea.
2. Validación de Integridad — Protección avanzada para garantizar que la identidad es capturada en vivo.
3. Cierre de Canal — Notificación de fin de transmisión para consolidar el veredicto final.
4. Veredicto de Identidad — Respuesta instantánea con la decisión de acceso (ALLOW/DENY).

// 1. Inicializar captura a 16,000 Hz (Requerido)
const audioCtx = new AudioContext({ sampleRate: 16000 });
const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
const source = audioCtx.createMediaStreamSource(stream);
const processor = audioCtx.createScriptProcessor(4096, 1, 1);

// 2. Procesamiento de tramas bit-a-bit
processor.onaudioprocess = (e) => {
  const input = e.inputBuffer.getChannelData(0); // Float32 de -1.0 a 1.0
  const pcm16 = new Int16Array(input.length);
  
  for (let i = 0; i < input.length; i++) {
    // Conversión a PCM 16-bit Lineal
    const s = Math.max(-1, Math.min(1, input[i]));
    pcm16[i] = s < 0 ? s * 0x8000 : s * 0x7FFF;
  }

  // 3. Envío al canal de identidad seguro
  if (socket.readyState === WebSocket.OPEN) {
    socket.send(pcm16.buffer);
  }
};

source.connect(processor);
processor.connect(audioCtx.destination);

SDK Acelerador de Identidad

HearthingX suministra librerías de alto nivel que automatizan la gestión de buffers de audio y la firma forense.

npm install ./hearthingx-identity-sdk-2.0.0.tgz

const hub = new IdentityHubClient('https://api.hub.hearthingx.com');
const session = await hub.init('login', deviceId);
const result = await hub.stream(session.sessionId);

Respuestas de Seguridad y Calidad

Si la identidad no puede ser confirmada, el sistema devuelve códigos accionables: