Deliver webrtc-internals updates in bulk, every 500ms at most.

content/renderer/media/peer_connection_tracker.h

 // Copyright (c) 2013 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_RENDERER_MEDIA_PEER_CONNECTION_TRACKER_H_
 #define CONTENT_RENDERER_MEDIA_PEER_CONNECTION_TRACKER_H_
 
 #include <map>
 
 #include "base/compiler_specific.h"
@@ skipping 145 matching lines @@
       RTCPeerConnectionHandler* pc_handler,
       const blink::WebMediaStreamTrack& track);
 
   // Sends an update when getUserMedia is called.
   virtual void TrackGetUserMedia(
       const blink::WebUserMediaRequest& user_media_request);
 
  private:
   // Assign a local ID to a peer connection so that the browser process can
   // uniquely identify a peer connection in the renderer process.
+  // The return value will always be positive.
   int GetNextLocalID();
 
+  // Looks up a handler in our map and if found, returns its ID.  If the handler
+  // is not registered, the return value will be -1.
+  int GetLocalIDForHandler(RTCPeerConnectionHandler* handler) const;
+
   // IPC Message handler for getting all stats.
   void OnGetAllStats();
 
   // Called when the browser process reports a suspend event from the OS.
   void OnSuspend();
 
-  void SendPeerConnectionUpdate(RTCPeerConnectionHandler* pc_handler,
-                                const std::string& callback_type,
+  // Called to deliver an update to the host (PeerConnectionTrackerHost).
+  // |local_id| - The id of the registered RTCPeerConnectionHandler.
+  //              Using an id instead of the hander pointer is done on purpose
+  //              to force doing the lookup before building the callback data
+  //              in case the handler isn't registered.
+  // |callback_type| - A string, most often static, that represents the type
+  //                   of operation that the data stored in |value| comes from.
+  //                   E.g. "createOffer", "createAnswer",
+  //                   "setRemoteDescription" etc.
+  // |value| - A json serialized string containing all the information for the
+  //           update event.
+  void SendPeerConnectionUpdate(int local_id,
+                                const char* callback_type,
                                 const std::string& value);
 
   // This map stores the local ID assigned to each RTCPeerConnectionHandler.
   typedef std::map<RTCPeerConnectionHandler*, int> PeerConnectionIdMap;
   PeerConnectionIdMap peer_connection_id_map_;
 
   // This keeps track of the next available local ID.
-  int next_lid_;
+  int next_local_id_;
   base::ThreadChecker main_thread_;
 
   DISALLOW_COPY_AND_ASSIGN(PeerConnectionTracker);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_RENDERER_MEDIA_PEER_CONNECTION_TRACKER_H_