Allow AudioOutputDevice objects to be initialized with a specific hardware output device and store …

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
 // singleton and created in IO thread, audio output streams are also created in
 // the IO thread, so we need to destroy them also in IO thread. After this class
 // is created, a task of OnInitialized() is posted on IO thread in which
 // singleton of AudioManager is created.
 //
 // Here's an example of a typical IPC dialog for audio:
 //
 //   Renderer                     AudioRendererHost
 //      |                               |
+//      |  RequestDeviceAuthorization > |
+//      |    < NotifyDeviceAuthorized   |
+//      |                               |
 //      |         CreateStream >        |
 //      |     < NotifyStreamCreated     |
 //      |                               |
 //      |          PlayStream >         |
 //      |  < NotifyStreamStateChanged   | kAudioStreamPlaying
 //      |                               |
 //      |         PauseStream >         |
 //      |  < NotifyStreamStateChanged   | kAudioStreamPaused
 //      |                               |
 //      |          PlayStream >         |
 //      |  < NotifyStreamStateChanged   | kAudioStreamPlaying
 //      |             ...               |
 //      |         CloseStream >         |
 //      v                               v
 
 // A SyncSocket pair is used to signal buffer readiness between processes.
 
 #ifndef CONTENT_BROWSER_RENDERER_HOST_MEDIA_AUDIO_RENDERER_HOST_H_
 #define CONTENT_BROWSER_RENDERER_HOST_MEDIA_AUDIO_RENDERER_HOST_H_
 
 #include <map>
 #include <string>
 
 #include "base/atomic_ref_count.h"
 #include "base/gtest_prod_util.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/process/process.h"
 #include "base/sequenced_task_runner_helpers.h"
+#include "content/browser/renderer_host/media/audio_output_device_enumerator.h"
 #include "content/common/content_export.h"
 #include "content/public/browser/browser_message_filter.h"
 #include "content/public/browser/browser_thread.h"
 #include "content/public/browser/render_process_host.h"
 #include "content/public/browser/resource_context.h"
 #include "media/audio/audio_io.h"
 #include "media/audio/audio_logging.h"
 #include "media/audio/audio_output_controller.h"
 #include "media/audio/simple_sources.h"
 #include "url/gurl.h"
@@ skipping 44 matching lines @@
   friend class BrowserThread;
   friend class base::DeleteHelper<AudioRendererHost>;
   friend class MockAudioRendererHost;
   friend class TestAudioRendererHost;
   FRIEND_TEST_ALL_PREFIXES(AudioRendererHostTest, CreateMockStream);
   FRIEND_TEST_ALL_PREFIXES(AudioRendererHostTest, MockStreamDataConversation);
 
   class AudioEntry;
   typedef std::map<int, AudioEntry*> AudioEntryMap;
 
+  // Internal callback type for access requests to output devices.
+  // |have_access| indicates if there is permission to access the device.
+  typedef base::Callback<void(bool have_access)> OutputDeviceAccessCB;
+
+  // Internal callback type for information requests about an output device.
+  // |success| indicates the operation was successful. If true, |device_info|
+  // contains data about the device.
+  typedef base::Callback<void(bool success,
+                              const AudioOutputDeviceInfo& device_info)>
+      OutputDeviceInfoCB;
+
   ~AudioRendererHost() override;
 
   // Methods called on IO thread ----------------------------------------------
 
   // Audio related IPC message handlers.
 
-  // Creates an audio output stream with the specified format whose data is
-  // produced by an entity in the RenderFrame referenced by |render_frame_id|.
+  // Request permission to use an output device for use by a stream produced
+  // in the RenderFrame referenced by |render_frame_id|.
   // |session_id| is used for unified IO to find out which input device to be
   // opened for the stream. For clients that do not use unified IO,
-  // |session_id| will be ignored.
+  // |session_id| will be ignored and the given |device_id| and
+  // |security_origin| will be used to select the output device.
+  // Upon completion of the process, the peer is notified with the device output
+  // parameters via the NotifyDeviceAuthorized message.
+  void OnRequestDeviceAuthorization(int stream_id,
+                                    int render_frame_id,
+                                    int session_id,
+                                    const std::string& device_id,
+                                    const GURL& security_origin);
+
+  // Creates an audio output stream with the specified format.
   // Upon success/failure, the peer is notified via the NotifyStreamCreated
   // message.
   void OnCreateStream(int stream_id,
                       int render_frame_id,
-                      int session_id,
                       const media::AudioParameters& params);
 
   // 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);
 
   // Close the audio stream referenced by |stream_id|.
   void OnCloseStream(int stream_id);
 
   // Set the volume of the audio stream referenced by |stream_id|.
   void OnSetVolume(int stream_id, double volume);
 
   // Set the output device of the audio stream referenced by |stream_id|.
   void OnSwitchOutputDevice(int stream_id,
                             int render_frame_id,
                             const std::string& device_id,
-                            const GURL& security_origin,
-                            int request_id);
+                            const GURL& security_origin);
 
-  void OutputDeviceAccessChecked(scoped_ptr<MediaStreamUIProxy> ui_proxy,
-                                 int stream_id,
-                                 const std::string& device_id,
-                                 const GURL& security_origin,
-                                 int render_frame_id,
-                                 int request_id,
-                                 bool have_access);
+  // Helper methods.
 
