O que este módulo faz?
- Ele utiliza o Google para gerar áudios utilizando um texto, chamado de Text to Speech ou, TTS.
Instalação:
- Rode o código abaixo para instalar via
NPM
:
$ npm i @killovsky/gtts
- Rode o código abaixo para instalar via
git
:
$ git clone https://github.com/KillovSky/gTTS.git
O que este módulo tem de especial?
- Assim como o da NASA, muitas coisas, confira abaixo:
-
Neste módulo, os erros não afetam o funcionamento, o que significa que apesar de qualquer erro, os valores 'sempre' estarão lá para que você não seja afetado.
-
Os erros serão inseridos na resposta com uma explicação sobre o que causou eles, facilitando para você entender.
-
A falta de especificação de um parâmetro retornará um áudio padrão, impedindo que você sofra falhas graves.
-
Os headers estão inseridos na resposta, facilitando para saber detalhes que podem lhe ser uteis.
-
Não existem dependências de módulos de terceiro, tudo é feito usando o puro Node.js
.
-
Cada linha do código possui uma explicação do que está rodando ou vai rodar, ou seja, o código INTEIRO é explicado, linha por linha.
-
É 'ilimitado', permite o download do arquivo de som, assim como retornará uma buffer, caso você prefira desta forma.
-
E muitas outras coisas, confira o código para entender!
Como testar este módulo:
- Basta abrir um terminal na pasta do módulo e digitar:
$ npm test
Como utilizar este módulo:
- Existem diversas formas de utilizar, mas como se trata de um script que faz uso de
Promises
, irei dar dois exemplos que funcionam bem, lembrando, caso você não especifique nada, retornará um valor padrão.
[Clique para exibir] → Descrição de cada parâmetro da execução:
create('LANGUAGE', 'TEXT', 'DOWNLOAD', 'PATH')
create()
languages()
Exemplos de uso:
const gtts = require('@killovsky/gtts');
gtts.create('LANGUAGE', 'TEXT', 'DOWNLOAD', 'PATH').then(data => {
})
const gtts = require('@killovsky/gtts');
const data = await gtts.create('LANGUAGE', 'TEXT', 'DOWNLOAD', 'PATH');
Código já prontos [.then]:
const gtts = require('@killovsky/gtts');
gtts.create('en', 'I love you', true, './').then(data => console.log(data));
Código já prontos [async/await]:
const gtts = require('@killovsky/gtts');
const data = await gtts.create('en', 'I love you', true, './');
console.log(data);
(async () => {
})();
Exemplo de resultado com explicações:
{
"date": "String | Data [YYYY-MM-DD HH:MM:SS]",
"error": "true | false",
"dev_msg": "String / false | Mensagem adicional de erro",
"error_msg": "String / false | Códigos de erros de execução",
"code": "Number | String | Código de erro HTTP",
"explain": {
"code": "Number / String | Código escrito de HTTP",
"why": "String | Explicação do código HTTP"
},
"headers": {
"date": "String | Data escrita da requisição",
"content-type": "String | Tipo de resposta",
"Outros": "E vários outros headers, faça uma requisição para obter todos."
},
"gtts": {
"local": "String | Local do download, se requisitado",
"buffer": "Buffer | Buffer do arquivo para utilização"
}
}
Exemplo utilizável de resultado:
{
"date": "22/07/2022 01:06:05",
"error": false,
"dev_msg": false,
"error_msg": false,
"code": 200,
"explain": {
"code": "OK",
"why": "The request is OK, this response depends on the HTTP method used."
},
"headers": {
"content-type": "audio/mpeg",
"cache-control": "no-cache, no-store, max-age=0, must-revalidate",
"pragma": "no-cache",
"date": "Sat, 23 Jul 2022 03:52:11 GMT"
},
"gtts": {
"local": "C:\\Users\\[My_User]\\Documents\\GitHub\\gTTS\\Samples\\test.mp3",
"buffer": "Not available in default JSON."
}
}
Perguntas e Respostas:
- Isso é bem similar ao seu módulo do Projeto APOD da NASA, não é?
Sim, é por que quero criar sistemas fáceis de entender e usar, decidi que a melhor forma seria fazendo eles de forma similar, deixando o código bem simples para qualquer um que vier de outros projetos meus.
- Por que não usou
axios
ou módulos do tipo?
Esse meio exige instalação de módulos de terceiro, quero fazer meus sistemas sem dependências, nada além do próprio Node.js
, pois tenho foco em uma única tarefa: ser simples.
- O que é proibido ao usar este módulo?
Você jamais deve abusar de qualquer programa, sempre crie um limitador de tempo ou armazene a ultima resposta e use ela, evite ficar utilizando um programa deste estilo muitas vezes seguidas sem esperar.
Suporte