Cast: Add GetStats() extensions API.

chrome/common/extensions/api/cast_streaming_rtp_stream.idl

 // 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.
 
 // The <code>chrome.cast.streaming.rtpStream</code> API allows configuration
 // of encoding parameters and RTP parameters used in a Cast streaming
 // session.
 namespace cast.streaming.rtpStream {
   // Params for audio and video codec.
   dictionary CodecSpecificParams {
@@ skipping 44 matching lines @@
 
     DOMString[] rtcpFeatures;
   };
 
   // Callback from the <code>create</code> method.
   // |id| : The ID for the RTP stream.
   callback CreateCallback = void (long streamId);
 
   // Callback from the <code>getRawEvents</code> method.
   // |rawEvents|: serialized raw bytes containing raw events recorded for
   //              a stream.

[not at google - send to devlin, 2014/03/05 20:27:10]

this comment needs updating

[imcheng, 2014/03/05 20:36:00]

I changed the return type back to DOMString. But I also updated comment to say
the returned data is in compressed format.

   // The serialization format can be found at 
   // media/cast/logging/log_serializer.cc.
-  callback GetRawEventsCallback = void (DOMString rawEvents);
+  callback GetRawEventsCallback = void (object rawEvents);
   
   // Callback from the <code>getStats</code> method.
-  // |rawEvents|: serialized raw bytes containing stats recorded for a stream.
-  // The serialization format can be found at 
-  // media/cast/logging/log_serializer.cc.
-  callback GetStatsCallback = void (DOMString stats);
+  // |rawEvents|: dictionary object containing stats recorded for a stream.
+  // The format can be found at 
+  // media/cast/logging/stats_converter.cc.
+  callback GetStatsCallback = void (object stats);
 
   interface Functions {
     // Destroys a Cast RTP stream.
     // |streamId| : The RTP stream ID.
     [nocompile] static void destroy(long streamId);
 
     // Returns an array of supported parameters with default values.
     // This includes a list of supported codecs on this platform and
     // corresponding encoding and RTP parameters.
     // |streamId| : The RTP stream ID.
     [nocompile] static RtpParams[] getSupportedParams(long streamId);
 
     // Activates the RTP stream by providing the parameters.
     // |streamId| : The RTP stream ID.
     // |params| : Parameters set for this stream.
     [nocompile] static void start(long streamId, RtpParams params);
 
     // Stops activity on the specified stream.
     // |streamId| : The RTP stream ID.
     [nocompile] static void stop(long streamId);
 
     // Enables / disables logging for a stream.
     // |enable|: If true, enables logging. Otherwise disables logging.
     [nocompile] static void toggleLogging(long streamId, boolean enable);
     
     // Get raw events for a stream in the current session.
     // |streamId|: Stream to get events for.
-    // |callback|: Called with the raw events Blob.
+    // |callback|: Called with the raw events.
     [nocompile] static void getRawEvents(
         long streamId, GetRawEventsCallback callback);
     
     // Get stats for a stream in the current session.
     // |streamId|: Stream to get stats for.
-    // |callback|: Called with the stats Blob.
+    // |callback|: Called with the stats.
     [nocompile] static void getStats(
         long streamId, GetStatsCallback callback);
   };
 
   interface Events {
     // Event fired when a Cast RTP stream has started.
     // |streamId| : The ID of the RTP stream.
     static void onStarted(long streamId);
 
     // Event fired when a Cast RTP stream has stopped.
     // |streamId| : The ID of the RTP stream.
     static void onStopped(long streamId);
 
     // Event fired when a Cast RTP stream has error.
     // |streamId| : The ID of the RTP stream.
     // |errorString| : The error info.
     static void onError(long streamId, DOMString errorString);
   };
 };