unreal-toolkit-next 0.1.12 → 0.1.14

package/README.md

@@ -1,10 +1,10 @@
 # Unreal Toolkit - Next Edition
-A universal runtime library for advanced Unreal Engine web game development. The **Unreal Toolkit** enables interoperability
+A runtime library for advanced Unreal Engine web game development. The **Unreal Toolkit** enables interoperability
 with your hosted Unreal Engine streaming web application.
 
 <a href="https://www.npmjs.com/package/unreal-toolkit">Classic Edition (UMD)</a>
 <br/>
-<a href="https://github.com/MackeyK24/UnrealToolkit/tree/master/Runtime">Browser Edition (CDN)</a>
+<a href="https://github.com/codewrxai/UnrealToolkit/cdn">Browser Edition (CDN)</a>
 
 
 ## Default Installation (ES6)
@@ -19,11 +19,34 @@ import UnrealToolkit from 'unreal-toolkit';
 
 * Unreal Toolkit Message Bus Usage
 ```typescript
-// Post window message
-UnrealToolkit.EventBus.PostWindowMessage("myevent", ["Hello World!"]);
+// Post WM_HELLO message to Unreal Engine
+UnrealToolkit.EventBus.PostWindowMessage("WM_HELLO", ["Hello World!"]);
 
-// Handle window message
-UnrealToolkit.EventBus.OnWindowMessage("myevent", (args:string[]) => {
+// Handle WM_MY_EVENT message from Unreal Engine
+UnrealToolkit.EventBus.OnWindowMessage("WM_MY_EVENT", (args:string[]) => {
    console.log("My Event Args: ", args);
 });
-```
+```
+
+* Unreal Toolkit Content Frame Style
+```css
+iframe {
+   position: absolute;
+   width: 100%;
+   height: 100%;
+   min-height: 100vh;
+   border: none;
+   outline: none;
+   z-index: 0;
+}
+```
+
+* Unreal Toolkit Content Frame Window
+```html
+<iframe
+  src="your.unrealtoolkitproject.com"
+  crossorigin="anonymous"
+  allow="cross-origin-isolated"
+  sandbox="allow-same-origin allow-scripts allow-popups allow-forms allow-pointer-lock">
+</iframe>
+```

package/dist/index.d.ts

@@ -8,11 +8,11 @@ export declare class UnrealToolkit {
     /** Unreal Toolkit event message bus
      * @example
      * ```typescript
-     * // Post myevent window message
-     * UnrealToolkit.EventBus.PostWindowMessage("myevent", ["Hello World!"]);
+     * // Post WM_HELLO message to Unreal Engine
+     * UnrealToolkit.EventBus.PostWindowMessage("WM_HELLO", ["Hello World!"]);
      *
