@needle-tools/engine 3.37.5-alpha → 3.37.6-alpha

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [3.37.6-alpha] - 2023-04-24
+- Add: More API documentation
+- Add: VideoPlayer can now play `m3u` livestream links
+- Fix: WebARBackground now checks if camera-access is granted
+- Change: Progressively loaded assets now postfix urls with the content hash of the assets if available to make sure the correct version is loaded and not a old version from cache
+- Change: VideoPlayer setting `url` now immediately updates the videoplayback
+
 ## [3.37.5-alpha] - 2023-04-23
 - Add: SceneSwitcher support for adding the `ISceneEventListener` on the sceneSwitcher gameObject
 - Fix: OrbitControls should not update on user input when the camera is not currently active

package/dist/needle-engine.js

@@ -29476,13 +29476,13 @@ function vBA(g) {
   ok = g;
 }
 const lT = IA("debugdefines");
-OE('if(!globalThis[""3.37.5-alpha""]) globalThis[""3.37.5-alpha""] = "0.0.0";');
+OE('if(!globalThis[""3.37.6-alpha""]) globalThis[""3.37.6-alpha""] = "0.0.0";');
 OE('if(!globalThis[""undefined""]) globalThis[""undefined""] = "unknown";');
-OE('if(!globalThis[""Tue Apr 23 2024 09:16:03 GMT+0200 (Central European Summer Time)""]) globalThis[""Tue Apr 23 2024 09:16:03 GMT+0200 (Central European Summer Time)""] = "unknown";');
-OE('globalThis["__NEEDLE_ENGINE_VERSION__"] = "3.37.5-alpha";');
+OE('if(!globalThis[""Wed Apr 24 2024 17:26:38 GMT+0200 (Central European Summer Time)""]) globalThis[""Wed Apr 24 2024 17:26:38 GMT+0200 (Central European Summer Time)""] = "unknown";');
+OE('globalThis["__NEEDLE_ENGINE_VERSION__"] = "3.37.6-alpha";');
 OE('globalThis["__NEEDLE_ENGINE_GENERATOR__"] = "undefined";');
-OE('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Tue Apr 23 2024 09:16:03 GMT+0200 (Central European Summer Time)";');
-const lC = "3.37.5-alpha", jU = "undefined", hT = "Tue Apr 23 2024 09:16:03 GMT+0200 (Central European Summer Time)";
+OE('globalThis["__NEEDLE_PROJECT_BUILD_TIME__"] = "Wed Apr 24 2024 17:26:38 GMT+0200 (Central European Summer Time)";');
+const lC = "3.37.6-alpha", jU = "undefined", hT = "Wed Apr 24 2024 17:26:38 GMT+0200 (Central European Summer Time)";
 lT && console.log(`Engine version: ${lC} (generator: ${jU})
 Project built at ${hT}`);
 const Ra = "needle_isActiveInHierarchy", GQ = "builtin_components", hf = "needle_editor_guid";
