CPqD Texto Fala – Exemplos em C

VERSÃO DE DESENVOLVIMENTO

O CPQD Texto Fala é um framework que permite converter texto genérico, como notícias ou diálogos, em fala natural. É possível integrar o CPQD Texto Fala nas mais variadas aplicações, desde aplicativos móveis até sistemas de diálogo para telefonia.

Este repositório possui três programas de exemplo implementados em C++. O programa example_tts demonstra o uso do básico do CPQD Texto Fala, utilizando síntese síncrona (bloqueia a thread até a síntese ser concluída). Já o programa example_tts_streaming demonstra o uso de síntese via streaming, que possibilita a entrega do áudio na medida em que a fala é sintetizada. E por fim o programa exemple_tts_template demostra o uso de templates do CPQD Texto Fala.

Releases

Sempre prefira utilizar uma versão estável dos programas de exemplo, ao invés do código contido no branch master.

Compilação e execução no Windows

Baixe o conteúdo do repositório em seu computador e crie um branch local apontando para a tag v4.10-V1:

# git clone https://github.com/CPqD/tts-examples-c.git
# git checkout -B v4.10-V1 tags/v4.10-V1

Para facilitar a criação dos projetos, o programa CMake pode ser utilizado via interface gráfica.

Os projetos serão criados de acordo com o tipo de compilador instalado na máquina. Os comandos aqui propostos estão sendo guiados pelo compilador Visual Studio.

Para criar os projetos:

1. Acesse o diretório source do repositório baixado;
2. Abra o programa CMake;
3. Insira as opções:
   • Source code: caminho da pasta source que possui o arquivo CMakeLists.txt
   • Build the binaries: caminho onde serão gerados os arquivos de build. Normalmente acrescentamos o diretório build no caminho do source code. Exemplo:/source/build
4. Clique em Configure e escolha o compilador Visual Studio versão 64 bits;
5. Clique em Generate para que as configurações sejam setadas no compilador;
6. A solution examples.sln e os projetos example_tts, example_tts_streaming e example_tts_template estarão disponíveis na pasta build.

Para compilar o projeto criado:

1. Abra solution examples.sln;
2. Altere a configuração para Release;
3. Clique com o botão direito no projeto example_tts na opção Build;
4. Clique com o botão direito no projeto example_tts_streaming na opção Build;
5. Clique com o botão direito no projeto example_tts_template na opção Build;
6. Os executáveis (example_tts.exe, example_tts_streaming.exe e example_tts_template) foram gerados na pasta Release.

Com os exectutáveis example_tts.exe, example_tts_streaming.exe e example_tts_template gerados, você pode testar o funcionamento da biblioteca do CPQD Texto Fala da seguinte maneira:

1. Rode o programa exemplo informando o caminho da instalação da biblioteca do CPQD Texto Fala:

   # example_tts.exe <caminho da instalação do CPQD Texto Fala>
   # example_tts_streaming.exe <caminho da instalação do CPQD Texto Fala>
   # example_tts_template.exe <caminho da instalação do CPQD Texto Fala> <caminho do arquivo do template> <caminho do arquivo de mensagem>
   

2. Os exemplos example_tts.exe e example_tts_streaming.exe irão gerar um arquivo example.wav contendo o texto sintetizado. O exemplo example_tts_template.exe irá gerar um arquivo contendo o texto processado pelo template;

3. Opcionalmente o texto a ser sintetizado pode ser informado via arquivo (example.txt). Caso o arquivo não seja encontrado, um texto padrão será sintetizado.

Maiores dúvidas, veja a documentação de instalação.

Compilação e execução no Linux

Baixe o conteúdo do repositório em seu computador e crie um branch local apontando para a tag v4.10-V1:

# git clone https://github.com/CPqD/tts-examples-c.git
# git checkout -B v4.10-V1 tags/v4.10-V1

Para facilitar a criação dos projetos, o programa CMake pode ser utilizado via linha de comando.

Os projetos serão criados de acordo com o tipo de compilador instalado na máquina.

Para criar os projetos:

1. Acesse o diretório source do repositório baixado;

2. Crie a pasta build;

3. Use o comando abaixo para criar e configurar os projetos:

   # cmake -Bbuild
   

4. Os projetos gerados estarão disponíveis na pasta build.

Para compilar o projeto criado:

1. Acesse a pasta build;

2. Execute o comando abaixo para compilar os programas de exemplo:

   # make
   

3. Os executáveis (example_tts, example_tts_streaming e example_tts_template) estarão na pasta build.

Com os programas de exemplo compilados, você poderá testar o funcionamento da biblioteca do CPqD Texto Fala da seguinte maneira:

1. Rode o programa exemplo informando o caminho da instalação da biblioteca do CPqD Texto Fala:

   # ./example_tts <caminho da instalação do CPqD Texto Fala>
   # ./example_tts_streaming <caminho da instalação do CPqD Texto Fala>
   # ./example_tts_template <caminho da instalação do CPQD Texto Fala> <caminho do arquivo do template> <caminho do arquivo de mensagem>
   

2. Os exemplos example_tts.exe e example_tts_streaming.exe irão gerar um arquivo example.wav contendo o texto sintetizado. O exemplo example_tts_template.exe irá gerar um arquivo contendo o texto processado pelo template;

3. Opcionalmente o texto a ser sintetizado pode ser informado via arquivo (example.txt). Caso o arquivo não seja encontrado, um texto padrão será sintetizado.

Maiores dúvidas, veja a documentação de instalação.

Documentação

Veja a documentação de como utilizar o CPqD Texto Fala em uma aplicação C.