Home > Customization (Skins) > Tasten ummappen

Tasten der Tastatur ummappen

In der Kiosk-Industrie werden an öffentlichen Terminals oftmals spezielle Hardwaretastaturen verwendet, mit denen Sonderfunktionen ausgeführt werden können.
Es ist z.B. denkbar, eine Tastatur zu implementieren, die im Gegensatz zu einer herkömmlichen Tastatur die Zusatztaste "http://" oder zusätzliche Scrolltasten besitzt. SiteKiosk ermöglicht es Ihnen, z.B. eine F4 Taste mit der Funktion "nach unten scrollen" zu belegen. Interessant ist es z.B. auch, Tasten mit Links zu belegen, die dann auf die Webseiten von Werbepartnern führen.
1. Wie es funktioniert
Sobald Sie eine entsprechende Definitionsdatei (.xml) definiert und aktiviert haben, werden immer dann, wenn SiteKiosk läuft, die Tastatureingaben entsprechend Ihrer Definition umgelenkt. Wenn Sie SiteKiosk beenden agiert die Tastatur wieder normal.

Sie können beliebig viele Hotkeys definieren. Ein Hotkey ist eine Kombination aus einer normalen Taste (als Virtual Key Code angegeben) und keiner oder mehrerer Modifier Tasten. Modifier Tasten sind Shift, Strg, Alt und Windowslogo-Tasten. Außerdem kann jedem Hotkey eine Sounddatei zugeordnet werden, die beim Auslösen des Hotkeys gespielt wird.


1.1 Automatische Erstellung mit dem Keyboard Remapper
Ab der Version 6.2 wird ein kleines Tool ausgeliefert, welches Ihnen beim Ummappen der Tasten hilft und die erstellte Definitionsdatei aktiviert. Sie finden das Tool Keyboard Remapper im Windows Startmenü unter START / PROGRAMME / SITEKIOSK / ZUBEHÖR.


1.2 Manuelle Erstellung und Aktivierung
Alternativ kann die Datei auch manuell mit einem Editor (z.B. Notepad) erstellt werden und von Ihnen durch einen Eintrag in der Windows Registry aktiviert werden.
  1. Installieren Sie eine vollständige Version von SiteKiosk auf einem Rechner.
  2. Erstellen Sie eine Datei mit der Endung ".xml", die Ihre Tasten-Definitionen enthält.
  3. Legen Sie mit einem Registry-Editor (z.B. regedit.exe) unter dem Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\ProVisio\SiteKiosk
    (Windows 64 Bit: HKEY_LOCAL_MACHINE\Software\Wow6432Node\PROVISIO\SiteKiosk) einen Zeichenkettenwert mit dem Namen "HotKeyFile" an und tragen Sie als Daten den vollständigen Pfad zur Hotkey-Definitionsdatei (z.B. "C:\Program Files\SiteKiosk\Bitmaps\Sample.xml") ein.


2. Aufbau der Definitionsdatei
In der Definitionsdatei werden Hotkeys mit den gewünschten Funktionen definiert. Die Datei kann eine oder mehrere Hotkey-Definitionen enthalten.
Ein Hotkey kann einen bestimmten Aktionstyp zugewiesen bekommen oder ein Makro oder auch nur einen Sound.
2.1 Hotkey Typen
Der Typ eines Hotkeys legt die Aktion fest, die ausgeführt werden soll. Einem Hotkey muss ein Virtual Key Code zugewiesen werden, der die Taste bestimmt, die gedrückt werden soll, um die Hotkey-Aktion auszulösen.
Folgende Hotkey-Typen stehen zur Verfügung:

0   Individual key or macro (default, muss nicht explizit angegeben werden)
    (definiert über einen Virtual Key Code)
3   (Scroll) Links
4   (Scroll) Rechts
5   (Scroll) Hoch
6   (Scroll) Runter
8   (Scroll) Zurück
9   (Scroll) Vor
10  (Browser) Stop
11  (Browser) Refresh
12  (Browser) Startseite
13  (Browser) Drucken
14  (Browser) Suche
16  (Browser) URL aufrufen
17  (Skin) Hotkey Event feuern
2.2 Virtual Key Codes
Die Virtual Codes müssen dezimal angegeben werden und können der Dokumentation des Windows Plattform-SDKs entnommen werden. Sie können die Virtual Keycodes allerdings mit Hilfe des kostenlosen Tools virtkeys.exe herausbekommen.
Hier einige Beispiele für Virtual Keycodes, beachten Sie bitte, daß F12 reserviert ist und nicht verwendet werden kann:

VK_F1                  112
VK_F2                  113
VK_F3                  114
VK_F4                  115
VK_F5                  116
VK_F6                  117
VK_F7                  118
VK_F8                  119
VK_F9                  120
VK_F10                 121
VK_F11                 122
           etc...
