M9-precursor: v1 Scrypted Script (snapshot-rate end-to-end)

scrypted/scrypted-viewport.ts — single-file TypeScript script for
Scrypted's Scripts plugin. Binds N viewports to N Scrypted cameras and
implements the full Scrypted side of the protocol:

  Outbound (Scrypted -> device):
    - POST /config on script load + every 5 min (re-syncs after device
      reboot or DHCP renumber).
    - POST /state {wake} when a bound camera fires an event or when the
      device's own POST /state {wake} arrives (operator tap).
    - POST /frame at FRAME_INTERVAL_MS (1 fps default) via
      camera.takePicture({picture:{width,height}}).
    - POST /state {sleep} when the Scrypted-side per-stream timer
      expires.

  Inbound (device -> Scrypted POST <base>/state):
    - {state:wake} -> startStream() (cancels pending sleep timer + any
      prior interval, then begins pushing frames).
    - {state:sleep} -> stopStream(sendSleep=false) (no echo back).
    - Unknown viewport -> 404. Bad body -> 400.

  Race rules from the spec are honored:
    - Every callback cancels prior pending state for that viewport
      before applying the new state (cancelPendingSleep semantics).
    - startStream / stopStream are idempotent — re-entering is safe.
    - On /frame returning 409, stream stops immediately without
      echoing /state {sleep} back (the device already slept).

  Configuration is a single BINDINGS array at the top of the file —
  edit name/host/cameraId/orientation per viewport and save in the
  Scrypted UI. No package install. Tuning constants
  (IDLE_TIMEOUT_MS, FRAME_INTERVAL_MS, REREGISTER_INTERVAL_MS, etc.)
  are right above the class.

scrypted/README.md walks through Scripts-plugin install, the BINDINGS
schema, what each constant controls, an event-by-event description of
the script's behavior, the v1 limitations (snapshot-rate, manual IP,
camera must respect picture dims), and an end-to-end smoke test.

Top-level README's Scrypted Integration section now links the script
file and the install README directly.

0 files changed, 0 insertions, 0 deletions