Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(23)

Unified Diff: ppapi/c/ppp_instance.h

Issue 6538028: A proposal for an initial postMessage interface. This will allow JavaScript ... (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src/
Patch Set: '' Created 9 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« ppapi/c/ppb_instance.h ('K') | « ppapi/c/ppb_instance.h ('k') | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: ppapi/c/ppp_instance.h
===================================================================
--- ppapi/c/ppp_instance.h (revision 75765)
+++ ppapi/c/ppp_instance.h (working copy)
@@ -13,12 +13,12 @@
struct PP_InputEvent;
struct PP_Var;
-#define PPP_INSTANCE_INTERFACE "PPP_Instance;0.4"
+#define PPP_INSTANCE_INTERFACE "PPP_Instance;0.5"
/**
* @file
- * This file defines the PPP_Instance structure - a series of points to methods
- * that you must implement in your model.
+ * This file defines the PPP_Instance structure - a series of pointers to
+ * methods that you must implement in your module instance.
*
*/
@@ -172,6 +172,27 @@
* @return A PP_Var containing scriptable object.
*/
struct PP_Var (*GetInstanceObject)(PP_Instance instance);
+
+ /**
+ * This method gets called when @a postMessage() is invoked on the DOM object
+ * for this module instance in JavaScript. Note that @a postMessage() in the
+ * JavaScript interface is asynchronous, meaning JavaScript execution will not
+ * be blocked while @a HandleMessage() is processing the given @a message.
+ *
+ * For example:
+ *
+ * <body>
+ * <object id="plugin"
+ * type="application/x-ppapi-postMessage-example"/>
+ * <script type="text/javascript">
+ * document.getElementById('plugin').postMessage("Hello world!");
+ * </script>
+ * </body>
+ *
+ * This will result in HandleMessage being invoked on the instance, with
+ * message being a string PP_Var containing "Hello world!".
+ */
+ void (*HandleMessage)(PP_Instance instance, struct PP_Var message);
};
/**
* @}
« ppapi/c/ppb_instance.h ('K') | « ppapi/c/ppb_instance.h ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698