PepperPlatformAudioInputImpl: support audio input device selection.

webkit/plugins/ppapi/plugin_delegate.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 WEBKIT_PLUGINS_PPAPI_PLUGIN_DELEGATE_H_
 #define WEBKIT_PLUGINS_PPAPI_PLUGIN_DELEGATE_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 178 matching lines @@
 
     // Set an optional callback that will be invoked when the context is lost
     // (e.g. gpu process crash). Takes ownership of the callback.
     virtual void SetContextLostCallback(
         const base::Callback<void()>& callback) = 0;
 
     // Run the callback once the channel has been flushed.
     virtual bool Echo(const base::Callback<void()>& callback) = 0;
   };
 
-  // The (interface for the) client used by |PlatformAudio| and
+  // The base class of clients used by |PlatformAudioOutput| and
   // |PlatformAudioInput|.
-  class PlatformAudioCommonClient {
+  class PlatformAudioClientBase {
    protected:
-    virtual ~PlatformAudioCommonClient() {}
+    virtual ~PlatformAudioClientBase() {}
 
    public:
     // Called when the stream is created.
     virtual void StreamCreated(base::SharedMemoryHandle shared_memory_handle,
                                size_t shared_memory_size,
                                base::SyncSocket::Handle socket) = 0;
   };
 
+  class PlatformAudioOutputClient : public PlatformAudioClientBase {
+   protected:
+    virtual ~PlatformAudioOutputClient() {}
+  };
+
   class PlatformAudioOutput {
    public:
     // Starts the playback. Returns false on error or if called before the
     // stream is created or after the stream is closed.
     virtual bool StartPlayback() = 0;
 
     // Stops the playback. Returns false on error or if called before the stream
     // is created or after the stream is closed.
     virtual bool StopPlayback() = 0;
 
     // Closes the stream. Make sure to call this before the object is
     // destructed.
     virtual void ShutDown() = 0;
 
    protected:
     virtual ~PlatformAudioOutput() {}
   };
 
+  class PlatformAudioInputClient : public PlatformAudioClientBase {
+   public:
+    virtual void StreamCreationFailed() = 0;
+
+   protected:
+    virtual ~PlatformAudioInputClient() {}
+  };
+
   class PlatformAudioInput {
    public:
-    // Starts the capture. Returns false on error or if called before the
-    // stream is created or after the stream is closed.
-    virtual bool StartCapture() = 0;
+    // Starts the capture.

[viettrungluu, 2012/03/20 18:20:02]

Nit: I think this comment is now officially useless, and should be removed.

[yzshen1, 2012/03/21 17:55:46]

Done.

+    virtual void StartCapture() = 0;
 
-    // Stops the capture. Returns false on error or if called before the stream
-    // is created or after the stream is closed.
-    virtual bool StopCapture() = 0;
+    // Stops the capture.

[viettrungluu, 2012/03/20 18:20:02]

"

[yzshen1, 2012/03/21 17:55:46]

Done.

+    virtual void StopCapture() = 0;
 
     // Closes the stream. Make sure to call this before the object is
     // destructed.
     virtual void ShutDown() = 0;
 
    protected:
     virtual ~PlatformAudioInput() {}
   };
 
   // Interface for PlatformVideoDecoder is directly inherited from general media
@@ skipping 90 matching lines @@
   virtual uint32_t GetAudioHardwareOutputSampleRate() = 0;
 
   // Get audio hardware output buffer size.
   virtual uint32_t GetAudioHardwareOutputBufferSize() = 0;
 
   // The caller is responsible for calling Shutdown() on the returned pointer
   // to clean up the corresponding resources allocated during this call.
   virtual PlatformAudioOutput* CreateAudioOutput(
       uint32_t sample_rate,
       uint32_t sample_count,
-      PlatformAudioCommonClient* client) = 0;
+      PlatformAudioOutputClient* client) = 0;
 
+  // If |device_id| is empty, the default audio input device will be used.
   // The caller is responsible for calling Shutdown() on the returned pointer
   // to clean up the corresponding resources allocated during this call.
   virtual PlatformAudioInput* CreateAudioInput(
+      const std::string& device_id,
       uint32_t sample_rate,
       uint32_t sample_count,
-      PlatformAudioCommonClient* client) = 0;
+      PlatformAudioInputClient* client) = 0;
 
   // A pointer is returned immediately, but it is not ready to be used until
   // BrokerConnected has been called.
   // The caller is responsible for calling Release() on the returned pointer
   // to clean up the corresponding resources allocated during this call.
   virtual Broker* ConnectToBroker(webkit::ppapi::PPB_Broker_Impl* client) = 0;
 
   // Notifies that the number of find results has changed.
   virtual void NumberOfFindResultsChanged(int identifier,
                                           int total,
@@ skipping 235 matching lines @@
                                const EnumerateDevicesCallback& callback) = 0;
   // Create a ClipboardClient for writing to the clipboard. The caller will own
   // the pointer to this.
   virtual webkit_glue::ClipboardClient* CreateClipboardClient() const = 0;
 };
 
 }  // namespace ppapi
 }  // namespace webkit
 
 #endif  // WEBKIT_PLUGINS_PPAPI_PLUGIN_DELEGATE_H_