@7365admin1/layer-common 4.57.1 → 4.57.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @iservice365/layer-common
 
+## 4.57.2
+
+### Patch Changes
+
+- e901907: Robots: live view says honestly when the camera video cannot be decoded (MEDIA_ERR_DECODE, e.g. EZVIZ video encryption switched on) instead of retrying: at most two hls.js recoveries, then a plain message with Retry. The message no longer blames the browser when the decoder reports support.
+
 ## 4.57.1
 
 ### Patch Changes
@@ -1599,11 +1605,11 @@
   `utils/console-tier.ts` + `composables/useConsoleTier.ts` mirror the server's
   own rule from two endpoints the console already calls, unprojected:
 
-                                                                                                                                                                                                                                                GET /api/members/user/:user/app/admin    the Seven365 staff membership
-                                                                                                                                                                                                                                                GET /api/roles/id/:role                  that membership's role document
+                                                                                                                                                                                                                                                  GET /api/members/user/:user/app/admin    the Seven365 staff membership
+                                                                                                                                                                                                                                                  GET /api/roles/id/:role                  that membership's role document
 
-                                                                                                                                                                                                                                                owner  = member.type === "admin" && role.type === "admin" && role.default === true
-                                                                                                                                                                                                                                                staff  = member.type === "admin" && role.type === "admin"
+                                                                                                                                                                                                                                                  owner  = member.type === "admin" && role.type === "admin" && role.default === true
+                                                                                                                                                                                                                                                  staff  = member.type === "admin" && role.type === "admin"
 
   `role.default` is the marker because it is the only property of a platform
   staff role no API caller can set - `role.controller.ts` validates create and

package/components/Robot/LiveView.vue

@@ -69,6 +69,7 @@ import {
   LIVE_DOWN,
   LIVE_NO_PICTURE,
   LIVE_RETRY_LIMIT,
+  LIVE_UNDECODABLE,
   liveRetryDelayMs,
   liveVideoKind,
   liveViewActive,
@@ -168,8 +169,9 @@ watch([videoEl, url], ([el, src]) => {
 });
 function onPlayerFail(message: string) {
   stopPlayer = undefined;
-  if (message === LIVE_NO_PICTURE) {
-    // The browser can't show H.265: no silent retries behind the message; Retry is the user's.
+  if (message === LIVE_NO_PICTURE || message === LIVE_UNDECODABLE) {
+    // Can't be shown (browser codec / encrypted camera video): a fresh URL won't help,
+    // so no silent retries behind the message; Retry is the user's.
     gen++;
     clearTimeout(timer);
     error.value = message;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.57.1",
+  "version": "4.57.2",
   "author": "7365admin1",
   "main": "./nuxt.config.ts",
   "//files": "What a consumer extending this layer actually loads. Without this npm ships the whole working tree - the changesets, the CI workflows, the render harness in tools/ and any scratch directory that happened to exist at publish time. Nuxt resolves a layer by directory, so every runtime directory below has to stay listed; adding a new top-level runtime directory means adding it here too.",

package/utils/robot-control.ts

@@ -36,6 +36,14 @@ export function remintDelayMs(expiresAt: unknown, now: number = Date.now()): num
 export const LIVE_NO_PICTURE =
   "This robot's camera sends H.265 video, which this browser can't show. Try Microsoft Edge or Safari, or the PadBot app.";
 export const LIVE_DOWN = "The robot's camera isn't available right now.";
+/**
+ * The decoder says it supports the codec but the frames still won't decode
+ * (MEDIA_ERR_DECODE). Seen on the PadBot S2 (EZVIZ H3): EZVIZ device video
+ * encryption scrambles the frames, so plain HLS can't show them. It's not the browser.
+ */
+export const LIVE_UNDECODABLE =
+  "The robot's camera video couldn't be decoded. This usually means video encryption is switched on in the camera's EZVIZ app. Ask the administrator to turn it off, or contact PadBot.";
+const MEDIA_ERR_DECODE = 3;
 
 /** Wait before automatic reconnect attempt n (0-based): 2 s, 4 s, 8 s, 16 s, then 30 s. */
 export const liveRetryDelayMs = (n: number) => Math.min(30_000, 2_000 * 2 ** n);
@@ -88,6 +96,8 @@ const CODEC_ERRORS = new Set(["manifestIncompatibleCodecsError", "bufferAddCodec
  * `onFail` fires once, with LIVE_NO_PICTURE when the stream plays but no
  * picture ever decodes (Chrome's native HLS takes H.265-in-TS audio but shows
  * no video, videoWidth stays 0) or the codec is refused; LIVE_DOWN for
+ * LIVE_UNDECODABLE when the video element reported MEDIA_ERR_DECODE (after at
+ * most two hls.js recoveries - no endless retrying); LIVE_DOWN for
  * everything else (network, expired URL, repeated media errors, a stall) -
  * the caller fetches a fresh URL and starts again.
  */
@@ -113,6 +123,7 @@ export function startLivePlayer(
   let pictured = false;
   let lastTime = -1;
   let still = 0;
+  let decodeFailed = false; // the video element reported MEDIA_ERR_DECODE at some point
 
   const fail = (message: string) => {
     if (stopped) return;
@@ -128,7 +139,8 @@ export function startLivePlayer(
         opts.onPicture?.();
       } else if (waited >= noPictureMs) {
         // Time moving with no picture = the codec; nothing moving = no stream.
-        return fail(video.currentTime > 0 ? LIVE_NO_PICTURE : LIVE_DOWN);
+        noteDecode();
+        return fail(decodeFailed ? LIVE_UNDECODABLE : video.currentTime > 0 ? LIVE_NO_PICTURE : LIVE_DOWN);
       }
       return;
     }
@@ -138,12 +150,19 @@ export function startLivePlayer(
       still = 0;
     } else if ((still += tickMs) >= stallMs) fail(LIVE_DOWN);
   }, tickMs);
-  const onError = () => fail(LIVE_DOWN);
+  const noteDecode = () => {
+    if (video.error?.code === MEDIA_ERR_DECODE) decodeFailed = true;
+  };
+  const onError = () => {
+    noteDecode();
+    fail(decodeFailed ? LIVE_UNDECODABLE : LIVE_DOWN);
+  };
 
   function stop() {
     stopped = true;
     clearInterval(tick);
     video.removeEventListener("error", onError);
+    video.removeEventListener("error", noteDecode);
     hls?.destroy();
     hls = undefined;
     video.removeAttribute("src");
@@ -165,9 +184,11 @@ export function startLivePlayer(
       .then((Hls) => {
         if (stopped) return;
         if (!Hls.isSupported()) return native();
+        video.addEventListener("error", noteDecode);
         let recoveries = 0;
         const h = (hls = new Hls({ enableWorker: true, lowLatencyMode: false }));
         h.on("hlsError", (_e, data) => {
+          noteDecode();
           if (!data.fatal) return;
           if (CODEC_ERRORS.has(data.details ?? "")) return fail(LIVE_NO_PICTURE);
           // The standard hls.js ladder: recover, then swap audio codec and recover, then give up.
@@ -175,7 +196,7 @@ export function startLivePlayer(
             if (recoveries++ === 1) h.swapAudioCodec();
             return h.recoverMediaError();
           }
-          fail(LIVE_DOWN);
+          fail(decodeFailed ? LIVE_UNDECODABLE : LIVE_DOWN);
         });
         h.loadSource(url);
         h.attachMedia(video);