Files
hms-mediaengine/docs/adr/0002-gstreamer-pin-windows.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

1.2 KiB

ADR-0002: GStreamer-Pin für Windows

  • Status: Angenommen (Bündelungsumfang folgt nach Phase-0-Build)
  • Datum: 2026-09-10
  • Phase: 0
  • Bauplan: §7.1, §30.2

Entscheidung

Für die portable Windows-Ausgabe wird GStreamer 1.28.6 (MSVC, x86_64) gebündelt (Runtime-Paket, exakt manifestierte Plugin-Untermenge). Details: build/windows/GSTREAMER.md.

Kontext

Die 1.28-Serie ist die aktuelle stabile Release-Serie mit gepflegtem D3D11-Stack (d3d11h264dec, d3d11convert, d3d11compositor, d3d11videosink). Version ermittelt von https://gstreamer.freedesktop.org/download/ (Stand 2026-09-10).

Alternativen

  • Ältere LTS-Releases: keine Vorteile, ältere D3D11-Elemente.
  • Eigener GStreamer-Build: höherer Wartungsaufwand, für Phase 0 nicht nötig.

Folgen

  • Phase 0 prüft die Bündelung in einer sauberen Windows-VM ohne installiertes GStreamer (§29.6); Pluginliste und SHA-256 werden nach dem ersten Onefolder-Build manifestiert.
  • Muss mit der Packaging-Entscheidung (ADR-0005 offen) zusammenarbeiten.

Freigabe

  • Entspricht PLAN.md §7.1 (Version pinnen); Bündelungsumfang wird nach dem ersten Portabilitätstest ergänzt.