Allow audio debug recordings through a private API extension.

chrome/common/extensions/api/webrtc_logging_private.idl

Index: chrome/common/extensions/api/webrtc_logging_private.idl
diff --git a/chrome/common/extensions/api/webrtc_logging_private.idl b/chrome/common/extensions/api/webrtc_logging_private.idl
index 5c72c9597ba15e33f52a02f2644256eb8bcc9772..004badf174c50257c32bf45766ffccc7e19afadb 100644
--- a/chrome/common/extensions/api/webrtc_logging_private.idl
+++ b/chrome/common/extensions/api/webrtc_logging_private.idl
@@ -27,8 +27,24 @@ namespace webrtcLoggingPrivate {
     // webview.
     long? guestProcessId;
   };
+  
+  // This contains information about the result of an audio debug recordings.
+  dictionary AudioDebugRecordingsInfo {
+    // Absolute path prefix for the files with the audio debug recordings.
+    DOMString prefixPath;
+    
+    // Indicates if recording was stopped. 
+    boolean didStop;
+    
+    // Indicates if recording was stopped manually through a 
+    // stopAudioDebugRecordings() call.
+    boolean didManualStop;
+  };
+
 
   callback GenericDoneCallback = void ();
+  callback AudioDebugRecordingsCallback = 
+      void (AudioDebugRecordingsInfo info);
   callback UploadDoneCallback = void (UploadResult result);
 
   interface Functions {
@@ -111,5 +127,24 @@ namespace webrtcLoggingPrivate {
                             boolean incoming,
                             boolean outgoing,
                             GenericDoneCallback callback);
+
+    // Starts audio debug recordings. 
+    // |seconds| indicates how many seconds of audio to record. |callback| 
+    // is invoked once recording stops.
+    // If |seconds| is zero, recording will continue until 
+    // stopAudioDebugRecordings() is explicitly called. In this case, 
+    // |callback| is not invoked.
+    // If |seconds| is negative, startAudioDebugRecordings() fails.
+    static void startAudioDebugRecordings(RequestInfo request,
+                             DOMString securityOrigin,
+                             long seconds, 
+                             AudioDebugRecordingsCallback callback);
+
+    // Stops audio debug recordings.  |callback| is invoked once recording 
+    // stops. If there is no recordig in progress, stopAudioDebugRecordings()
+    // fails.  
+    static void stopAudioDebugRecordings(RequestInfo request,
+                            DOMString securityOrigin,
+                            AudioDebugRecordingsCallback callback);
   };
 };