net.idrnd.voicesdk.antispoof2

Class AntispoofEngine

java.lang.Object

net.idrnd.voicesdk.common.VoiceSdkNativePeer

net.idrnd.voicesdk.antispoof2.AntispoofEngine

All Implemented Interfaces:

java.lang.AutoCloseable

public class AntispoofEngine
extends VoiceSdkNativePeer

Performs the check for the set of possible voice spoofing attacks.

This class serves as gateway to native Voice SDK implementation and allocates resources on native heap. To release the allocated memory, AutoCloseable.close() method should be invoked when the instance is no longer needed.

Any method that delegates to native call may throw VoiceSdkEngineException

Field Summary

Fields inherited from class net.idrnd.voicesdk.common.VoiceSdkNativePeer

nativeId

Constructor Summary

Constructors

Constructor and Description
AntispoofEngine(java.lang.String initPath) Creates the instance and allocates native memory.

Method Summary

Modifier and Type	Method and Description
protected static long	init(java.lang.String initPath)
AntispoofResult	isSpoof(byte[] pcm16Bytes, int sampleRate) Detects spoofing in audio provided in PCM16 format.
AntispoofResult	isSpoof(float[] floatSamples, int sampleRate) Detects spoofing in audio provided in normalized float format.
AntispoofResult	isSpoof(short[] pcm16Samples, int sampleRate) Detects spoofing in audio provided in PCM16 format.
AntispoofResult	isSpoof(java.lang.String audioFile) Detects spoofing in audio file.
protected AntispoofResult	isSpoof1(byte[] pcm16Bytes, int sampleRate)
protected AntispoofResult	isSpoof2(short[] pcm16Samples, int sampleRate)
protected AntispoofResult	isSpoof3(float[] floatSamples, int sampleRate)
protected AntispoofResult	isSpoof4(java.lang.String audioFile)
protected void	release() This method should release resources on native layer (indirectly using nativeId)

Methods inherited from class net.idrnd.voicesdk.common.VoiceSdkNativePeer

close, equals, finalize, hashCode

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AntispoofEngine

public AntispoofEngine(java.lang.String initPath)

Creates the instance and allocates native memory.

Parameters:

initPath - full path to the directory with init data

Throws:

VoiceSdkEngineException - wraps native exceptions

Method Detail

isSpoof

public AntispoofResult isSpoof(byte[] pcm16Bytes,
                               int sampleRate)

Detects spoofing in audio provided in PCM16 format.

Parameters:

pcm16Bytes - Array of little-endian PCM16 audio bytes

sampleRate - Sample rate of the audio, Hz

Returns:

AntispoofResult

Throws:

VoiceSdkEngineException - wraps native exceptions

isSpoof

public AntispoofResult isSpoof(short[] pcm16Samples,
                               int sampleRate)

Detects spoofing in audio provided in PCM16 format.

Parameters:

pcm16Samples - Array of PCM16 audio samples

sampleRate - Sample rate of the audio, Hz

Returns:

AntispoofResult

Throws:

VoiceSdkEngineException - wraps native exceptions

isSpoof

public AntispoofResult isSpoof(float[] floatSamples,
                               int sampleRate)

Detects spoofing in audio provided in normalized float format.

Parameters:

floatSamples - Array of float audio samples (in [-1, 1] range)

sampleRate - Sample rate of the audio, Hz

Returns:

AntispoofResult

Throws:

VoiceSdkEngineException - wraps native exceptions

isSpoof

public AntispoofResult isSpoof(java.lang.String audioFile)

Detects spoofing in audio file.

Parameters:

audioFile - Path to the audio file

Returns:

AntispoofResult

Throws:

VoiceSdkEngineException - wraps native exceptions

init

protected static long init(java.lang.String initPath)

release

protected void release()

Description copied from class: VoiceSdkNativePeer

This method should release resources on native layer (indirectly using nativeId)

Specified by:

release in class VoiceSdkNativePeer

isSpoof1

protected AntispoofResult isSpoof1(byte[] pcm16Bytes,
                                   int sampleRate)

isSpoof2

protected AntispoofResult isSpoof2(short[] pcm16Samples,
                                   int sampleRate)

isSpoof3

protected AntispoofResult isSpoof3(float[] floatSamples,
                                   int sampleRate)

isSpoof4

protected AntispoofResult isSpoof4(java.lang.String audioFile)