net.idrnd.voicesdk.identification

Class IdentificationEngine

java.lang.Object

net.idrnd.voicesdk.common.VoiceSdkNativePeer

net.idrnd.voicesdk.identification.IdentificationEngine

All Implemented Interfaces:

java.lang.AutoCloseable

public class IdentificationEngine
extends VoiceSdkNativePeer

Identification engine class used for creating identification list and for identification itself. 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
IdentificationEngine(java.lang.String initPath) Initializes the engine, allocating native memory.

Method Summary

Modifier and Type	Method and Description
IdentificationList	createIdentificationList(VoiceTemplate[] voiceTemplates) Creates a list for identification from given voice templates
void	enrichIdentificationList(IdentificationList identificationList, VoiceTemplate[] voiceTemplates) Enriches identification list with given voice templates
IdentificationResult	identify(VoiceTemplate voiceTemplate, IdentificationList identificationList)
IdentificationResult	identify(VoiceTemplate voiceTemplate, IdentificationList identificationList, float acceptanceLevel) Performs an identification of given voice template using given identification list
IdentificationResult	identify1(VoiceTemplate voiceTemplate, IdentificationList identificationList, float acceptanceLevel)
IdentificationResult	identify2(VoiceTemplate voiceTemplate, IdentificationList identificationList)
protected static long	init(java.lang.String initPath)
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

IdentificationEngine

public IdentificationEngine(java.lang.String initPath)

Initializes the engine, allocating native memory.

Parameters:

initPath - path to init data

Throws:

VoiceSdkEngineException - wraps native exceptions

Method Detail

createIdentificationList

public IdentificationList createIdentificationList(VoiceTemplate[] voiceTemplates)

Creates a list for identification from given voice templates

Parameters:

voiceTemplates - array 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

identify

public IdentificationResult identify(VoiceTemplate voiceTemplate,
                                     IdentificationList identificationList,
                                     float acceptanceLevel)

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 - 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.

Returns:

identification result

identify

public IdentificationResult identify(VoiceTemplate voiceTemplate,
                                     IdentificationList identificationList)

enrichIdentificationList

public void enrichIdentificationList(IdentificationList identificationList,
                                     VoiceTemplate[] voiceTemplates)

Enriches identification list with given voice templates

Parameters:

identificationList - identification list that will be enriched

voiceTemplates - array 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)

init

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

identify1

public IdentificationResult identify1(VoiceTemplate voiceTemplate,
                                      IdentificationList identificationList,
                                      float acceptanceLevel)

identify2

public IdentificationResult identify2(VoiceTemplate voiceTemplate,
                                      IdentificationList identificationList)

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