Implements RTP header dumping.

content/public/browser/render_process_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.
 
 #ifndef CONTENT_PUBLIC_BROWSER_RENDER_PROCESS_HOST_H_
 #define CONTENT_PUBLIC_BROWSER_RENDER_PROCESS_HOST_H_
 
 #include "base/basictypes.h"
 #include "base/id_map.h"
 #include "base/process/kill.h"
@@ skipping 12 matching lines @@
 }
 
 namespace content {
 class BrowserContext;
 class BrowserMessageFilter;
 class RenderProcessHostObserver;
 class RenderWidgetHost;
 class StoragePartition;
 struct GlobalRequestID;
 
+#if defined(ENABLE_WEBRTC)
+enum RtpDumpType {
+  RTP_DUMP_INCOMING,
+  RTP_DUMP_OUTGOING,
+  RTP_DUMP_BOTH,
+};
+#endif
+
 // Interface that represents the browser side of the browser <-> renderer
 // communication channel. There will generally be one RenderProcessHost per
 // renderer process.
 class CONTENT_EXPORT RenderProcessHost : public IPC::Sender,
                                          public IPC::Listener,
                                          public base::SupportsUserData {
  public:
   typedef IDMap<RenderProcessHost>::iterator iterator;
 
   // Details for RENDERER_PROCESS_CLOSED notifications.
@@ skipping 155 matching lines @@
 
 #if defined(ENABLE_WEBRTC)
   virtual void EnableAecDump(const base::FilePath& file) = 0;
   virtual void DisableAecDump() = 0;
 
   // When set, |callback| receives log messages regarding, for example, media
   // devices (webcams, mics, etc) that were initially requested in the render
   // process associated with this RenderProcessHost.
   virtual void SetWebRtcLogMessageCallback(
       base::Callback<void(const std::string&)> callback) = 0;
+
+  typedef base::Callback<void(const uint8* packet_header,
+                              size_t header_length,
+                              size_t packet_length,
+                              bool incoming)> WebRtcRtpPacketCallback;
+
+  typedef base::Callback<void(RtpDumpType)> WebRtcStopRtpDumpCallback;
+
+  // Starts passing RTP packets to |packet_callback| and returns the callback
+  // used to stop dumping. This method can be called on any thread. The returned

[jam, 2014/05/16 22:03:22]

can you clarify what you mean by "called on any thread"? you mean the callback,
not StartRtpDump right?

[jiayl, 2014/05/16 22:52:43]

Improved the comment.

+  // WebRtcStopRtpDumpCallback must be called on the IO thread.
+  virtual WebRtcStopRtpDumpCallback StartRtpDump(
+      RtpDumpType,

[jam, 2014/05/16 22:03:22]

can you keep it as with booleans as before for incoming & outgoing? in the
content api we put each enum in a separate file, so making it here for these two
would bloat content/public/browser even more

[jiayl, 2014/05/16 22:52:43]

Done.

+      const WebRtcRtpPacketCallback& packet_callback) = 0;
 #endif
 
   // Tells the ResourceDispatcherHost to resume a deferred navigation without
   // transferring it to a new renderer process.
   virtual void ResumeDeferredNavigation(const GlobalRequestID& request_id) = 0;
 
   // Notifies the renderer that the timezone configuration of the system might
   // have changed.
   virtual void NotifyTimezoneChange() = 0;
 
@@ skipping 48 matching lines @@
   static void SetMaxRendererProcessCount(size_t count);
 
   // Returns the current max number of renderer processes used by the content
   // module.
   static size_t GetMaxRendererProcessCount();
 };
 
 }  // namespace content.
 
 #endif  // CONTENT_PUBLIC_BROWSER_RENDER_PROCESS_HOST_H_