Call Center SDK  1.11.3
Public Types | Public Member Functions | Static Public Member Functions | List of all members
voicesdk::AntispoofEngine Class Referenceabstract

Class for detecting spoofing attacks in audio with human speech. This is an entry point for voice antispoofing. AntispoofEngine is thread-safe. More...

#include <voicesdk/antispoof2/antispoof.h>

Public Types

using Ptr = std::shared_ptr< AntispoofEngine >
 Smart pointer to AntispoofEngine instance.
 

Public Member Functions

virtual AntispoofResult isSpoof (const uint8_t *pcm16Bytes, size_t bytesNum, int sampleRate) const =0
 
virtual AntispoofResult isSpoof (const int16_t *pcm16Samples, size_t samplesNum, int sampleRate) const =0
 
virtual AntispoofResult isSpoof (const float *floatSamples, size_t samplesNum, int sampleRate) const =0
 
virtual AntispoofResult isSpoof (const std::string &audioFile) const =0
 Tests whether given audio file contains spoofed speech. More...
 

Static Public Member Functions

static AntispoofEngine::Ptr create (const std::string &initPath)
 Creates AntispoofEngine instance. More...
 

Detailed Description

Class for detecting spoofing attacks in audio with human speech. This is an entry point for voice antispoofing. AntispoofEngine is thread-safe.

Member Function Documentation

◆ create()

static AntispoofEngine::Ptr voicesdk::AntispoofEngine::create ( const std::string &  initPath)
static

Creates AntispoofEngine instance.

Parameters
initPathPath to directory containing antispoof.json file or path to custom configuration file (*.json)
Returns
Smart pointer to created AntispoofEngine instance
Exceptions
std::runtime_errorif runtime error occurred

◆ isSpoof() [1/4]

virtual AntispoofResult voicesdk::AntispoofEngine::isSpoof ( const float *  floatSamples,
size_t  samplesNum,
int  sampleRate 
) const
pure virtual

Tests whether given audio samples contain spoofed speech

Parameters
floatSamplesInput audio as a float samples array (in [-1, 1] range)
samplesNumSize of floatSamples array
sampleRateInput audio sample rate
Returns
AntispoofResult object
Exceptions
std::runtime_errorif runtime error occurred

◆ isSpoof() [2/4]

virtual AntispoofResult voicesdk::AntispoofEngine::isSpoof ( const int16_t *  pcm16Samples,
size_t  samplesNum,
int  sampleRate 
) const
pure virtual

Tests whether given audio samples contain spoofed speech

Parameters
pcm16SamplesInput audio as a PCM16 samples array
samplesNumSize of pcm16Samples array
sampleRateInput audio sample rate
Returns
AntispoofResult object
Exceptions
std::runtime_errorif runtime error occurred

◆ isSpoof() [3/4]

virtual AntispoofResult voicesdk::AntispoofEngine::isSpoof ( const std::string &  audioFile) const
pure virtual

Tests whether given audio file contains spoofed speech.

Parameters
audioFilePath to audio file
Returns
AntispoofResult object
Exceptions
std::runtime_errorif runtime error occurred

◆ isSpoof() [4/4]

virtual AntispoofResult voicesdk::AntispoofEngine::isSpoof ( const uint8_t *  pcm16Bytes,
size_t  bytesNum,
int  sampleRate 
) const
pure virtual

Tests whether given audio bytes contain spoofed speech

Parameters
pcm16BytesInput audio as a little-endian PCM16 byte array
bytesNumSize of pcm16Bytes
sampleRateInput audio sample rate
Returns
AntispoofResult object
Exceptions
std::runtime_errorif runtime error occurred