Was macht record-participant-video?
Zeichne visuelle Beweise des PsyNet-Teilnehmerflusses auf mittels Playwright-gesteuerter Interaktion, Screenshots und ffmpeg-Bildschirm-/Audioaufnahmen. Verwende dies, wenn Teilnehmerbeweise gesammelt, participant.mp4 erstellt oder das teilnehmergerichtete Verhalten dokumentiert werden soll.
Funktionsweise
Der Skill führt folgende Schritte aus:
- Initialisierung – Startet eine Playwright-Browserinstanz und navigiert zur angegebenen PsyNet-Teilnehmerseite.
- Interaktion – Führt vordefinierte Aktionen wie Klicks und Navigationen mit Playwright durch, um den Teilnehmerfluss zu simulieren.
- Screenshots – Erstellt zu bestimmten Zeitpunkten Screenshots, die als visuelle Referenzpunkte dienen.
- Aufzeichnung – Nutzt
ffmpeg, um den gesamten Bildschirm sowie das Audio während der Interaktion aufzuzeichnen. - Export – Kombiniert die Aufnahmen zu einer einzigen Videodatei (
participant.mp4), die als Beweismittel archiviert werden kann.
Warum ist dieser Skill nützlich?
- Automatisierte Dokumentation – Erspart manuelle Aufzeichnungen und stellt konsistente Ergebnisse sicher.
- Beweissicherung – Liefert eine nachvollziehbare Videodatei für Audits oder Debugging.
- Flexibilität – Unterstützt sowohl lokale als auch CI/CD-Umgebungen, die Playwright und ffmpeg bereitstellen.
Unterstützte Plattformen
- PsyNet – Speziell für die PsyNet-Teilnehmerverwaltung entwickelt.
- Playwright – Für die Browserautomatisierung.
- ffmpeg – Für die Video- und Audioaufnahme.
Verwendung
- Stelle sicher, dass
Playwrightundffmpeginstalliert und im Pfad verfügbar sind. - Führe das Skill-Skript aus, wobei die erforderlichen Parameter (z. B. Teilnehmer-ID, Ziel-URL) übergeben werden.
- Die resultierende
participant.mp4-Datei wird im angegebenen Ausgabeverzeichnis gespeichert.
Beispiel-Befehl
python record_participant.py --url "https://psynet.example.com/participant/123" --output ./recordings
Hinweise
- Stelle sicher, dass die Bildschirmauflösung und Audioeinstellungen für die Aufnahme optimiert sind.
- Bei Fehlern prüfe die Protokolle auf Playwright- oder ffmpeg-Meldungen.
- Die Aufnahme kann je nach Länge des Teilnehmerflusses mehrere Minuten dauern.
Fehlerbehandlung
- Playwright-Fehler: Überprüfe, ob der Browser korrekt gestartet werden kann und die URL erreichbar ist.
- ffmpeg-Fehler: Stelle sicher, dass ffmpeg korrekt installiert ist und die Codecs für die Video- und Audiokompression unterstützt werden.
Lizenz
Dieser Skill wird unter der MIT-Lizenz bereitgestellt. Weitere Informationen findest du in der LICENSE-Datei des Repositorys.