Implements ListenForSessionMessages in PresentationServiceImpl; uses Swap to avoid copying large da…

content/public/browser/presentation_service_delegate.h

 // Copyright 2015 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_PRESENTATION_SERVICE_DELEGATE_H_
 #define CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_
 
+#include <vector>
+
 #include "base/callback.h"
+#include "base/memory/scoped_ptr.h"
+#include "base/memory/scoped_vector.h"
 #include "content/common/content_export.h"
 #include "content/public/browser/presentation_session.h"
+#include "content/public/browser/presentation_session_message.h"
 
 namespace content {
 
 class PresentationScreenAvailabilityListener;
 
 // An interface implemented by embedders to handle presentation API calls
 // forwarded from PresentationServiceImpl.
 class CONTENT_EXPORT PresentationServiceDelegate {
  public:
   // Observer interface to listen for changes to PresentationServiceDelegate.
@@ skipping 10 matching lines @@
         const PresentationSessionInfo& session) = 0;
 
    protected:
     virtual ~Observer() {}
   };
 
   using PresentationSessionSuccessCallback =
       base::Callback<void(const PresentationSessionInfo&)>;
   using PresentationSessionErrorCallback =
       base::Callback<void(const PresentationError&)>;
+  using PresentationSessionMessageCallback = base::Callback<void(
+      scoped_ptr<ScopedVector<PresentationSessionMessage>>)>;
 
   virtual ~PresentationServiceDelegate() {}
 
   // Registers an observer associated with frame with |render_process_id|
   // and |render_frame_id| with this class to listen for updates.
   // This class does not own the observer.
   // It is an error to add an observer if there is already an observer for that
   // frame.
   virtual void AddObserver(int render_process_id,
                            int render_frame_id,
@@ skipping 71 matching lines @@
   // |success_cb|: Invoked with session info, if presentation session joined
   // successfully.
   // |error_cb|: Invoked with error reason, if joining failed.
   virtual void JoinSession(
       int render_process_id,
       int render_frame_id,
       const std::string& presentation_url,
       const std::string& presentation_id,
       const PresentationSessionSuccessCallback& success_cb,
       const PresentationSessionErrorCallback& error_cb) = 0;
+
+  // Gtts the next batch of messages of all presentation session in the frame.

[mark a. foltz, 2015/05/01 19:42:07]

Typo in Gtts

[mark a. foltz, 2015/05/01 19:42:07]

s/of/from/
s/session/sessions/

[haibinlu, 2015/05/02 00:32:55]

Done.

+  // |render_process_id|, |render_frame_id|: ID for originating frame.
+  // |message_cb|: Invoked with a list of messages.

[mark a. foltz, 2015/05/01 19:42:07]

Can this list be empty?  Clarify.

[haibinlu, 2015/05/02 00:32:55]

Done.

+  virtual void ListenForSessionMessages(
+      int render_process_id,
+      int render_frame_id,
+      const PresentationSessionMessageCallback& message_cb) = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_PRESENTATION_SERVICE_DELEGATE_H_