Files
hms-mediaengine/build/windows/GSTREAMER.md
T
HMS MediaEngine Agent 0922cc1d68 Phase 0: Repository-Initialisierung nach Bauplan v1.2
- Struktur gemäß §8 (Eigentumsgrenzen), PLAN.md als normative Basis
- Pflichtdokumente: STATUS.md, ERRORS.md, TEST_REPORT.md, CHANGELOG.md, ADRs
- ADR-0001 Python 3.13-Pin, ADR-0002 GStreamer 1.28.6-Pin (Windows),
  ADR-0003 IPC TCP+MessagePack v1
- Kernpakete: hms_protocol, hms_domain, hms_parameter, hms_artnet,
  hms_adaptive, hms_capabilities, hms_plugin_sdk
- Renderer-Spike: D3D11-Primärpfad + Dev-GL-Pfad (§36 Nr. 4-5)
- Control Core: FastAPI REST + WebSocket (§36 Nr. 9)
- Beispielplugins: Passthrough + Gaussian Blur (3 Adaptive-Quality-
  Varianten, HLSL/GLSL/GLES)
- Tools: Art-Net-Emulator, Fixture-Generator (Master32/Layer64-CSV),
  Capability-Probe
- JSON-Schemas: IPC, Plugin, Projekt, Cluster
- 121 Unit-/Integrationstests grün, Ruff grün

Gate 0 bleibt offen: Hardwaremessungen nur auf echter Windows-Referenz-
hardware gültig (§29.7, §33).
2026-09-11 00:36:59 +02:00

2.1 KiB
Raw Blame History

GStreamer-Bündelung Windows (Pin)

ADR-0002. Ziel: portables runtime/gstreamer ohne Systeminstallation (PLAN.md §3.1, §30.2).

Pin

  • Version: 1.28.6 (aktuelle stabile 1.28-Serie, Stand 2026-09-10, Quelle: https://gstreamer.freedesktop.org/download/)
  • Distribution: offizielle MSVC-Binaries, x86_64 (gstreamer-1.0-msvc-x86_64-1.28.6.msi)
  • SHA-256: nach dem ersten Bündelungs-Build manifestieren (§30.1)

Minimal gebündelte Plugin-Untermenge (Phase 0)

Ziel: H.264-MP4-Testclip → D3D11-Decode → Compositing → Vollbildausgabe.

Komponente Paket Enthält Zweck
libgstreamer-1.0-0.dll gstreamer core Kern
coreelements gst-plugins-core filesrc, queue, decodebin3-Basen Container/Datei
typefindfunctions gst-plugins-core Typenerkennung MP4-Erkennung
isomp4 gst-plugins-good qtdemux MP4-Demux
videoparsersbad gst-plugins-bad h264parse H.264-Parsing vor Decoder
playback gst-plugins-base uridecodebin bequeme Quelle (Spike)
d3d11 gst-plugins-bad d3d11h264dec, d3d11h265dec, d3d11convert, d3d11compositor, d3d11videosink GPU-Pfad (§12.6)
video/x-raw Basen gst-plugins-base videoconvert (nur Fallback, nicht Normalpfad) nur Diagnose

Nicht gebündelt (V1-Spike): Netzwerk-Quellen, NDI, Capture, Software-Codecs außer für expliziten Fallback.

Umgebungsvariablen beim Start (Launcher, §9.2)

GST_PLUGIN_PATH_1_0=<app>/runtime/gstreamer/lib/gstreamer-1.0
PATH=<app>/runtime/gstreamer/bin;%PATH%
GST_PLUGIN_SYSTEM_PATH_1_0=   (leer setzen, um System-Plugins zu unterdrücken)

Validierung

  1. Saubere Windows-VM ohne GStreamer (§29.6)
  2. gst-inspect-1.0 d3d11h264dec muss die Elemente aus dem Bündel listen
  3. Testpipeline läuft; GPU-Treiber ist die einzige Systemabhängigkeit
  4. MSI-Binärdateien und DLL-Set als SHA-256-Manifest festhalten

Offene Punkte

  • Bündelungsskript (MSI still entpacken, Untermenge kopieren) Phase-0-Aufgabe mit Packaging-ADR-0005
  • VC-Runtime-Redistributable-Handling → runtime/vc-runtime (§9)