eva-ia-robot 0.1.2 → 0.1.3

data/eva_ia_robot.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = "eva-ia-robot"
-  s.version     = "0.1.2"
+  s.version     = "0.1.3"
   s.description = "Gem integrada com Google Speech e Google Translate"
   s.summary     = "Command line"
   s.author      = "Henrique Utsch"

data/eva_ia_robot/eva-ia-robot.rb

@@ -1,5 +1,8 @@
-#!/bin/env ruby
 # encoding: utf-8
+# comandos.conf 
+# caminho completo execução Dir.pwd
+# documentar caminho completo
+#  modulos do ruby para instalar basta abrir o prompt de comando e digitar "gem install [nome]" ex: "gem install win32ole"
 require "cgi"
 require 'open-uri'
 require 'json'
@@ -7,64 +10,71 @@ require 'win32ole'
 require 'rbconfig'
 require 'fileutils'
 
+# carrega os arquivos .rb tentei com require mas não funcionou
 load 'eva-pergunta.rb'
 load 'eva-resposta.rb'
 load 'versao.rb'
+load 'os.rb'
 
+# teste mas ainda não sei como vou fazer isso.
 module HelloWorld
   def self.say
     "Hello World!"
   end
 end
 
-
-puts "teste"
+# tentei abrir o programa pelo system() mas não funcionou direito o WIN32OLE é uma biblioteca "dll" do windows
 shell = WIN32OLE.new('Shell.Application')
+# inicializa configuração
 frase = ""
 feedback = true
 beep = true
-  def os
-    @os ||= (
-      host_os = RbConfig::CONFIG['host_os']
-      case host_os
-      when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
-        'windows'
-      when /darwin|mac os/
-        'macosx'
-      when /linux/
-        'linux'
-      when /solaris|bsd/
-        'unix'
-      else
-        raise Error::WebDriverError, "unknown os: #{host_os.inspect}"
-      end
-    )
-  end
+
+ #  loop para ficar gravando o comando de voz repetidamente so sai do loop e finaliza o sistema se o comando "sair" for executado
 while frase !="sair" do
+  # se houver algum erro ele imprimi e continua o processamento
   begin
+    # chama o procedimento pergunta para gravar o audio 
+    # feedback true - habilita a resposta para repetir o comando
+    # feedback = false - desabilita a resposta para repetir o comndo
+    #  beep = true - habilita beep antes da gravação
+    #  beep = false - desabilita beep antes da gravação
+
+    #  a referência sobre a pergunta encontra-se no arquivo eva-pergunta.rb
 	p frase = pergunta(feedback,beep)
   rescue =>e
+    #  se houver erro simplesmente imprime
     puts e.message
   end
+
+  # OBSERVAÇÃO---------------------------------------
+  # Você pode alterar o valor de frase e de resposta.
+
+  # se a conversão do audio gravado em texto for igual a frase, ele executa os comandos e o feedback auditivo do sistema. 
 	if frase == 'eva'
+    # quando o usuário dar o comando eva o sitema responde falando "pois não"
+    # a referência sobre a resposta encontra-se no arquivo eva-resposta.rb
 		resposta('pois não')
 	end
 
   if frase == 'versão'
+    # recebe a verificação da versão do sistema
     resposta(versao())
-
   end
 
+  # desativa o feedback com o conteúdo "favor repetir o comando"
   if frase == 'desativar'
     resposta('sistema de resposta desativado')
     feedback = false
   end
 
-    if frase == 'ativar'
+  # ativa o feedback com o conteúdo "favor repetir o comando"
+  if frase == 'ativar'
     resposta('sistema de resposta ativado')
     feedback = true
   end
 
+   # desativa o feedback com o conteúdo "favor repetir o comando"
   if frase == 'desativar som'
     resposta('sistema de beep desativado')
     beep = false
