python-aidot-cameras 0.7.31__tar.gz → 0.7.32__tar.gz

{python_aidot_cameras-0.7.31/src/python_aidot_cameras.egg-info → python_aidot_cameras-0.7.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-aidot-cameras
-Version: 0.7.31
+Version: 0.7.32
 Summary: Control AiDot/Leedarson WiFi lights and cameras (WebRTC streaming, two-way audio, PTZ, controls)
 Author-email: cbrightly <chris.brightly@gmail.com>
 License-Expression: MIT
@@ -124,7 +124,7 @@ chosen to work out of the box; override only when tuning.
 | `AIDOT_FAST_CONNECT` | Enables LAN-direct "fast connect" mode (STUN-only, skips several cloud signaling waits) when set to a truthy value. | unset (off) |
 | `AIDOT_PERSISTENT_MQTT` | Reuse ONE account-level persistent MQTT connection for device commands, attribute fetches, AND stream-open signaling (matching the official app) instead of connecting per operation, cutting cloud connect churn. **On by default** (the app's behaviour; live soak cut SDES NO_MEDIA ~57%→~19%); set to `0`/`false`/`no`/`off` to disable. | enabled (on) |
 | `AIDOT_SDES_ADAPTIVE` | Adaptive fast-with-fallback for the SDES keepalive loop: try the fast path first (skip livePlay waits + TURN relay pre-alloc) and fall back to the full relay path if a fast attempt delivers no media. A per-device cache skips the fast attempt on later views once it has failed for a camera. Truthy value enables. | unset (off) |
-| `AIDOT_SDES_FAST_LIVEPLAY` | Truthy value skips the `livePlayResp` blocking wait for eligible SDES cameras (~4.5 s faster cold start), while keeping the full ICE/SCTP handshake. Role-reversal models (A001064 PTZ) are always excluded. Soak-validated; opt-in. | unset (off) |
+| `AIDOT_SDES_FAST_LIVEPLAY` | Don't block on the `livePlayResp` wait for eligible SDES cameras (~4.5 s faster cold start), going straight to webrtcReq/ICE — what the official app does (it never waits for livePlayResp). Role-reversal models (A001064 PTZ) always excluded for correctness. **On by default**; set to `0`/`false`/`no`/`off` to disable. | enabled (on) |
 | `AIDOT_SERVE_RELAY` | Holds the public stream port via an internal relay that proxies to ffmpeg, so the first (cold) view connects instead of failing while ffmpeg can't pre-bind the port. Set to `0` to serve ffmpeg directly. | `1` (enabled) |
 | `AIDOT_MAX_CONCURRENT_OPENS` | Caps how many stream opens run concurrently. | `2` |
 | `AIDOT_MAX_CONCURRENT_STREAMS` | Caps how many cameras stream at once. | `3` |

{python_aidot_cameras-0.7.31 → python_aidot_cameras-0.7.32}/README.md

@@ -97,7 +97,7 @@ chosen to work out of the box; override only when tuning.
 | `AIDOT_FAST_CONNECT` | Enables LAN-direct "fast connect" mode (STUN-only, skips several cloud signaling waits) when set to a truthy value. | unset (off) |
 | `AIDOT_PERSISTENT_MQTT` | Reuse ONE account-level persistent MQTT connection for device commands, attribute fetches, AND stream-open signaling (matching the official app) instead of connecting per operation, cutting cloud connect churn. **On by default** (the app's behaviour; live soak cut SDES NO_MEDIA ~57%→~19%); set to `0`/`false`/`no`/`off` to disable. | enabled (on) |
 | `AIDOT_SDES_ADAPTIVE` | Adaptive fast-with-fallback for the SDES keepalive loop: try the fast path first (skip livePlay waits + TURN relay pre-alloc) and fall back to the full relay path if a fast attempt delivers no media. A per-device cache skips the fast attempt on later views once it has failed for a camera. Truthy value enables. | unset (off) |
-| `AIDOT_SDES_FAST_LIVEPLAY` | Truthy value skips the `livePlayResp` blocking wait for eligible SDES cameras (~4.5 s faster cold start), while keeping the full ICE/SCTP handshake. Role-reversal models (A001064 PTZ) are always excluded. Soak-validated; opt-in. | unset (off) |
+| `AIDOT_SDES_FAST_LIVEPLAY` | Don't block on the `livePlayResp` wait for eligible SDES cameras (~4.5 s faster cold start), going straight to webrtcReq/ICE — what the official app does (it never waits for livePlayResp). Role-reversal models (A001064 PTZ) always excluded for correctness. **On by default**; set to `0`/`false`/`no`/`off` to disable. | enabled (on) |
 | `AIDOT_SERVE_RELAY` | Holds the public stream port via an internal relay that proxies to ffmpeg, so the first (cold) view connects instead of failing while ffmpeg can't pre-bind the port. Set to `0` to serve ffmpeg directly. | `1` (enabled) |
 | `AIDOT_MAX_CONCURRENT_OPENS` | Caps how many stream opens run concurrently. | `2` |
 | `AIDOT_MAX_CONCURRENT_STREAMS` | Caps how many cameras stream at once. | `3` |

{python_aidot_cameras-0.7.31 → python_aidot_cameras-0.7.32}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-aidot-cameras"
-version = "0.7.31"
+version = "0.7.32"
 description = "Control AiDot/Leedarson WiFi lights and cameras (WebRTC streaming, two-way audio, PTZ, controls)"
 readme = "README.md"
 license = "MIT"

{python_aidot_cameras-0.7.31 → python_aidot_cameras-0.7.32}/src/aidot/camera/client.py

@@ -2607,16 +2607,19 @@ class CameraMixin(_CameraControlsMixin):
             return 120.0
 
     def _resolve_sdes_fast_liveplay(self) -> bool:
-        """Whether to use SDES fast-liveplay (shorten the always-timing-out
-        echo/livePlayResp signaling) - validated in soak, opt-in, default off.
-
-        Per-camera ``sdes_fast_liveplay`` (set via start_keepalive) wins; else the
-        ``AIDOT_SDES_FAST_LIVEPLAY`` env (truthy = 1/true/yes/on), default off.
-        Only consulted for SDES cameras (the caller gates on is_sdes_camera).
-
-        Role-reversal models (``_NO_FAST_LIVEPLAY_MODELS``, e.g. A001064) are always
-        excluded - their handshake needs the camera armed before our webrtcReq, so
-        the flag's early webrtcReq degrades their media reliability."""
+        """Whether to use SDES fast-liveplay: don't block on the always-timing-out
+        echo/livePlayResp signaling, go straight to webrtcReq/ICE.
+
+        **Default ON** - this is exactly what the official app does (it never waits
+        for/parses livePlayResp; fire-and-forget). Disable via
+        ``AIDOT_SDES_FAST_LIVEPLAY`` in {0,false,no,off} or per-camera
+        ``_sdes_fast_liveplay_opt=False`` (the explicit opt always wins).
+
+        Role-reversal models (``_NO_FAST_LIVEPLAY_MODELS``, e.g. A001064) are ALWAYS
+        excluded regardless of the flag - their handshake needs the camera armed
+        before our webrtcReq, so the early webrtcReq degrades their media (a
+        correctness exclusion, not a default choice). Only consulted for SDES
+        cameras (the caller gates on is_sdes_camera)."""
         model = getattr(getattr(self, "info", None), "model_id", None)
         if model in self._NO_FAST_LIVEPLAY_MODELS:
             return False
@@ -2626,8 +2629,8 @@ class CameraMixin(_CameraControlsMixin):
         ov = getattr(self, "_fast_attempt_override", None)
         if ov is not None:
             return bool(ov)
-        return os.environ.get("AIDOT_SDES_FAST_LIVEPLAY", "").strip().lower() in (
-            "1", "true", "yes", "on")
+        return os.environ.get("AIDOT_SDES_FAST_LIVEPLAY", "").strip().lower() not in (
+            "0", "false", "no", "off")
 
     def _resolve_sdes_skip_turn(self) -> bool:
         """EXPERIMENTAL (opt-in, default off): skip the blocking SDES TURN relay

{python_aidot_cameras-0.7.31 → python_aidot_cameras-0.7.32/src/python_aidot_cameras.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-aidot-cameras
-Version: 0.7.31
+Version: 0.7.32
 Summary: Control AiDot/Leedarson WiFi lights and cameras (WebRTC streaming, two-way audio, PTZ, controls)
 Author-email: cbrightly <chris.brightly@gmail.com>
 License-Expression: MIT
@@ -124,7 +124,7 @@ chosen to work out of the box; override only when tuning.
 | `AIDOT_FAST_CONNECT` | Enables LAN-direct "fast connect" mode (STUN-only, skips several cloud signaling waits) when set to a truthy value. | unset (off) |
 | `AIDOT_PERSISTENT_MQTT` | Reuse ONE account-level persistent MQTT connection for device commands, attribute fetches, AND stream-open signaling (matching the official app) instead of connecting per operation, cutting cloud connect churn. **On by default** (the app's behaviour; live soak cut SDES NO_MEDIA ~57%→~19%); set to `0`/`false`/`no`/`off` to disable. | enabled (on) |
 | `AIDOT_SDES_ADAPTIVE` | Adaptive fast-with-fallback for the SDES keepalive loop: try the fast path first (skip livePlay waits + TURN relay pre-alloc) and fall back to the full relay path if a fast attempt delivers no media. A per-device cache skips the fast attempt on later views once it has failed for a camera. Truthy value enables. | unset (off) |
-| `AIDOT_SDES_FAST_LIVEPLAY` | Truthy value skips the `livePlayResp` blocking wait for eligible SDES cameras (~4.5 s faster cold start), while keeping the full ICE/SCTP handshake. Role-reversal models (A001064 PTZ) are always excluded. Soak-validated; opt-in. | unset (off) |
+| `AIDOT_SDES_FAST_LIVEPLAY` | Don't block on the `livePlayResp` wait for eligible SDES cameras (~4.5 s faster cold start), going straight to webrtcReq/ICE — what the official app does (it never waits for livePlayResp). Role-reversal models (A001064 PTZ) always excluded for correctness. **On by default**; set to `0`/`false`/`no`/`off` to disable. | enabled (on) |
 | `AIDOT_SERVE_RELAY` | Holds the public stream port via an internal relay that proxies to ffmpeg, so the first (cold) view connects instead of failing while ffmpeg can't pre-bind the port. Set to `0` to serve ffmpeg directly. | `1` (enabled) |
 | `AIDOT_MAX_CONCURRENT_OPENS` | Caps how many stream opens run concurrently. | `2` |
 | `AIDOT_MAX_CONCURRENT_STREAMS` | Caps how many cameras stream at once. | `3` |

{python_aidot_cameras-0.7.31 → python_aidot_cameras-0.7.32}/tests/test_sdes_fast_liveplay.py

@@ -21,21 +21,22 @@ def _cam():
     return _CAM.__new__(_CAM)
 
 
-def test_default_off(monkeypatch):
+def test_default_on(monkeypatch):
+    # default ON (matches the app — it never waits for livePlayResp)
     monkeypatch.delenv("AIDOT_SDES_FAST_LIVEPLAY", raising=False)
-    assert _cam()._resolve_sdes_fast_liveplay() is False
+    assert _cam()._resolve_sdes_fast_liveplay() is True
 
 
-def test_env_truthy_values(monkeypatch):
-    for val in ("1", "true", "TRUE", "yes", "on", " On "):
+def test_env_disables(monkeypatch):
+    for val in ("0", "false", "no", "off", " Off "):
         monkeypatch.setenv("AIDOT_SDES_FAST_LIVEPLAY", val)
-        assert _cam()._resolve_sdes_fast_liveplay() is True, val
+        assert _cam()._resolve_sdes_fast_liveplay() is False, val
 
 
-def test_env_falsey_values(monkeypatch):
-    for val in ("0", "false", "no", "off", ""):
+def test_env_truthy_or_unknown_stays_on(monkeypatch):
+    for val in ("1", "true", "yes", "on", "", "anything"):
         monkeypatch.setenv("AIDOT_SDES_FAST_LIVEPLAY", val)
-        assert _cam()._resolve_sdes_fast_liveplay() is False, val
+        assert _cam()._resolve_sdes_fast_liveplay() is True, val
 
 
 def test_role_reversal_model_always_excluded(monkeypatch):