Q_SetAudioVolume¶
Einleitung¶
Der Q_SetAudioVolume ist ein standardkonformer Funktionsbaustein zur Lautstärkeregelung in Virtual Terminals, entwickelt unter EPL-2.0 Lizenz. Die Version 1.0 implementiert die ISO 11783-6 (Teil 6 - F.12) Spezifikation für VT-Audiosteuerung.
Schnittstellenstruktur¶
Ereignis-Eingänge¶
INIT: InitialisierungsanforderungREQ: Lautstärkeänderungs-Anforderung
Ereignis-Ausgänge¶
INITO: InitialisierungsbestätigungCNF: Änderungsbestätigung
Daten-Eingänge¶
u8Volume(USINT): Lautstärkewert (0-100%)
Daten-Ausgänge¶
STATUS(STRING): Betriebsstatusmeldungu8OldVolume(USINT): Vorherige Lautstärkeeinstellungs16result(INT): ISO-konformer Ergebniscode
Funktionsweise¶
- Initialisierung:
INITohne Parameter-
INITObestätigt Betriebsbereitschaft -
Lautstärkeregelung:
REQmit gewünschtem Lautstärkewert- Ändert die globale VT-Lautstärke
-
CNFliefert Betriebsstatus und vorherigen Wert -
Wertebereich:
- 0%: Stummgeschaltet
- 100%: Maximale Lautstärke
Technische Besonderheiten¶
✔ ISO 11783-6 konform (F.12) ✔ Globale Audio-Steuerung ✔ Prozentuale Regelung (0-100%) ✔ Rückverfolgbarkeit (Vorherige Einstellung)
Lautstärke-Referenz¶
| Wert | Bedeutung |
|---|---|
| 0 | Stumm |
| 50 | Mittlere Lautstärke |
| 100 | Maximale Lautstärke |
Rückgabecodes (s16result)¶
| Code | Konstante | Bedeutung |
|---|---|---|
| 0 | VT_E_NO_ERR | Erfolgreiche Änderung |
| -6 | VT_E_OVERFLOW | Pufferüberlauf |
| -8 | VT_E_NOACT | VT nicht bereit |
| -21 | VT_E_NO_INSTANCE | Kein VT-Client verfügbar |
| -128 | VT_E_HANDLE_INVALID | Ungültige Audio-Konfiguration |
| -129 | VT_E_ISO_INSTANCE_INVALID | Ungültige VT-Instanz |
| -130 | VT_E_NOT_ALIVE | VT nicht aktiv |
Anwendungsszenarien¶
- Alarmmanagement: Regelbare Warnsignale
- Sprachausgabe: Lautstärkeanpassung
- Bedienkomfort: Benutzerdefinierte Audioeinstellungen
- Nachtbetrieb: Automatische Lautstärkereduzierung
⚖️ Vergleich mit ähnlichen Bausteinen¶
| Feature | Q_SetAudioVolume | VtAudioControl | VtSoundManager |
|---|---|---|---|
| ISO-Standard | ✔ | ✖ | ✖ |
| Wertebereich | 0-100% | 0-255 | 0-10 Stufen |
| Globalwirkung | ✔ | ✔ | ✖ |
| Rückmeldung | ✔ | ✖ | ✔ |
Fazit¶
Der Q_SetAudioVolume-Baustein bietet präzise Audiosteuerung:
- Intuitiv: Prozentuale Regelung
- Zuverlässig: ISO-konforme Implementierung
- Flexibel: Für alle Audioausgaben
Unverzichtbar für: - Professionelle Alarmysteme - Sprachgesteuerte Anwendungen - Komfortorientierte Bedienoberflächen