@@ -66303,7 +66303,7 @@ const PI = class {
       const Q = Array.isArray(n.lods) ? n.lods[i].path : n.lods;
       if (!Q)
         return eI && !n["missing:uri"] && (n["missing:uri"] = !0, console.warn("Missing uri for progressive asset for LOD " + i, n)), null;
-      const E = Wa(e, Q);
+      let E = Wa(e, Q);
       if (E.endsWith(".glb") || E.endsWith(".gltf")) {
         if (!n.guid)
           return console.warn("missing pointer for glb/gltf texture", n), null;
@@ -66317,7 +66317,11 @@ const PI = class {
         }
         const l = n, h = new Promise(async (u, f) => {
           const k = new PE();
-          Gd(k, A), eI && (await wn(Math.random() * 1e3), I && console.warn("Start loading (delayed) " + E, l.guid));
+          if (Gd(k, A), n && Array.isArray(n.lods)) {
+            const N = n.lods[i];
+            N.hash && (E += "?v=" + N.hash);
+          }
+          eI && (await wn(Math.random() * 1e3), I && console.warn("Start loading (delayed) " + E, l.guid));
           const G = await k.loadAsync(E).catch((N) => (console.error(`Error loading LOD ${i} from ${E}
 `, N), null));
           if (!G)
@@ -85348,7 +85352,7 @@ class yg extends RA {
     r(this, "aspectMode", 0);
     r(this, "clip", null);
     r(this, "source", 1);
-    r(this, "url", null);
+    r(this, "_url", null);
     r(this, "renderMode");
     r(this, "targetMaterialProperty");
     r(this, "targetMaterialRenderer");
@@ -85383,7 +85387,7 @@ class yg extends RA {
     r(this, "_hls");
     r(this, "onHlsAvailable", () => {
       var e;
-      Eg && console.log("HLS: available", this.clip), !(!this.shouldUseM3U8 || !this.url) && (this._hls || (this._hls = new Hls()), this.videoElement.autoplay = !0, this._hls.loadSource(this.url), this._hls.attachMedia(this.videoElement), (e = this._videoElement) == null || e.play(), Eg && console.log("HLS: loaded", this.clip));
+      Eg && console.log("HLS: available", this.clip), !(!this.shouldUseM3U || !this.url) && (this._hls || (this._hls = new Hls()), this.videoElement.autoplay = !0, this._hls.loadSource(this.url), this._hls.attachMedia(this.videoElement), (e = this._videoElement) == null || e.play(), Eg && console.log("HLS: loaded", this.clip));
     });
     NCA(() => {
       this._receivedInput = !0, this.updateVideoElementSettings();
@@ -85391,6 +85395,13 @@ class yg extends RA {
       e.key === "f" && (this.screenspace = !this.screenspace);
     });
   }
+  get url() {
+    return this._url;
+  }
+  set url(e) {
+    const i = this._url !== e;
+    this.__didAwake ? i && this.setClipURL(e ?? "") : this._url = e;
+  }
   get playbackSpeed() {
     var e;
     return ((e = this._videoElement) == null ? void 0 : e.playbackRate) ?? this._playbackSpeed;
@@ -85468,7 +85479,7 @@ class yg extends RA {
     this.clip = e, this.source = 0, this._videoElement ? (this._videoElement.srcObject = e, this._isPlaying && this.play(), this.updateAspect()) : this.create(this.playOnAwake);
   }
   setClipURL(e) {
-    this.url !== e && (this.url = e, this.source = 1, Eg && console.log("set url", e), this._videoElement ? e.endsWith(".m3u8") ? this.ensureM3U8CanBePlayed() : (this._videoElement.src = e, this._isPlaying && (this.stop(), this.play())) : this.create(this.playOnAwake));
+    this._url !== e && (this._url = e, this.source = 1, Eg && console.log("set url", e), this._videoElement ? e.endsWith(".m3u8") || e.includes(".m3u") ? this.ensureM3UCanBePlayed() : (this._videoElement.src = e, this._isPlaying && (this.stop(), this.play())) : this.create(this.playOnAwake));
   }
   onEnable() {
     var e, t;
@@ -85490,8 +85501,8 @@ class yg extends RA {
       return;
     }
     if (!(this._isPlaying && !((e = this._videoElement) != null && e.ended) && !((t = this._videoElement) != null && t.paused))) {
-      if (this._isPlaying = !0, this._receivedInput || (this._videoElement.muted = !0), this.handleBeginPlaying(!1), this.shouldUseM3U8) {
-        this.ensureM3U8CanBePlayed();
+      if (this._isPlaying = !0, this._receivedInput || (this._videoElement.muted = !0), this.handleBeginPlaying(!1), this.shouldUseM3U) {
+        this.ensureM3UCanBePlayed();
         return;
       }
       Eg && console.log("Video Play()", this.clip, this._videoElement, this.time), this._videoElement.currentTime = this.time, this._videoElement.play().catch((i) => {
@@ -85577,7 +85588,7 @@ class yg extends RA {
       console.warn("Can not play video, no material found, this might be a multimaterial case which is not supported yet");
       return;
     }
-    this.updateVideoElementSettings(), this.updateVideoElementStyles(), e && (this.shouldUseM3U8 && this.ensureM3U8CanBePlayed(), this.play());
+    this.updateVideoElementSettings(), this.updateVideoElementStyles(), e && (this.shouldUseM3U && this.ensureM3UCanBePlayed(), this.play());
   }
   updateVideoElementSettings() {
     if (!this._videoElement)
@@ -85633,11 +85644,11 @@ class yg extends RA {
         yield;
     }
   }
-  get shouldUseM3U8() {
-    return this.url != null && this.url.endsWith(".m3u8") && this.source === 1;
+  get shouldUseM3U() {
+    return this.url != null && (this.url.endsWith(".m3u8") || this.url.endsWith(".m3u")) && this.source === 1;
   }
-  ensureM3U8CanBePlayed() {
-    if (!this.shouldUseM3U8)
+  ensureM3UCanBePlayed() {
+    if (!this.shouldUseM3U)
       return;
     let e = document.head.querySelector("script[data-hls_library]");
     e ? globalThis.Hls ? this.onHlsAvailable() : e.addEventListener("load", this.onHlsAvailable) : (Eg && console.log("HLS: load script"), e = document.createElement("script"), e.dataset.hls_library = "hls.js", e.src = "https://cdn.jsdelivr.net/npm/hls.js@1", e.addEventListener("load", this.onHlsAvailable), document.head.append(e));
@@ -85657,7 +85668,7 @@ Ro([
 ], yg.prototype, "source", 2);
 Ro([
   D(URL)
-], yg.prototype, "url", 2);
+], yg.prototype, "url", 1);
 Ro([
   D()
 ], yg.prototype, "renderMode", 2);
@@ -88027,17 +88038,22 @@ class yN extends RA {
   updateFromFrame(e) {
     if (!e)
       return;
-    const t = e.getViewerPose(this.context.renderer.xr.getReferenceSpace());
-    if (t) {
-      for (const i of t.views)
-        if ("camera" in i && i.camera) {
-          let o = this.context.renderer.xr.getBinding();
-          if (o || (o = new XRWebGLBinding(e.session, this.context.renderer.getContext())), o) {
-            let s = null;
-            if ("getCameraImage" in o) {
-              s = o.getCameraImage(i.camera);
-              const n = this.context.renderer.properties.get(this.threeTexture);
-              n.__webglTexture = s, this.backgroundPlane ? (this.backgroundPlane.setTexture(this.threeTexture), this.backgroundPlane.visible = !0) : Tf && console.warn("No background plane to set texture on");
+    const t = e.session.enabledFeatures;
+    if (t && !t.some((I) => I === "camera-access")) {
+      this.background && (this.background.visible = !1);
+      return;
+    }
+    const i = e.getViewerPose(this.context.renderer.xr.getReferenceSpace());
+    if (i) {
+      for (const I of i.views)
+        if ("camera" in I && I.camera) {
+          let s = this.context.renderer.xr.getBinding();
+          if (s || (s = new XRWebGLBinding(e.session, this.context.renderer.getContext())), s) {
+            let n = null;
+            if ("getCameraImage" in s) {
+              n = s.getCameraImage(I.camera);
+              const C = this.context.renderer.properties.get(this.threeTexture);
+              C.__webglTexture = n, this.backgroundPlane ? (this.backgroundPlane.setTexture(this.threeTexture), this.backgroundPlane.visible = !0) : Tf && console.warn("No background plane to set texture on");
             }
           }
         }