Tab Audio Capture: Browser-side connect/disconnect functionality.

content/browser/renderer_host/media/audio_renderer_host.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.
 //
 // AudioRendererHost serves audio related requests from AudioRenderer which
 // lives inside the render process and provide access to audio hardware.
 //
 // This class is owned by BrowserRenderProcessHost, and instantiated on UI
 // thread, but all other operations and method calls happen on IO thread, so we
 // need to be extra careful about the lifetime of this object. AudioManager is a
@@ skipping 43 matching lines @@
 
 namespace media {
 class AudioManager;
 class AudioParameters;
 }
 
 namespace content {
 
 class MediaObserver;
 class ResourceContext;
+class WebContentsAudioInputStream;
 
 class CONTENT_EXPORT AudioRendererHost
     : public BrowserMessageFilter,
       public media::AudioOutputController::EventHandler {
  public:
   // Called from UI thread from the owner of this object.
-  AudioRendererHost(media::AudioManager* audio_manager,
+  AudioRendererHost(int render_process_id,
+                    media::AudioManager* audio_manager,
                     MediaObserver* media_observer);
 
   // BrowserMessageFilter implementation.
   virtual void OnChannelClosing() OVERRIDE;
   virtual void OnDestruct() const OVERRIDE;
   virtual bool OnMessageReceived(const IPC::Message& message,
                                  bool* message_was_ok) OVERRIDE;
 
   // AudioOutputController::EventHandler implementations.
   virtual void OnCreated(media::AudioOutputController* controller) OVERRIDE;
   virtual void OnPlaying(media::AudioOutputController* controller) OVERRIDE;
   virtual void OnPaused(media::AudioOutputController* controller) OVERRIDE;
   virtual void OnError(media::AudioOutputController* controller,
                        int error_code) OVERRIDE;
 
+  // Start/stop mirroring all audio output streams associated with
+  // |render_view_id| to |destination|.
+  void StartMirroring(int render_view_id,
+                      WebContentsAudioInputStream* destination);
+  void StopMirroring(int render_view_id,

[Alpha Left Google, 2012/11/20 21:49:43]

Does a destination associate with multiple render view? If not can this just
take |destination|?

[miu, 2012/11/21 08:27:48]

I thought about this, and I don't think I needed the 2nd argument.

However, after resolving the WCAIS threading issue, I do need to pass
destination in a scoped_refptr to make sure a reference is held on |destination|
until the IO thread removes all the streams from it.  (This all might be easier
to discuss in-person tomorrow.)

+                     WebContentsAudioInputStream* destination);
+
+  // Return the AudioRendererHost instance for a render process.
+  static scoped_refptr<AudioRendererHost> FromRenderProcessID(
+      int render_process_id);
+
  private:
   friend class AudioRendererHostTest;
   friend class BrowserThread;
   friend class base::DeleteHelper<AudioRendererHost>;
   friend class MockAudioRendererHost;
   FRIEND_TEST_ALL_PREFIXES(AudioRendererHostTest, CreateMockStream);
   FRIEND_TEST_ALL_PREFIXES(AudioRendererHostTest, MockStreamDataConversation);
 
   struct AudioEntry;
   typedef std::map<int, AudioEntry*> AudioEntryMap;
 
+  typedef std::map<int, WebContentsAudioInputStream*> MirrorSessionMap;
+
   virtual ~AudioRendererHost();
 
   // Methods called on IO thread ----------------------------------------------
 
   // Audio related IPC message handlers.
   // Creates an audio output stream with the specified format. If this call is
   // successful this object would keep an internal entry of the stream for the
   // required properties.
   void OnCreateStream(int stream_id,
                       const media::AudioParameters& params,
                       int input_channels);
 
+  // Associate |render_view_id| as the producer of audio for the stream
+  // referenced by |stream_id|.
+  void OnAssociateStreamWithProducer(int stream_id, int render_view_id);
+
   // Play the audio stream referenced by |stream_id|.
   void OnPlayStream(int stream_id);
 
   // Pause the audio stream referenced by |stream_id|.
   void OnPauseStream(int stream_id);
 
   // Discard all audio data in stream referenced by |stream_id|.
   void OnFlushStream(int stream_id);
 
   // Close the audio stream referenced by |stream_id|.
@@ skipping 34 matching lines @@
   // Returns NULL if not found.
   AudioEntry* LookupById(int stream_id);
 
   // Search for a AudioEntry having the reference to |controller|.
   // This method is used to look up an AudioEntry after a controller
   // event is received.
   AudioEntry* LookupByController(media::AudioOutputController* controller);
 
   media::AudioOutputController* LookupControllerByIdForTesting(int stream_id);
 
+  // ID of the RenderProcessImpl that owns this instance.
+  const int render_process_id_;
+
   // A map of stream IDs to audio sources.
   AudioEntryMap audio_entries_;
 
+  // A map of render view IDs to the destination for active mirroring sessions.
+  MirrorSessionMap mirror_sessions_;
+
   media::AudioManager* audio_manager_;
   MediaObserver* media_observer_;
 
   DISALLOW_COPY_AND_ASSIGN(AudioRendererHost);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_RENDERER_HOST_MEDIA_AUDIO_RENDERER_HOST_H_