HandyCafe Docs
it-admin

Remote-Desktop

Remote-Desktop ermöglicht Administratoren, Client-PCs in Echtzeit direkt über die HandyCafe Server-Oberfläche anzuzeigen und zu steuern. Es ist für Fehlerbehebung, Überwachung und Kundenunterstützung in Ihrem Internetcafe oder Gaming-Center konzipiert, ohne physisch zum Rechner gehen zu müssen.

Remote-Desktop-Sitzung starten

  1. Suchen Sie im Admin-Panel den Client, zu dem Sie sich verbinden möchten.
  2. Klicken Sie auf die Client-Karte, um die Aktionsschaltflächen einzublenden.
  3. Klicken Sie auf die Schaltfläche Remote-Desktop.

Der Remote-Desktop-Viewer öffnet sich in einem separaten Fenster und zeigt den Client-Bildschirm mit interaktiven Steuerelementen.

Streaming-Technologie

H.264-Codec

Client-Bildschirme werden mit dem H.264-Videocodec kodiert, der hohe Bildqualität bei geringer Bandbreite bietet. Schlüsselbilder verwenden JPEG-Kodierung als Fallback für schnelle Erstanzeige und Wiederherstellung bei Paketverlust.

UDP-Frameübertragung

Kodierte Frames werden über UDP für minimale Latenz übertragen. Jeder Frame wird mithilfe eines strukturierten Protokolls mit einem 30-Byte-Header in Chunks aufgeteilt, der enthält:

Header-Feld Zweck
Magic Bytes Protokollidentifikation
Version Protokollversion für Kompatibilität
Frame-Typ Schlüsselbild vs. Delta-Frame-Indikator
Sitzungs-ID Identifiziert die Remote-Desktop-Sitzung
Sequenznummer Ordnet Frames für die Zusammensetzung
Zeitstempel Frame-Aufnahmezeit
Chunk-Index Position dieses Chunks innerhalb des Frames
Chunk-Anzahl Gesamtzahl der Chunks im Frame

Dieser Chunking-Ansatz ermöglicht es großen Frames, zuverlässig über das Netzwerk zu gelangen, während einzelne UDP-Pakete innerhalb sicherer MTU-Grenzen bleiben.

Interaktive Steuerung

Maus- und Tastaturweiterleitung

Nach der Verbindung werden Mausbewegungen, Klicks und Tastatureingaben vom Server-Operator an den Client-PC weitergeleitet. Der Client führt diese Eingaben aus, als wären sie lokal ausgeführt worden, was volle interaktive Kontrolle ermöglicht.

Zwischenablage-Synchronisierung

Die Zwischenablage wird zwischen Server und Client während einer aktiven Remote-Desktop-Sitzung synchronisiert. Auf der Serverseite kopierter Text kann auf dem Client eingefügt werden und umgekehrt.

Bitrate und Qualität

Die Streaming-Bitrate ist zwischen 350 kbps und 25.000 kbps konfigurierbar. Ein automatischer Anpassungsmechanismus überwacht die Netzwerkbedingungen und skaliert die Bitrate dynamisch, um ein flüssiges Betrachtungserlebnis aufrechtzuerhalten:

  • Bei schnellen, stabilen Netzwerken erhöht sich die Bitrate für schärfere Bildqualität.
  • Bei überlasteten oder langsamen Netzwerken verringert sich die Bitrate, um Frame-Drops und Verzögerungen zu vermeiden.

Administratoren können auch manuell Stream-Presets auswählen, die Qualität, FPS und Bitrate für verschiedene Anwendungsfälle ausbalancieren (z. B. Überwachung vs. aktive Steuerung).

Konfigurierbare Einstellungen

Der Remote-Desktop-Viewer bietet mehrere Einstellungen:

  • Qualität -- Bildqualitätsstufe für kodierte Frames.
  • FPS -- Ziel-Bildrate für den Stream.
  • Bitrate -- Manuelle Bitrate-Überschreibung oder Auto-Modus.
  • Cursor-Sichtbarkeit -- Ob das Remote-Cursor-Overlay angezeigt wird.
  • Stream-Presets -- Vordefinierte Konfigurationen für gängige Szenarien.

Sitzungsaufzeichnung

Remote-Desktop-Sitzungen können zur späteren Überprüfung als MP4-Dateien aufgezeichnet werden. Die Aufzeichnung verwendet einen FFmpeg-Unterprozess, der den eingehenden Frame-Stream in eine Standard-Videodatei kodiert. Aufzeichnungen werden im Verzeichnis config_dir/recordings/ mit Zeitstempel-Dateinamen gespeichert.

Paketverlust-Verfolgung

Der Viewer zeigt eine Drop-Rate in Prozent an, die angibt, wie viele Frames oder Chunks während der Übertragung verloren gingen. Hohe Drop-Raten deuten auf Netzwerküberlastung hin und könnten eine Reduzierung der Bitrate oder eine Untersuchung von Netzwerkproblemen erfordern.