2.3 Defining Sounds
Zu jedem definierten Hotkey kann ein Sound gespielt werden. Soll kein Sound abgespielt werden, kann einfach das Sound-Attribut weglassen werden.

<sound id='0'>mysoundfile.wav</sound>

Der Index (id='Indexnummer') ist ein tatsächlicher Array-Index - deshalb sollte bei 0 begonnen werden und fortlaufend ohne Lücken hochgezählt werden.
Wichtig:
Der Pfad zur Sound-Datei MUSS relativ zum SiteKiosk Verzeichnis angegeben werden.

2.4 Eine Beispieldatei
Das untenstehende Beispiel definiert verschiedene Tasten und gibt an, was passiert, wenn man diese drückt.

<hotkeys>
    <sound id='0'>wavs\mysoundfile.wav<sound/>
    <sound id='1'>wavs\mysoundfile2.wav<sound/>
    <sound id='2'>wavs\mysoundfile3.wav<sound/>
 
    <hotkey type='3' vkey='112' sound='0' alt='0' control='0' shift='0' windows='0' />
 
    <hotkey vkey='113' sound='1'>
        <key char='a'/>
    </hotkey>
 
    <hotkey vkey='113' sound='1'>
        <key char='B'/>
    </hotkey>
 
    <hotkey vkey='114' sound='2'>
    <key char='h'/>
        <key char='t'/>
        <key char='t'/>
        <key char='p'/>
        <key char=':'/>
        <key char='/'/>
        <key char='/'/>
    </hotkey>
 
    <hotkey type='16' vkey='115' sound='0'>
        <url>http://www.sitekiosk.com/</url>
    </hotkey>
 
    <hotkey type='17' vkey='122' sound='0'>
        <name>MyHotKeyEventName</name>
    </hotkey>
</hotkeys>
Nachfolgend finden Sie Erklärungen zu den einzelnen Punkten der Beispieldatei.
Beispiel einer Hotkey-Aktion:
<hotkey type='3' vkey='112' sound='0' alt='0' control='0' shift='0' windows='0' />

Bei Tastatureingabe von "F1" (vkey='112') wird die Funktion "SCROLL LEFT" ausgeführt (type='3') und der Sound "mysoundfile.wav" abgespielt (sound='0', Sound mit der id='0' wird abgespielt).
Zusätzlich kann man Systemtasten (Modifier) einschalten, die dann in Kombination mit F1 gedrückt werden müssten (in diesem Beispiel sind alle Modifier ausgeschaltet):
Beispiel zum Ummappen einer einzelnen Taste:
<hotkey vkey='113' sound='1'>
    <key char='a'/>
</hotkey>

Bei Tastatureingabe von "F2" wird die Taste "a" als Eingabe erzeugt. Wenn man in der Definition 'A' statt 'a' schreibt, würde ein grosses "A" erzeugt werden.
Beispiel eines Makros:
<hotkey vkey='114' sound='2'>
    <key char='h'/>
    <key char='t'/>
    <key char='t'/>
    <key char='p'/>
    <key char=':'/>
    <key char='/'/>
    <key char='/'/>
</hotkey>

Bei Tastatureingabe von "F3" wird "http://" als Eingabe erzeugt.
ESC Taste ummpappen:
<hotkey vkey='115' shift='1'>
    <key vkey='27' />
</hotkey>

Normalerweise kann man innerhalb von SiteKiosk den Passworteingabe Dialog mit Hilfe der ESC-Taste aufrufen. Hier ein Weg, wie man ESC auf anderem Wege aufrufen kann. Mit Hilfe von SHIFT + F4 wird hier ESC aufgerufen.
Einen Link definieren:
<hotkey type='16' vkey='155' sound='0'>
    <url>http://www.sitekiosk.com/</url>
</hotkey>

Bei Tastatureingabe von "F4" wird automatisch der angegebenen Link "http://www.sitekiosk.de" aufgerufen. Dies ist wohl die interessanteste Funktion, da Sie hierdurch Tastaturen mit z.B. Werbepartnern belegen können, die dann auf Knopfdruck aufgerufen werden.

Ein Hotkey Event in SiteKiosk auslösen:
<hotkey type='17' vkey='122' sound='0'>
    <name>MyHotKeyEventName</name>
</hotkey>

Beim Drücken von "F11" wird in SiteKiosk ein Event gefeuert, auf welches per SiteKiosk Object Model im Skin reagiert werden kann. Ein einfaches Beispiel, das den Namen des gedrückten Hotkeys in die SiteKiosk Logdatei schreibt:

SiteKiosk.LocaleManager.OnHotKeyPressed = OnHotKeyPressed;
function OnHotKeyPressed(hotkeyname)
{
    SiteKiosk.Logfile.Notification("Hotkeyname: " + hotkeyname);
}

Siehe auch

Manuell editierbare Optionen
Sprachdateien
SKSKIN-Datei
Browserlayout
Tastaturlayout
Startseitenlayout

Nach oben