-  void StartTranslateOutputDeviceName(int stream_id,
-                                      const std::string& device_id,
-                                      const GURL& security_origin,
-                                      int request_id);
+  // Proceed with device authorization after checking permissions.
+  void RequestDeviceAuthorizationAccessChecked(int stream_id,
+                                               const std::string& device_id,
+                                               const GURL& security_origin,
+                                               bool have_access);
 
-  void FinishTranslateOutputDeviceName(int stream_id,
-                                       const std::string& device_id,
-                                       const GURL& security_origin,
-                                       int request_id,
-                                       media::AudioDeviceNames*);
+  // Proceed with device authorization after translating device ID.
+  void RequestDeviceAuthorizationTranslated(
+      int stream_id,
+      bool device_found,
+      const AudioOutputDeviceInfo& device_info);
 
-  void DoSwitchOutputDevice(int stream_id,
-                            const std::string& raw_device_id,
-                            int request_id);
-
-  void DoOutputDeviceSwitched(int stream_id, int request_id);
+  // Start the actual creation of an audio stream, after the device
+  // authorization process is complete.
+  void DoCreateStream(int stream_id,
+                      int render_frame_id,
+                      const media::AudioParameters& params,
+                      const std::string& device_unique_id);
 
   // Complete the process of creating an audio stream. This will set up the
   // shared memory or shared socket in low latency mode and send the
   // NotifyStreamCreated message to the peer.
   void DoCompleteCreation(int stream_id);
 
   // Send playing/paused status to the renderer.
   void DoNotifyStreamStateChanged(int stream_id, bool is_playing);
 
+  // Proceed with output device switching after checking permissions.
+  void SwitchOutputDeviceAccessChecked(int stream_id,
+                                       const std::string& device_id,
+                                       const GURL& security_origin,
+                                       bool have_access);
+
+  // Proceed with output device switching after translating device ID.
+  void SwitchOutputDeviceTranslated(int stream_id,
+                                    bool device_found,
+                                    const AudioOutputDeviceInfo& device_info);
+
+  // Finish handling the output device switch request, after the device has
+  // been switched.
+  void OutputDeviceSwitched(int stream_id,
+                            const media::AudioParameters& output_params);
+
   RenderProcessHost::AudioOutputControllerList DoGetOutputControllers() const;
 
   // Send an error message to the renderer.
   void SendErrorMessage(int stream_id);
 
   // Delete an audio entry, notifying observers first.  This is called by
   // AudioOutputController after it has closed.
   void DeleteEntry(scoped_ptr<AudioEntry> entry);
 
   // Send an error message to the renderer, then close the stream.
   void ReportErrorAndClose(int stream_id);
 
   // A helper method to look up a AudioEntry identified by |stream_id|.
   // Returns NULL if not found.
   AudioEntry* LookupById(int stream_id);
 
   // A helper method to update the number of playing streams and alert the
   // ResourceScheduler when the renderer starts or stops playing an audiostream.
   void UpdateNumPlayingStreams(AudioEntry* entry, bool is_playing);
 
   // Checks that the renderer process supplies a URL it is allowed to use
   bool IsURLAllowed(const GURL& url);
 
+  // Check if the renderer process has access to the requested output device.
+  void CheckOutputDeviceAccess(int render_frame_id,
+                               const std::string& device_id,
+                               const GURL& security_origin,
+                               const OutputDeviceAccessCB& callback);
+
+  // Invoke |callback| after permission to use a device has been checked.
+  void AccessChecked(scoped_ptr<MediaStreamUIProxy> ui_proxy,
+                     const OutputDeviceAccessCB& callback,
+                     bool have_access);
+
+  // Check if the renderer process has access to the requested output device.
+  void TranslateDeviceID(const std::string& device_id,
+                         const GURL& security_origin,
+                         const OutputDeviceInfoCB& callback);
+
+  void FinishTranslateDeviceID(
+      const std::string& device_id,
+      const GURL& security_origin,
+      const OutputDeviceInfoCB& callback,
+      const AudioOutputDeviceEnumeration& device_infos);
+
+  // Helper method to check if the authorization procedure for stream
+  // |stream_id| has started.
+  bool IsAuthorizationStarted(int stream_id);
+
   // ID of the RenderProcessHost that owns this instance.
   const int render_process_id_;
 
   media::AudioManager* const audio_manager_;
   AudioMirroringManager* const mirroring_manager_;
   scoped_ptr<media::AudioLog> audio_log_;
 
   // Used to access to AudioInputDeviceManager.
   MediaStreamManager* media_stream_manager_;
 
   // A map of stream IDs to audio sources.
   AudioEntryMap audio_entries_;
 
   // The number of streams in the playing state.
   base::AtomicRefCount num_playing_streams_;
 
-  // Salt required to translate renderer device IDs to raw device IDs
+  // Salt required to translate renderer device IDs to raw device unique IDs
   ResourceContext::SaltCallback salt_callback_;
 
+  // Map of device authorizations for streams that are not yet created
+  class AuthorizationData;
+  std::map<int, AuthorizationData> authorizations_;
+
   DISALLOW_COPY_AND_ASSIGN(AudioRendererHost);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_RENDERER_HOST_MEDIA_AUDIO_RENDERER_HOST_H_