A aplicação permite que o usuário insira um texto e, em troca, receba o áudio correspondente gerado através de uma API externa.
O objetivo do desafio foi criar uma aplicação simples em Laravel que:
- Permita ao usuário digitar um texto em um formulário.
- Consuma uma API de voz (Text-to-Speech) para converter o texto em áudio.
- Reproduza o áudio gerado para o usuário.
O projeto foi desenvolvido seguindo as boas práticas de programação, com uma estrutura organizada de rotas, controllers e views, e está hospedado em um repositório público.
2025-08-19.10-41-27.mp4
- Backend: PHP 8.1+
- Framework: Laravel 10.x
- Frontend: Blade Templates e HTML
- API: Google Text-to-Speech (ou a API que você utilizou)
Antes de começar, certifique-se de ter o seguinte software instalado em sua máquina:
- PHP 8.1 ou superior
- Composer
Siga os passos abaixo para executar o projeto em seu ambiente local:
-
Clone o repositório:
git clone https://github.com/Rafael-Luiz-Oliveira/laravel-text-to-speech.git cd laravel-text-to-speech -
Instale as dependências do PHP:
composer install
-
Configure o arquivo de ambiente:
- Copie o arquivo de exemplo
.env.examplepara um novo arquivo chamado.env.
cp .env.example .env
- Gere a chave da aplicação Laravel:
php artisan key:generate
- Copie o arquivo de exemplo
-
Configure as Credenciais do Google Cloud (Arquivo JSON ):
- Crie sua credencial: Este projeto se autentica no Google Cloud usando um arquivo de credenciais de Conta de Serviço (Service Account).
- Acesse o Google Cloud Console.
- No menu, vá para "IAM e Admin" > "Contas de Serviço".
- Selecione seu projeto e clique em "Criar Conta de Serviço". Dê um nome e uma descrição para ela.
- Conceda a esta conta o papel de "Usuário da API Cloud Text-to-Speech".
- Após criar a conta, clique nela, vá para a aba "Chaves", clique em "Adicionar Chave" > "Criar nova chave".
- Selecione o formato JSON e clique em "Criar". O download do arquivo de credenciais
.jsoncomeçará automaticamente.
- Armazene a credencial: Mova o arquivo
.jsonque você baixou para a pastastorage/credentials/do seu projeto Laravel. - Adicione o caminho ao arquivo
.env: Abra o arquivo.enve adicione a seguinte linha, certificando-se de que o caminho corresponde ao local onde você salvou o arquivo:GOOGLE_APPLICATION_CREDENTIALS="./storage/credentials/seu-arquivo-de-credenciais.json"
- Crie sua credencial: Este projeto se autentica no Google Cloud usando um arquivo de credenciais de Conta de Serviço (Service Account).
-
Execute o servidor de desenvolvimento:
php artisan serve
-
Acesse a aplicação:
- Abra seu navegador e acesse
http://127.0.0.1:8000.
- Abra seu navegador e acesse
- Acesse a página inicial da aplicação.
- Digite o texto que você deseja converter em voz no campo de texto.
- Clique no botão "Converter" (ou o nome que você deu ao botão ).
- O áudio será disponibilizado para que você consiga escutar