verify_c_api.h

Go to the documentation of this file.

/* Copyright 2021 ID R&D Inc. All Rights Reserved. */

#pragma once

#include <voicesdk/core/core_c_api.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct VoiceSdkVerifyResult {
    float score;

    float probability;
} VoiceSdkVerifyResult;

typedef struct VoiceSdkVerifyStreamResult {
    VoiceSdkVerifyResult verify_result;

    VoiceSdkAudioInterval audio_interval;
} VoiceSdkVerifyStreamResult;

typedef struct VoiceSdkVerifyStreamResultArray {
    VoiceSdkVerifyStreamResult* data;

    size_t size;
} VoiceSdkVerifyStreamResultArray;

typedef struct VoiceSdkVoiceTemplateFactory VoiceSdkVoiceTemplateFactory;

VOICE_SDK_API
VoiceSdkVoiceTemplateFactory* VoiceSdkVoiceTemplateFactoryCreate(const char* init_path, char** error_msg);

VOICE_SDK_API
VoiceSdkVoiceTemplate* VoiceSdkVoiceTemplateFactoryCreateVoiceTemplateWavFile(
        const VoiceSdkVoiceTemplateFactory* factory, const char* wav_path, VoiceSdkChannelType channel_type,
        char** error_msg);

VOICE_SDK_API
VoiceSdkVoiceTemplate* VoiceSdkVoiceTemplateFactoryCreateVoiceTemplateAudioFile(
        const VoiceSdkVoiceTemplateFactory* factory, const char* audio_path, VoiceSdkChannelType channel_type,
        char** error_msg);

VOICE_SDK_API
VoiceSdkVoiceTemplate* VoiceSdkVoiceTemplateFactoryCreateVoiceTemplateFloatSamples(
        const VoiceSdkVoiceTemplateFactory* factory, const float* float_samples, size_t num_samples, size_t sample_rate,
        VoiceSdkChannelType channel_type, char** error_msg);

VOICE_SDK_API
VoiceSdkVoiceTemplate* VoiceSdkVoiceTemplateFactoryCreateVoiceTemplateSamples(
        const VoiceSdkVoiceTemplateFactory* factory, const int16_t* samples, size_t num_samples, size_t sample_rate,
        VoiceSdkChannelType channel_type, char** error_msg);

VOICE_SDK_API
VoiceSdkVoiceTemplate* VoiceSdkVoiceTemplateFactoryCreateVoiceTemplateBytes(const VoiceSdkVoiceTemplateFactory* factory,
                                                                            const uint8_t* bytes, size_t num_bytes,
                                                                            size_t sample_rate,
                                                                            VoiceSdkChannelType channel_type,
                                                                            char** error_msg);

VOICE_SDK_API
VoiceSdkVoiceTemplate* VoiceSdkVoiceTemplateFactoryMergeVoiceTemplates(const VoiceSdkVoiceTemplateFactory* factory,
                                                                       VoiceSdkVoiceTemplate** voice_templates,
                                                                       size_t num_voice_templates, char** error_msg);

