TTS_GetEngineInfo¶

Retorna informações sobre o Texto Fala.

TTS_RETURN TTS_GetEngineInfo( const struct TTS_ENGINE_INFO **info )

info: Ponteiro para a variável do tipo const TTS_ENGINE_INFO * que receberá o endereço do objeto contendo as informações do Texto Fala. Esse objeto deve ser liberado pela aplicação através da função TTS_Free.

Essa função retorna um código de erro do tipo TTS_RETURN. Se o valor retornado for igual a zero (TTS_OK), a operação foi realizada com sucesso. Caso contrário, algum erro ocorreu durante a operação e o valor retornado corresponde a um dos códigos de erros descritos no Apêndice I.

O objeto TTS_ENGINE_INFO retornado conterá as informações relativas à instalação do Texto Fala em uso.

typedef struct TTS_ENGINE_INFO
{
    TTS_VERSION_INFO Version;

    char *CustomerName;

    uint32_t Capabilities;

    uint32_t MaxSessions;

    uint32_t CurrentSessions;

    uint32_t OperationState;

    uint32_t RemainingTime;

    uint32_t CommunicationErrors;

    uint64_t SynthesisCount;

    uint64_t SynthesisTime;

    char *LicenseServerURI;

} TTS_ENGINE_INFO;

Version: Versão do produto.
CustomerName: Nome do cliente para a qual a instalação do Texto Fala foi produzida.
Capabilities: Flags indicando as funcionalidades disponíveis. Os valores válidos são definidos pelas macros com prefixo TTS_CAP_.
MaxSessions: Número máximo de sessões. Esse valor indica a quantidade máxima de sessões que uma aplicação pode abrir simultaneamente.
CurrentSessions: Número de sessões atualmente em uso, ou seja, a quantidade sessões abertas simultamente pela aplicação.
OperationState: Retorna o estado de operação do produto.
RemainingTime: Retorna o tempo restante de funcionamento. No modo de operação ONLINE esse tempo permanece fixo. Caso o modo de operação seja OFFLINE, o tempo decrementará até que a comunicação com o servidor de licenças seja restabelecida. No modo de operação BLOCKED o valor será sempre zero.
CommunicationErrors: Retorna o número de erros de comunicação com o servidor de licença. Esse campo terá um valor maior que zero apenas se o modo de operação atual for OFFLINE ou BLOCKED.
SynthesisCount: Retorna o número sínteses de fala efetuadas até o momento.
SynthesisTime: Retorna o número de milisegundos de áudio produzidos até o momento.
LicenseServerURI: Retorna a URI do servidor de licenças. Consulte a seção Mecanismo de Proteção para mais detalhes.