A proposal for an initial postMessage interface. This will allow JavaScript ...

ppapi/cpp/instance.h

-// Copyright (c) 2010 The Chromium Authors. All rights reserved.
+// Copyright (c) 2011 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 PPAPI_CPP_INSTANCE_H_
 #define PPAPI_CPP_INSTANCE_H_
 
 /**
  * @file
  * Defines the API ...
  *
@@ skipping 53 matching lines @@
 
   /** See PPP_Instance.HandleInputEvent. */
   virtual bool HandleInputEvent(const PP_InputEvent& event);
 
   /** See PPP_Instance.HandleDocumentLoad. */
   virtual bool HandleDocumentLoad(const URLLoader& url_loader);
 
   /** See PPP_Instance.GetInstanceObject. */
   virtual Var GetInstanceObject();
 
+  /** See PPP_Instance.HandleMessage. */
+  virtual void HandleMessage(const Var& message_data);

[polina, 2011/03/17 02:59:28]

This is called |message| in the C header. Would be nice to be consistent.

+
   /** See PPP_Instance.GetSelectedText. */
   virtual Var GetSelectedText(bool html);
   // @}
 
   // @{
   /** @name PPB_Instance methods for querying the browser: */
 
   /** See PPB_Instance.GetWindowObject. */
   Var GetWindowObject();
 
   /** See PPB_Instance.GetOwnerElementObject. */
   Var GetOwnerElementObject();
 
   /** See PPB_Instance.BindGraphics. */
   bool BindGraphics(const Graphics2D& graphics);
 
   /** See PPB_Instance.BindGraphics. */
   bool BindGraphics(const Surface3D_Dev& graphics);
 
   /** See PPB_Instance.IsFullFrame. */
   bool IsFullFrame();
 
   /** See PPB_Instance.ExecuteScript. */
   Var ExecuteScript(const Var& script, Var* exception = NULL);
+
+  /** See PPB_Instance.PostMessage. */
+  void PostMessage(const Var& message);
   // @}
 
   /**
    * Associates a plugin instance with an interface,
    * creating an object... {PENDING: clarify!}
    *
    * Many optional interfaces are associated with a plugin instance. For
    * example, the find in PPP_Find interface receives updates on a per-instance
    * basis. This "per-instance" tracking allows such objects to associate
    * themselves with an instance as "the" handler for that interface name.
@@ skipping 41 matching lines @@
   InterfaceNameToObjectMap interface_name_to_objects_;
 };
 
 }  // namespace pp
 
 /**
  * @}
  * End addtogroup CPP
  */
 #endif  // PPAPI_CPP_INSTANCE_H_