VOICE_SDK_API
const char* VoiceSdkVoiceTemplateFactoryGetInitDataId(const VoiceSdkVoiceTemplateFactory* factory, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceTemplateFactoryGetMinimumAudioSampleRate(const VoiceSdkVoiceTemplateFactory* factory,
                                                           size_t* sample_rate, char** error_msg);

VOICE_SDK_API
void VoiceSdkVoiceTemplateFactoryRelease(VoiceSdkVoiceTemplateFactory* factory);

typedef struct VoiceSdkVoiceTemplateMatcher VoiceSdkVoiceTemplateMatcher;

VOICE_SDK_API
VoiceSdkVoiceTemplateMatcher* VoiceSdkVoiceTemplateMatcherCreate(const char* init_path, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceTemplateMatcherMatchVoiceTemplates(const VoiceSdkVoiceTemplateMatcher* matcher,
                                                     const VoiceSdkVoiceTemplate* template1,
                                                     const VoiceSdkVoiceTemplate* template2,
                                                     VoiceSdkVerifyResult* verify_result, char** error_msg);

VOICE_SDK_API
const char* VoiceSdkVoiceTemplateMatcherGetInitDataId(const VoiceSdkVoiceTemplateMatcher* matcher, char** error_msg);

VOICE_SDK_API
void VoiceSdkVoiceTemplateMatcherRelease(VoiceSdkVoiceTemplateMatcher* matcher);

typedef struct VoiceSdkVoiceVerifyStream VoiceSdkVoiceVerifyStream;

VOICE_SDK_API
VoiceSdkVoiceVerifyStream* VoiceSdkVoiceVerifyStreamCreate(const VoiceSdkVoiceTemplateFactory* factory,
                                                           const VoiceSdkVoiceTemplateMatcher* matcher,
                                                           const VoiceSdkVoiceTemplate* const* voice_templates,
                                                           size_t num_templates, size_t sample_rate,
                                                           size_t audio_context_length_seconds,
                                                           float window_length_seconds, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamReset(const VoiceSdkVoiceVerifyStream* verify_stream, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamAddFloatSamples(const VoiceSdkVoiceVerifyStream* verify_stream,
                                              const float* float_samples, size_t num_samples, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamAddSamples(const VoiceSdkVoiceVerifyStream* verify_stream, const int16_t* samples,
                                         size_t num_samples, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamAddBytes(const VoiceSdkVoiceVerifyStream* verify_stream, const uint8_t* bytes,
                                       size_t num_bytes, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamFinalize(const VoiceSdkVoiceVerifyStream* verify_stream, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamHasVerifyResults(const VoiceSdkVoiceVerifyStream* verify_stream, bool* has_results,
                                               char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamGetVerifyResult(const VoiceSdkVoiceVerifyStream* verify_stream,
                                              VoiceSdkVerifyStreamResultArray* verify_stream_result_array, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamGetVerifyResultForOneTemplate(const VoiceSdkVoiceVerifyStream* verify_stream,
                                                            VoiceSdkVerifyStreamResult* verify_stream_result,
                                                            char** error_msg);

VOICE_SDK_API
void VoiceSdkVoiceVerifyStreamRelease(VoiceSdkVoiceVerifyStream* verify_stream);

typedef struct VoiceSdkVoiceVerifyStreamOpus VoiceSdkVoiceVerifyStreamOpus;

VOICE_SDK_API
VoiceSdkVoiceVerifyStreamOpus* VoiceSdkVoiceVerifyStreamOpusCreate(const VoiceSdkVoiceTemplateFactory* factory,
                                                                   const VoiceSdkVoiceTemplateMatcher* matcher,
                                                                   const VoiceSdkVoiceTemplate* voice_template,
                                                                   size_t sample_rate,
                                                                   size_t audio_context_length_seconds,
                                                                   char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamOpusReset(const VoiceSdkVoiceVerifyStreamOpus* verify_stream, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamOpusAddPacket(const VoiceSdkVoiceVerifyStreamOpus* verify_stream, const uint8_t* bytes,
                                            size_t num_bytes, char** error_msg);
VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamOpusFinalize(const VoiceSdkVoiceVerifyStreamOpus* verify_stream, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamOpusHasVerifyResults(const VoiceSdkVoiceVerifyStreamOpus* verify_stream,
                                                   bool* has_results, char** error_msg);

VOICE_SDK_API
bool VoiceSdkVoiceVerifyStreamOpusGetVerifyResult(const VoiceSdkVoiceVerifyStreamOpus* verify_stream,
                                                  VoiceSdkVerifyStreamResult* verify_stream_result, char** error_msg);

VOICE_SDK_API
void VoiceSdkVoiceVerifyStreamOpusRelease(VoiceSdkVoiceVerifyStreamOpus* verify_stream);

VOICE_SDK_API
void VoiceSdkVerifyStreamResultArrayDataRelease(const VoiceSdkVerifyStreamResultArray* array);

#ifdef __cplusplus
}
#endif