Home | History | Annotate | Download | only in speech
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef CONTENT_BROWSER_SPEECH_SPEECH_RECOGNITION_DISPATCHER_HOST_H_
      6 #define CONTENT_BROWSER_SPEECH_SPEECH_RECOGNITION_DISPATCHER_HOST_H_
      7 
      8 #include "base/memory/scoped_ptr.h"
      9 #include "base/memory/weak_ptr.h"
     10 #include "content/common/content_export.h"
     11 #include "content/public/browser/browser_message_filter.h"
     12 #include "content/public/browser/speech_recognition_event_listener.h"
     13 #include "net/url_request/url_request_context_getter.h"
     14 
     15 struct SpeechRecognitionHostMsg_StartRequest_Params;
     16 
     17 namespace content {
     18 
     19 class SpeechRecognitionManager;
     20 struct SpeechRecognitionResult;
     21 
     22 // SpeechRecognitionDispatcherHost is a delegate for Speech API messages used by
     23 // RenderMessageFilter. Basically it acts as a proxy, relaying the events coming
     24 // from the SpeechRecognitionManager to IPC messages (and vice versa).
     25 // It's the complement of SpeechRecognitionDispatcher (owned by RenderView).
     26 class CONTENT_EXPORT SpeechRecognitionDispatcherHost
     27     : public BrowserMessageFilter,
     28       public SpeechRecognitionEventListener {
     29  public:
     30   SpeechRecognitionDispatcherHost(
     31       bool is_guest,
     32       int render_process_id,
     33       net::URLRequestContextGetter* context_getter);
     34 
     35   base::WeakPtr<SpeechRecognitionDispatcherHost> AsWeakPtr();
     36 
     37   // SpeechRecognitionEventListener methods.
     38   virtual void OnRecognitionStart(int session_id) OVERRIDE;
     39   virtual void OnAudioStart(int session_id) OVERRIDE;
     40   virtual void OnEnvironmentEstimationComplete(int session_id) OVERRIDE;
     41   virtual void OnSoundStart(int session_id) OVERRIDE;
     42   virtual void OnSoundEnd(int session_id) OVERRIDE;
     43   virtual void OnAudioEnd(int session_id) OVERRIDE;
     44   virtual void OnRecognitionEnd(int session_id) OVERRIDE;
     45   virtual void OnRecognitionResults(
     46       int session_id,
     47       const SpeechRecognitionResults& results) OVERRIDE;
     48   virtual void OnRecognitionError(
     49       int session_id,
     50       const SpeechRecognitionError& error) OVERRIDE;
     51   virtual void OnAudioLevelsChange(int session_id,
     52                                    float volume,
     53                                    float noise_volume) OVERRIDE;
     54 
     55   // BrowserMessageFilter implementation.
     56   virtual bool OnMessageReceived(const IPC::Message& message,
     57                                  bool* message_was_ok) OVERRIDE;
     58   virtual void OverrideThreadForMessage(
     59       const IPC::Message& message,
     60       BrowserThread::ID* thread) OVERRIDE;
     61 
     62   virtual void OnChannelClosing() OVERRIDE;
     63 
     64  private:
     65   virtual ~SpeechRecognitionDispatcherHost();
     66 
     67   void OnStartRequest(
     68       const SpeechRecognitionHostMsg_StartRequest_Params& params);
     69   void OnStartRequestOnIO(
     70       int embedder_render_process_id,
     71       int embedder_render_view_id,
     72       const SpeechRecognitionHostMsg_StartRequest_Params& params,
     73       bool filter_profanities);
     74   void OnAbortRequest(int render_view_id, int request_id);
     75   void OnStopCaptureRequest(int render_view_id, int request_id);
     76 
     77   bool is_guest_;
     78   int render_process_id_;
     79   scoped_refptr<net::URLRequestContextGetter> context_getter_;
     80 
     81   // Used for posting asynchronous tasks (on the IO thread) without worrying
     82   // about this class being destroyed in the meanwhile (due to browser shutdown)
     83   // since tasks pending on a destroyed WeakPtr are automatically discarded.
     84   base::WeakPtrFactory<SpeechRecognitionDispatcherHost> weak_factory_;
     85 
     86   DISALLOW_COPY_AND_ASSIGN(SpeechRecognitionDispatcherHost);
     87 };
     88 
     89 }  // namespace content
     90 
     91 #endif  // CONTENT_BROWSER_SPEECH_SPEECH_RECOGNITION_DISPATCHER_HOST_H_
     92