-     * // Handle myevent window message
-     * UnrealToolkit.EventBus.OnWindowMessage("myevent", (args:string[]) => {
+     * // Handle WM_MY_EVENT message from Unreal Engine
+     * UnrealToolkit.EventBus.OnWindowMessage("WM_MY_EVENT", (args:string[]) => {
      *    console.log("My Event Args: ", args);
      * });
      * ```
@@ -26,6 +26,7 @@ export declare class UnrealToolkit {
 export declare class UnrealMessageBus {
     static AllowedOrigin: string;
     static TargetOrigin: string;
+    static ContentFrames: NodeListOf<HTMLIFrameElement>;
     constructor();
     /** Post event bus message
      * @param name The message to post
@@ -53,6 +54,10 @@ export declare class UnrealMessageBus {
      * @returns void
      */
     Dispose(): void;
+    /** Resets the content frame list
+     * @returns void
+     */
+    ResetContentFrames(): void;
     /** Handle window message event
      * @param event The message event to handle
      * @returns void

package/dist/index.js

@@ -7,11 +7,11 @@ export class UnrealToolkit {
     /** Unreal Toolkit event message bus
      * @example
      * ```typescript
-     * // Post myevent window message
-     * UnrealToolkit.EventBus.PostWindowMessage("myevent", ["Hello World!"]);
+     * // Post WM_HELLO message to Unreal Engine
+     * UnrealToolkit.EventBus.PostWindowMessage("WM_HELLO", ["Hello World!"]);
      *
-     * // Handle myevent window message
-     * UnrealToolkit.EventBus.OnWindowMessage("myevent", (args:string[]) => {
+     * // Handle WM_MY_EVENT message from Unreal Engine
+     * UnrealToolkit.EventBus.OnWindowMessage("WM_MY_EVENT", (args:string[]) => {
      *    console.log("My Event Args: ", args);
      * });
      * ```
@@ -31,7 +31,7 @@ export class UnrealMessageBus {
     constructor() {
         this.ListenerDictionary = {};
         this.HandleWindowMessage = this.HandleWindowMessage.bind(this);
-        window.top.addEventListener("message", this.HandleWindowMessage);
+        window.addEventListener("message", this.HandleWindowMessage);
     }
     /** Post event bus message
      * @param name The message to post
@@ -40,7 +40,23 @@ export class UnrealMessageBus {
      */
     PostWindowMessage(name, args) {
         try {
-            window.top.postMessage({ source: "unrealtoolkit", message: name, args: args }, UnrealMessageBus.TargetOrigin);
+            if (UnrealMessageBus.ContentFrames == null) {
+                UnrealMessageBus.ContentFrames = document.querySelectorAll("iframe");
+            }
+            if (UnrealMessageBus.ContentFrames != null) {
+                UnrealMessageBus.ContentFrames.forEach((frame) => {
+                    var _a;
+                    try {
+                        (_a = frame.contentWindow) === null || _a === void 0 ? void 0 : _a.postMessage({ source: "unrealtoolkit", message: name, args: args }, UnrealMessageBus.TargetOrigin);
+                    }
+                    catch (e) {
+                        console.warn(e);
+                    }
+                });
+            }
+            else {
+                console.warn("UnrealMessageBus: No Content Frames Found!");
+            }
         }
         catch (e) {
             console.warn(e);
@@ -88,21 +104,60 @@ export class UnrealMessageBus {
      */
     Dispose() {
         this.ResetHandlers();
-        window.top.removeEventListener("message", this.HandleWindowMessage);
+        window.removeEventListener("message", this.HandleWindowMessage);
+    }
+    /** Resets the content frame list
+     * @returns void
+     */
+    ResetContentFrames() {
+        UnrealMessageBus.ContentFrames = null;
     }
     /** Handle window message event
      * @param event The message event to handle
      * @returns void
      */
     HandleWindowMessage(event) {
-        if (event == null || event.origin == null || event.data == null || event.data.source == null || event.data.message == null)
+        if (event == null || event.origin == null || event.data == null)
             return;
-        try {
-            if (UnrealMessageBus.AllowedOrigin != null && UnrealMessageBus.AllowedOrigin !== "" && UnrealMessageBus.AllowedOrigin !== "*" && event.origin !== UnrealMessageBus.AllowedOrigin) {
-                console.warn("UnrealMessageBus: Invalid Origin: " + event.origin);
-                return;
+        if (UnrealMessageBus.AllowedOrigin != null && UnrealMessageBus.AllowedOrigin !== "" && UnrealMessageBus.AllowedOrigin !== "*" && event.origin !== UnrealMessageBus.AllowedOrigin) {
+            console.warn("UnrealMessageBus: Invalid Origin: " + event.origin);
+            return;
+        }
+        var postMessage = null;
+        var postArguments = null;
+        if (event.data.type != null) {
+            if (event.data.type === "progress" && event.data.value != null) {
+                postMessage = "WM_PROGRESS";
+                postArguments = [event.data.value.toString()];
             }
-            this.OnDispatchMessage(event.data.message, (event.data.args != null) ? event.data.args : null);
+            else if (event.data.type === "LoadComplete") {
+                postMessage = "WM_LOAD_COMPLETE";
+                postArguments = null;
+            }
+            else if (event.data.type === "focus") {
+                postMessage = "WM_FOCUS";
+                postArguments = null;
+            }
+            else if (event.data.type === "blur") {
+                postMessage = "WM_BLUR";
+                postArguments = null;
+            }
+            else if (event.data.type === "pointer-lock-active") {
+                postMessage = "WM_POINTER_LOCK_ACTIVE";
+                postArguments = null;
+            }
+            else if (event.data.type === "pointer-lock-inactive") {
+                postMessage = "WM_POINTER_LOCK_INACTIVE";
+                postArguments = null;
+            }
+        }
+        else if (event.data.source != null && event.data.source === "unrealtoolkit" && event.data.message != null) {
+            postMessage = event.data.message;
+            postArguments = (event.data.args != null) ? event.data.args : null;
+        }
+        try {
+            if (postMessage != null)
+                this.OnDispatchMessage(postMessage, postArguments);
         }
         catch (e) {
             console.warn(e);
@@ -128,6 +183,7 @@ export class UnrealMessageBus {
 }
 UnrealMessageBus.AllowedOrigin = "*";
 UnrealMessageBus.TargetOrigin = "*";
+UnrealMessageBus.ContentFrames = null;
 /** Unreal Toolkit Runtime Module */
 console.log("Unreal Toolkit Runtime - Version 0.1.8");
 export default UnrealToolkit;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "unreal-toolkit-next",
-    "version": "0.1.12",
+    "version": "0.1.14",
     "description": "Unreal Toolkit Runtime Library (ES6)",
     "module": "dist/index.js",
     "types": "dist/index.d.ts",