@@ -101,43 +111,45 @@ resposta("hoje é #{semana[Time.now.wday]} dia #{Time.now.day.to_s} de #{mes[Tim
   end
 
     if frase == 'abrir word'
+      p "inicio execução #{Time.now}"
+        shell.ShellExecute("winword.exe", "", "", "open", 1)
     resposta('abrindo word')
-  shell.ShellExecute("winword.exe", "", "", "open", 1)
+    p "final execução #{Time.now}"
+
   end
 
-        if frase == 'finalizar word'
+  if frase == 'finalizar word'
+          system("taskkill /IM winword.exe")
     resposta('finalizando word')
-  system("taskkill /IM winword.exe")
+  
   end
 
   if frase == 'abrir illustrator'
-  resposta('abrindo ilustreitor')
-  shell.ShellExecute("illustrator.exe", "", "", "open", 1)
+    resposta('abrindo ilustreitor')
+    shell.ShellExecute("illustrator.exe", "", "", "open", 1)
   end
 
   if frase == 'finalizar illustrator'
-  resposta('finalizando ilustreitor')
-  system("taskkill /IM illustrator.exe")
+    resposta('finalizando ilustreitor')
+    system("taskkill /IM illustrator.exe")
   end
 
-    if frase == 'abrir prompt'
+  if frase == 'abrir prompt'
     resposta('abrindo prompt de comando')
-  shell.ShellExecute("cmd.exe", "", "", "open", 1)
+    shell.ShellExecute("cmd.exe", "", "", "open", 1)
   end
 
-        if frase == 'finalizar prompt'
+  if frase == 'finalizar prompt'
     resposta('finalizando prompt')
-  system("taskkill /IM cmd.exe")
+    system("taskkill /IM cmd.exe")
   end
 
-
-      if frase == 'sair'
+  if frase == 'sair'
     resposta('finalizando sistema de voz')
     resposta('tênha um bom dia')
   
   end
 
-
 	if frase == 'sistema operacional'
 		resposta("seu sistema operacional é #{os()}")
 	end

data/eva_ia_robot/eva-pergunta.rb

@@ -1,24 +1,49 @@
-#!/bin/env ruby
 # encoding: utf-8
+# Esse código transforma audio em texto via api do google speech
+
+# Win32/sound modulo para tocar um beep via script
 require 'win32/sound'
 include Win32
 
-
 def pergunta(feedback,beep)
+# imprimi na tela um feedback visual de quando dar o comando verbal	
 	p 'gravando ...'
+	# verifica se a configuração auditiva para dar o comando verbal esta setada na configuração
 	if beep== true
+	# Emite um som antes da gravação da voz
 	 Sound.beep(1500, 200)
 	end
+
+	p "inicio gravação #{Time.now}"
+	# utilizamos o sox que é um programa para gravar audio via linha de comando - no caso salva com o nome test.flac que é o formato do google
+	# silence -l significa que o rec.exe grava o audio e ao perceber o silencio finaliza a gravação e salva o arquivo ja no formato permitido pelo google speech
 	system('rec.exe -r 16000 test.flac silence -l 1 0.1 1% 1 1.5 1%')
+	# feedback para o envio do arquivo para o google
 	p 'Enviando arquivo ...'
+	p "inicio envio #{Time.now}"
+	# envia o arquivo test.flac para o servidor e este retorna um json
+	# {\"status\":0,\"id\":\"\",\"hypotheses\":[{\"utterance\":\"abrir word\",\"confidence\":0.82485712}]}\n"
+	#  status =>0 - significa sucesso
+	#  status =>5 - significa que o audio não foi reconhecido
+	#  atterance => texto - o texto convertido
+
+
 	request = %x(wget.exe -q -U "rate=16000" -O - "http://www.google.com/speech-api/v1/recognize?lang=pt-BR&client=Mozilla/5.0" --post-file test.flac --header="Content-Type: audio/x-flac; rate=16000")
+	# loop que corrige um bug de sair do programa quando o tempo de gravação é muito grande ou quando o json retorna algum erro ou simplesmente nulo
 	begin
+	# força a codificação com acento
+	p request
 	request.force_encoding('utf-8')
+	# converte a resposta da requisição para json
 	resposta = JSON.parse(request)
+	p "chegada resposta #{Time.now}"
 	rescue =>e
+		# se houver erro ele simplesmente exibe a mensagem de erro e continua o seu processamento normal
 		puts e.message
 	end
+#  se o status for 5, quer dizer que o texto não foi reconhecido adequadamente então ele pede para repetir o comando caso contrario ele retorna o texto
 	if resposta["status"] == 5
+		# a variavel feedback controla se vai ter resposta por audio ou apenas visual
 		if feedback==true
 		resposta("favor repêtir o comando")
 		else
@@ -26,8 +51,10 @@ def pergunta(feedback,beep)
 	    end
 			
 	else
+		# pega apenas o texto do json
 		resp = resposta["hypotheses"][0]["utterance"]
 		puts resp
+		#  retorna o texto
 		return resp
 	end
 end

data/eva_ia_robot/eva-resposta.rb

@@ -1,8 +1,16 @@
+# Esse código transforma texto em audio via api do google Translate
 def resposta(texto)
+	#converte o texto para a requisição via url
 	texto = CGI::escape(texto)
+	#envia o texto ao servidor do google e retorna os dados de audio
+	#modifique a tag pt para alterar o idioma a ser convertido
 	url = 'http://translate.google.com/translate_tts?ie=UTF-8&tl=pt&q='+texto
+	# abre o arquivo localmente com o nome arquivo.mp3 e escreve os dados da requisição para salva-los localmente
 	  open("arquivo.mp3", "wb") do |file|
+	  		#Escreve dentro do arquivo e já salva
 	        file.write(open(url).read)
 	  end
+	# system executa um comando no prompt 
+	# play.exe executa audio via linha de comando para não precisar de um player externo. 
 	system('play.exe arquivo.mp3')
 end

data/eva_ia_robot/os.rb

@@ -0,0 +1,23 @@
+ # encoding: utf-8
+ # verifica o sistema operacional e retorna o nome do sistema em formato texto
+require 'rbconfig'
+
+ def os
+    @os ||= (
+      host_os = RbConfig::CONFIG['host_os']
+      case host_os
+      when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+        'windows'
+      when /darwin|mac os/
+        'macosx'
+      when /linux/
+        'linux'
+      when /solaris|bsd/
+        'unix'
+      else
+        raise Error::WebDriverError, "unknown os: #{host_os.inspect}"
+      end
+    )
+  end
+
+  p os()

data/eva_ia_robot/versao.rb

@@ -1,4 +1,3 @@
-#!/bin/env ruby
 # encoding: utf-8
 require 'open-uri'
 require 'nokogiri'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eva-ia-robot
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
   prerelease: 
 platform: ruby
 authors:
@@ -22,6 +22,7 @@ files:
 - eva_ia_robot/eva-ia-robot.rb
 - eva_ia_robot/eva-pergunta.rb
 - eva_ia_robot/eva-resposta.rb
+- eva_ia_robot/os.rb
 - eva_ia_robot/vagrantlistbox.rb
 - eva_ia_robot/versao.rb
 - eva_ia_robot/libgomp-1.dll