content/renderer/pepper/pepper_platform_audio_input.h

   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_RENDERER_PEPPER_PEPPER_PLATFORM_AUDIO_INPUT_H_
   6 #define CONTENT_RENDERER_PEPPER_PEPPER_PLATFORM_AUDIO_INPUT_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "base/compiler_specific.h"
  12 #include "base/memory/ref_counted.h"
  13 #include "base/memory/scoped_ptr.h"
  14 #include "base/memory/weak_ptr.h"
  15 #include "media/audio/audio_input_ipc.h"
  16 #include "media/audio/audio_parameters.h"
  17
  18 class GURL;
  19
  20 namespace base {
  21 class MessageLoopProxy;
  22 }
  23
  24 namespace media {
  25 class AudioParameters;
  26 }
  27
  28 namespace content {
  29
  30 class PepperAudioInputHost;
  31 class PepperMediaDeviceManager;
  32
  33 // PepperPlatformAudioInput is operated on two threads: the main thread (the
  34 // thread on which objects are created) and the I/O thread. All public methods,
  35 // except the destructor, must be called on the main thread. The notifications
  36 // to the users of this class (i.e. PepperAudioInputHost) are also sent on the
  37 // main thread. Internally, this class sends audio input IPC messages and
  38 // receives media::AudioInputIPCDelegate notifications on the I/O thread.
  39
  40 class PepperPlatformAudioInput
  41     : public media::AudioInputIPCDelegate,
  42       public base::RefCountedThreadSafe<PepperPlatformAudioInput> {
  43  public:
  44   // Factory function, returns NULL on failure. StreamCreated() will be called
  45   // when the stream is created.
  46   static PepperPlatformAudioInput* Create(
  47       int render_frame_id,
  48       const std::string& device_id,
  49       const GURL& document_url,
  50       int sample_rate,
  51       int frames_per_buffer,
  52       PepperAudioInputHost* client);
  53
  54   // Called on main thread.
  55   void StartCapture();
  56   void StopCapture();
  57   // Closes the stream. Make sure to call this before the object is destructed.
  58   void ShutDown();
  59
  60   // media::AudioInputIPCDelegate.
  61   void OnStreamCreated(base::SharedMemoryHandle handle,
  62                        base::SyncSocket::Handle socket_handle,
  63                        int length,
  64                        int total_segments) override;
  65   void OnVolume(double volume) override;
  66   void OnStateChanged(media::AudioInputIPCDelegate::State state) override;
  67   void OnIPCClosed() override;
  68
  69  protected:
  70   ~PepperPlatformAudioInput() override;
  71
  72  private:
  73   friend class base::RefCountedThreadSafe<PepperPlatformAudioInput>;
  74
  75   PepperPlatformAudioInput();
  76
  77   bool Initialize(int render_frame_id,
  78                   const std::string& device_id,
  79                   const GURL& document_url,
  80                   int sample_rate,
  81                   int frames_per_buffer,
  82                   PepperAudioInputHost* client);
  83
  84   // I/O thread backends to above functions.
  85   void InitializeOnIOThread(int session_id);
  86   void StartCaptureOnIOThread();
  87   void StopCaptureOnIOThread();
  88   void ShutDownOnIOThread();
  89
  90   void OnDeviceOpened(int request_id, bool succeeded, const std::string& label);
  91   void CloseDevice();
  92   void NotifyStreamCreationFailed();
  93
  94   // Can return NULL if the RenderFrame referenced by |render_frame_id_| has
  95   // gone away.
  96   PepperMediaDeviceManager* GetMediaDeviceManager();
  97
  98   // The client to notify when the stream is created. THIS MUST ONLY BE
  99   // ACCESSED ON THE MAIN THREAD.
 100   PepperAudioInputHost* client_;
 101
 102   // Used to send/receive IPC. THIS MUST ONLY BE ACCESSED ON THE
 103   // I/O THREAD.
 104   scoped_ptr<media::AudioInputIPC> ipc_;
 105
 106   scoped_refptr<base::MessageLoopProxy> main_message_loop_proxy_;
 107   scoped_refptr<base::MessageLoopProxy> io_message_loop_proxy_;
 108
 109   // The frame containing the Pepper widget.
 110   int render_frame_id_;
 111
 112   // The unique ID to identify the opened device. THIS MUST ONLY BE ACCESSED ON
 113   // THE MAIN THREAD.
 114   std::string label_;
 115
 116   // Initialized on the main thread and accessed on the I/O thread afterwards.
 117   media::AudioParameters params_;
 118
 119   // Whether we have tried to create an audio stream. THIS MUST ONLY BE ACCESSED
 120   // ON THE I/O THREAD.
 121   bool create_stream_sent_;
 122
 123   // Whether we have a pending request to open a device. We have to make sure
 124   // there isn't any pending request before this object goes away.
 125   // THIS MUST ONLY BE ACCESSED ON THE MAIN THREAD.
 126   bool pending_open_device_;
 127   // THIS MUST ONLY BE ACCESSED ON THE MAIN THREAD.
 128   int pending_open_device_id_;
 129
 130   DISALLOW_COPY_AND_ASSIGN(PepperPlatformAudioInput);
 131 };
 132
 133 }  // namespace content
 134
 135 #endif  // CONTENT_RENDERER_PEPPER_PEPPER_PLATFORM_AUDIO_INPUT_H_