voicesdk::ident::IdentificationEngine Class Reference

Identification engine class used for creating identification list and for identification itself. More...

#include <voicesdk/identification/identification.h>

Public Types
using	Ptr = std::shared_ptr< IdentificationEngine >

Public Member Functions
virtual IdentificationList::Ptr	CreateIdentificationList (const std::vector< voicesdk::VoiceTemplate::Ptr > &voice_templates)=0
	Creates a list for identification from given voice templates. More...
virtual IdentificationResult	Identify (const voicesdk::VoiceTemplate::Ptr &voice_template, const IdentificationList::Ptr &identification_list, const float acceptance_level=-2.0f)=0
	Performs an identification of given voice template using given identification list. More...
virtual void	EnrichIdentificationList (const IdentificationList::Ptr &identification_list, const std::vector< voicesdk::VoiceTemplate::Ptr > &voice_templates)=0
	Enrich identification list with new templates. More...

Static Public Member Functions
static Ptr	Create (const std::string &initDataPath)
	Factory method used for creating an instance of identification engine. More...

Detailed Description

Identification engine class used for creating identification list and for identification itself.

Member Function Documentation

Create()

static Ptr voicesdk::ident::IdentificationEngine::Create ( const std::string &  initDataPath )

static

Factory method used for creating an instance of identification engine.

Parameters

initDataPath

path to init data

Returns

identification engine instance

CreateIdentificationList()

virtual IdentificationList::Ptr voicesdk::ident::IdentificationEngine::CreateIdentificationList ( const std::vector< voicesdk::VoiceTemplate::Ptr > &  voice_templates )

pure virtual

Creates a list for identification from given voice templates.

Parameters

voiceTemplates

vector of voice templates which will be used for identification (each template should be created with M_TI_X_2 verify method using 8k init data)

Returns

created identification list

EnrichIdentificationList()

virtual void voicesdk::ident::IdentificationEngine::EnrichIdentificationList ( const IdentificationList::Ptr &  identification_list, const std::vector< voicesdk::VoiceTemplate::Ptr > &  voice_templates  )

pure virtual

Enrich identification list with new templates.

Parameters

identificationList	identification list that will be enriched
voiceTemplates	vector of voice templates which will be used for identification list enrichment (each template should be created with M_TI_X_2 verify method using 8k init data)

Identify()

virtual IdentificationResult voicesdk::ident::IdentificationEngine::Identify ( const voicesdk::VoiceTemplate::Ptr &  voice_template, const IdentificationList::Ptr &  identification_list, const float  acceptance_level = -2.0f  )

pure virtual

Performs an identification of given voice template using given identification list.

Parameters

voiceTemplate	speakers to identify voice template (template should be created with M_TI_X_2 verify method using 8k init data)
identificationList	identification list to search speaker in
acceptanceLevel	optional parameter that could be used for finer identification threshold adjustment. The greater this parameter, the smaller amount of templates from the identification list might be considered as similar to the passed template. Default value is -2.0.

Returns

identification result