Implicit audio output device selection for getUserMedia.

content/public/common/media_stream_request.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_COMMON_MEDIA_STREAM_REQUEST_H_
 #define CONTENT_PUBLIC_COMMON_MEDIA_STREAM_REQUEST_H_
 
 #include <map>
 #include <string>
 #include <vector>
@@ skipping 53 matching lines @@
   MediaStreamDevice(
       MediaStreamType type,
       const std::string& id,
       const std::string& name);
 
   MediaStreamDevice(
       MediaStreamType type,
       const std::string& id,
       const std::string& name,
       int sample_rate,
-      int channel_layout);
+      int channel_layout,
+      int frames_per_buffer);
 
   ~MediaStreamDevice();
 
   // The device's type.
   MediaStreamType type;
 
   // The device's unique ID.
   std::string id;
 
+  // The device id of a matched output device if any (otherwise empty).
+  // Only applicable to audio devices.
+  std::string matched_output_device_id;
+
   // The device's "friendly" name. Not guaranteed to be unique.
   std::string name;
 
-  // Preferred sample rate in samples per second for the device.
-  // Only utilized for audio devices. Will be set to 0 if the constructor
-  // with three parameters (intended for video) is used.
-  int sample_rate;
+  // Contains properties that match directly with those with the same name
+  // in media::AudioParameters.
+  struct AudioDeviceParameters {
+    AudioDeviceParameters()
+        : sample_rate(), channel_layout(), frames_per_buffer() {
+    }
 
-  // Preferred channel configuration for the device.
-  // Only utilized for audio devices. Will be set to 0 if the constructor
-  // with three parameters (intended for video) is used.
-  // TODO(henrika): ideally, we would like to use media::ChannelLayout here
-  // but including media/base/channel_layout.h violates checkdeps rules.
-  int channel_layout;
+    AudioDeviceParameters(int sample_rate, int channel_layout,
+                          int frames_per_buffer)
+        : sample_rate(sample_rate),
+          channel_layout(channel_layout),
+          frames_per_buffer(frames_per_buffer) {
+    }
+
+    // Preferred sample rate in samples per second for the device.
+    int sample_rate;
+
+    // Preferred channel configuration for the device.
+    // TODO(henrika): ideally, we would like to use media::ChannelLayout here
+    // but including media/base/channel_layout.h violates checkdeps rules.
+    int channel_layout;
+
+    // Preferred number of frames per buffer for the device.  This is filled
+    // in on the browser side and can be used by the renderer to match the
+    // expected browser side settings and avoid unnecessary buffering.
+    // See media::AudioParameters for more.
+    int frames_per_buffer;
+  };
+
+  // These below two member variables are valid only when the type of device is
+  // audio (i.e. IsAudioMediaType returns true).
+
+  // Contains the device properties of the capture device.
+  AudioDeviceParameters input;
+
+  // If the capture device has an associated output device (e.g. headphones),
+  // this will contain the properties for the output device.  If no such device
+  // exists (e.g. webcam w/mic), then the value of this member will be all
+  // zeros.
+  AudioDeviceParameters matched_output;
 };
 
 typedef std::vector<MediaStreamDevice> MediaStreamDevices;
 
 typedef std::map<MediaStreamType, MediaStreamDevices> MediaStreamDeviceMap;
 
 // Represents a request for media streams (audio/video).
 // It looks like the last 4 parameters should use StreamOptions instead, but
 // StreamOption depends on media_stream_request.h because it needs
 // MediaStreamDevice.
@@ skipping 64 matching lines @@
 };
 
 // Callback used return results of media access requests.
 typedef base::Callback<void(
     const MediaStreamDevices& devices,
     scoped_ptr<MediaStreamUI> ui)> MediaResponseCallback;
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_COMMON_MEDIA_STREAM_REQUEST_H_