Refactoring of chrome speech recognition architecture (CL1.2)

content/public/browser/speech_recognizer.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PUBLIC_BROWSER_SPEECH_RECOGNIZER_H_
 #define CONTENT_PUBLIC_BROWSER_SPEECH_RECOGNIZER_H_
 
 #include <string>
 
 #include "base/memory/ref_counted.h"
 #include "content/common/content_export.h"
 
 namespace net {
 class URLRequestContextGetter;
 }
 
 namespace content {
 
-class SpeechRecognizerDelegate;
+class SpeechRecognitionEventListener;
 
 // Records audio, sends recorded audio to server and translates server response
 // to recognition result.
+// TODO(primiano) remove this public interface as soon as we fix speech input
+// extensions.
 class SpeechRecognizer : public base::RefCountedThreadSafe<SpeechRecognizer> {
  public:
+
+  // TODO(primiano) Create(...) is transitional (until we fix speech input
+  // extensions) and should be removed soon. The manager should be the only one
+  // knowing the existence of SpeechRecognizer, thus the only one in charge of
+  // instantiating it.
   CONTENT_EXPORT static SpeechRecognizer* Create(
-      SpeechRecognizerDelegate* delegate,
+      SpeechRecognitionEventListener* event_listener,
       int caller_id,
       const std::string& language,
       const std::string& grammar,
       net::URLRequestContextGetter* context_getter,
       bool filter_profanities,
       const std::string& hardware_info,
       const std::string& origin_url);
 
   virtual ~SpeechRecognizer() {}
 
-  // Starts audio recording and does recognition after recording ends. The same
+  // Starts audio recording and the recognition process. The same
   // SpeechRecognizer instance can be used multiple times for speech recognition
   // though each recognition request can be made only after the previous one
   // completes (i.e. after receiving
-  // SpeechRecognizerDelegate::DidCompleteRecognition).
-  virtual bool StartRecording() = 0;
+  // SpeechRecognitionEventListener::OnRecognitionEnd).
+  virtual bool StartRecognition() = 0;
 
   // Stops recording audio and cancels recognition. Any audio recorded so far
   // gets discarded.
-  virtual void CancelRecognition() = 0;
+  virtual void AbortRecognition() = 0;
+
+  // Stops recording audio and finalizes recognition, possibly getting results.
+  virtual void StopAudioCapture() = 0;
+
+  // Checks wether the recognizer is active, that is, either capturing audio
+  // or waiting for a result.
+  virtual bool IsActive() const = 0;
+
+  // Checks wether the recognizer is capturing audio.
+  virtual bool IsCapturingAudio() const = 0;
 };
 
-}  // namespace speech
+}  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_SPEECH_RECOGNIZER_H_