HMS MediaEngine Agent
0922cc1d68
- 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).
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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)
|
||
|
||
```text
|
||
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)
|