Cast: Add JS API to get raw events logs from cast extension.

chrome/renderer/media/cast_session.h

 // Copyright 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 CHROME_RENDERER_MEDIA_CAST_SESSION_H_
 #define CHROME_RENDERER_MEDIA_CAST_SESSION_H_
 
 #include <vector>
 
 #include "base/basictypes.h"
@@ skipping 21 matching lines @@
 
 class CastSessionDelegate;
 
 // This class represents a Cast session and allows the session to be
 // configured on the main thread. Actual work is forwarded to
 // CastSessionDelegate on the IO thread.
 class CastSession : public base::RefCounted<CastSession> {
  public:
   typedef
   base::Callback<void(const scoped_refptr<media::cast::FrameInput>&)>
-  FrameInputAvailableCallback;
+      FrameInputAvailableCallback;
   typedef base::Callback<void(const std::vector<char>&)> SendPacketCallback;
   typedef base::Callback<void(scoped_ptr<std::string>)> EventLogsCallback;
 
   CastSession();
 
   // Start encoding of audio and video using the provided configuration.
   //
   // When Cast sender is started and ready to be used
   // media::cast::FrameInput will be given through the callback. The
   // callback will be made on the main thread.
   void StartAudio(const media::cast::AudioSenderConfig& config,
                   const FrameInputAvailableCallback& callback);
   void StartVideo(const media::cast::VideoSenderConfig& config,
                   const FrameInputAvailableCallback& callback);
   void StartUDP(const net::IPEndPoint& local_endpoint,
                 const net::IPEndPoint& remote_endpoint);
 
-  // Get raw event logs and provide the results in |callback| on main thread.
-  void GetEventLogsAndReset(const EventLogsCallback& callback);
+  // Creates or destroys event subscriber for the audio or video stream.
+  // |enable|: If true, creates an event subscriber. Otherwise destroys
+  // existing subscriber and discards logs.
+  // |is_audio|: true if the event subscriber is for audio. Video otherwise.
+  void ToggleLogging(bool enable, bool is_audio);

[Alpha Left Google, 2014/02/26 00:53:52]

nit: The order of arguments should match GetEventLogsAndReset() to be
consistent. That means |is_audio| first and then |enable|.

[imcheng, 2014/02/26 01:21:07]

Done.

+
+  // Returns raw event logs in serialized format for either the audio or video
+  // stream since last call and returns result in |callback|.
+  void GetEventLogsAndReset(bool is_audio, const EventLogsCallback& callback);
 
  private:
   friend class base::RefCounted<CastSession>;
   virtual ~CastSession();
 
   // This member should never be dereferenced on the main thread.
   // CastSessionDelegate lives only on the IO thread. It is always
   // safe to post task on the IO thread to access CastSessionDelegate
   // because it is owned by this object.
   scoped_ptr<CastSessionDelegate> delegate_;
 
   // Proxy to the IO message loop.
   const scoped_refptr<base::MessageLoopProxy> io_message_loop_proxy_;
 
   DISALLOW_COPY_AND_ASSIGN(CastSession);
 };
 
 #endif  // CHROME_RENDERER_MEDIA_CAST_SESSION_H_