Aufbau Qt Virtual Keyboard

Übersicht

Dieses Dokument beschreibt, wie das „ Qt Virtual Keyboard “-Plugin erstellt wird.

Das Projekt ist in folgende Teilprojekte unterteilt:

Konfigurationsoptionen

Die folgende Tabelle enthält die übergeordneten Optionen zur Konfiguration der Funktionen der virtuellen Tastatur. Diese Optionen werden an das Konfigurationswerkzeug übergeben.

Hunspell-Integration

Standardmäßig ist „HunspellInputMethod“ nur verfügbar, wenn die Hunspell-Bibliothek und die Entwicklungs-Header vorhanden sind. Für Linux/X11-Ziele kann die Hunspell-Bibliothek durch die Installation des Pakets „libhunspell-dev“ bereitgestellt werden. Alternativ kann das Hunspell-Git-Repository in das Verzeichnis ` src/plugins/hunspell/3rdparty/hunspell ` geklont werden. Die Quellen werden automatisch von qmake erkannt, und das Projekt wird so konfiguriert, dass es das lokale Hunspell verwendet. Wenn Hunspell-Quellcode verwendet wird, müssen auch die Wörterbuchdateien in das Verzeichnis ` src/plugins/hunspell/3rdparty/hunspell/data ` kopiert werden.

Ein Beispiel dafür, wie die Verzeichnisstruktur nach dem Einrichten der Hunspell-Quelldateien und Wörterbuchdateien aussehen sollte, ist unten aufgeführt:

3rdparty
└── hunspell
    ├── data
    │   ├── en_GB.aff
    │   └── en_GB.dic
    ├── hunspell <-- Hunspell git repository
    └── CMakeLists.txt

Cerence-Handschrifterkennung

Die Cerence-Handschrift-Integration unterstützt die Engines „Alphabetic“ und „CJK“ (Chinesisch, Japanisch, Koreanisch). Beide Engines werden über T9WriteInputMethod integriert. Die Eingabemethode wird jeweils mit einer Engine initialisiert. Die Auswahl der Engine erfolgt automatisch basierend auf der aktuellen Eingabe-Locale.

Kompatibilität von Cerence Handwriting

Qt Virtual Keyboard ist kompatibel mit Cerence Handwriting v8.7 oder höher.

Vorbereitungen für den Build von Cerence Handwriting

Der Inhalt des SDK muss mit dem Skript „unpack.py“ im Verzeichnis „cerence“ entpackt werden. Dadurch wird sichergestellt, dass die Verzeichnisstruktur korrekt ist, damit CMake den Inhalt finden kann.

$ cd src/plugins/cerence/
$ python unpack.py filename.zip

Dadurch werden die Inhalte in das Verzeichnis „src/plugins/cerence/sdk“ entpackt, wo CMake sie automatisch erkennen kann.

Alternativ können Sie die Entpackung in ein beliebiges anderes Verzeichnis durchführen, indem Sie der Befehlszeile einen zusätzlichen Parameter hinzufügen. In diesem Fall muss der Pfad zum SDK an das Skript „configure“ übergeben werden.

configure ... -vkb-cerence-sdk /path/to/cerence/sdk

Aufbau des Cerence-SDK

Der entpackte Inhalt des SDK sieht wie folgt aus:

sdk
├───t9write
│   ├───api
│   ├───data
│   │   ├───arabic
│   │   ├───hebrew
│   │   └───thai
│   └───lib
│       ├───linux
│       │   ├───arm64
│       │   │   ├───shared
│       │   │   │   ├───alphabetic
│       │   │   │   └───cjk
│       │   │   └───static
│       │   │       ├───alphabetic
│       │   │       └───cjk
│       │   └───x86_64
│       │       ├───shared
│       │       │   ├───alphabetic
│       │       │   └───cjk
│       │       └───static
│       │           ├───alphabetic
│       │           └───cjk
│       └───win32
│           ├───x86
│           │   ├───shared
│           │   │   ├───alphabetic
│           │   │   └───cjk
│           │   └───static
│           │       ├───alphabetic
│           │       └───cjk
│           └───x86_64
│               ├───shared
│               │   ├───alphabetic
│               │   └───cjk
│               └───static
│                   ├───alphabetic
│                   └───cjk
└───xt9
    ├───api
    ├───data
    └───lib
        ├───linux
        │   ├───arm64
        │   │   ├───shared
        │   │   └───static
        │   └───x86_64
        │       ├───shared
        │       └───static
        └───win32
            ├───x86
            │   ├───shared
            │   └───static
            └───x86_64
                ├───shared
                └───static

Die Inhalte der einzelnen Verzeichnisse sind wie folgt:

Der Integrationscode für Cerence Handwriting und XT9 wird automatisch aktiviert, sobald das Cerence SDK erkannt wird.

Alle anderen Erweiterungen sollten vor dem Erstellen der Cerence-Erweiterungen aus dem Verzeichnis [qtbase]/plugins/virtualkeyboard entfernt werden, um Konflikte zur Laufzeit zu vermeiden. Die Cerence-Erweiterungen benötigen keine weiteren Plugins für die virtuelle Tastatur, um zu funktionieren.

Handschrifterkennungsdatenbanken und Sprachdatenbanken für XT9 werden im Verzeichnis [qtbase]/qtvirtualkeyboard/cerence installiert. Darüber hinaus gibt es zwei weitere Möglichkeiten, diese Dateien zu finden:

• Ein benutzerdefinierter Laufzeitspeicherort, der über Umgebungsvariablen festgelegt wird
• Die Befehlszeilenoption -vkb-bundle-cerence zum Einbetten von Ressourcen in die Plugin-Binärdateien

Integration des MyScript Text SDK

MyScript Text wurde für die Entwicklung von Anwendungen konzipiert, die die Erkennung von handgeschriebenem Text ermöglichen. MyScript Text unterstützt die Erkennung von Einzelzeichen, Kursivschrift, Druckschrift und übereinander geschriebener Schrift. Die MyScript-Funktion für übereinander geschriebene Schrift ist in „ Qt Virtual Keyboard “ integriert. Sie ermöglicht die Erkennung von Buchstaben, Wörtern oder Wortteilen, die übereinander geschrieben wurden, ohne dass eine explizite Trennung zwischen aufeinanderfolgenden Fragmenten erforderlich ist. Sie kann auf Geräten mit begrenztem Arbeitsspeicher und begrenzter Rechenleistung ausgeführt werden.

Handschriftstile für die Eingabe mit dem MyScript Text SDK

Der Endbenutzer kann ein Wortfragment über ein anderes oder ein Zeichen über ein anderes schreiben, wie unten dargestellt. Der Abstand zwischen zwei geschriebenen Wörtern wird automatisch eingefügt, sodass keine explizite Geste erforderlich ist.

Sprachunterstützung des MyScript Text SDK

MyScript Superimposed unterstützt 72 Sprachen.

Installation der MyScript Text SDK-Pakete

Das MyScript-Lieferteam kann Ihnen die Pakete in verschiedenen „ .zip “-Archiven zur Verfügung stellen. Um auf den gesamten Code, die Tools und die Ressourcen zuzugreifen, die Sie zum Erstellen Ihrer eigenen Handschrifterkennunganwendung benötigen, entpacken Sie alle Pakete in denselben Zielordner wie „ src/plugins/myscript/sdk “, wo CMake sie automatisch erkennen kann.

Alternativ können Sie die Pakete auch in ein beliebiges anderes Verzeichnis entpacken. In diesem Fall muss der Speicherort des SDK an das Konfigurationsskript übergeben werden.

configure ... -vkb-myscript-sdk /path/to/myscript/sdk

Die Dateihierarchie sollte wie folgt aussehen:

myscript
└── sdk
    ├─── conf
    ├─── doc
    ├─── edk
    ├─── engine
    │   └─── bin
    │       ├─── lin-arm64
    │       │   └─── *.so
    │       ├─── lin-armv7
    │       │   └─── *.so
    │       ├─── lin-armv7hf
    │       │   └─── *.so
    │       ├─── lin-x64
    │       │   └─── *.so
    │       ├─── lin-x86
    │       │   └─── *.so
    │       ├─── win-x64
    │       │   └─── *.dll
    │       ├─── win-x86
    │       │   └─── *.dll
    │       (etc.)
    ├─── rdk
    ├─── resources
    │   ├─── ar
    │   │   └─── *.res
    │   ├─── en_GB
    │   │   └─── *.res
    │   ├─── ja_JP
    │   │   └─── *.res
    │   ├─── ko_KR
    │   │   └─── *.res
    │   ├─── zh_CN
    │   │   └─── *.res
    │   (etc.)
    ├─── tools
    └─── voim
        ├─── api
        ├─── bin
        │   ├─── lin-arm64
        │   │   └─── *.so
        │   ├─── lin-armv7
        │   │   └─── *.so
        │   ├─── lin-armv7hf
        │   │   └─── *.so
        │   ├─── lin-x64
        │   │   └─── *.so
        │   ├─── lin-x86
        │   │   └─── *.so
        │   ├─── win-x64
        │   │   └─── *.dll
        │   ├─── win-x86
        │   │   └─── *.dll
        │   (etc.)
        └─── conf

Die Beschreibung des Inhalts der einzelnen Verzeichnisse lautet wie folgt:

Einrichten des Zertifikats für das MyScript Text SDK

Für die Nutzung des MyScript Text SDK ist ein gültiges Zertifikat zwingend erforderlich. Dies ist eine Sicherheitsmaßnahme, die Sie eindeutig als legitimen Kunden von MyScript-Technologien identifiziert. Das Zertifikat hilft MyScript dabei, die Identität der Kunden und die gekauften Produkte nachzuverfolgen.

Das Zertifikat wird im „ [your_login].vo.zip package “ bereitgestellt. Wenn Sie dieses Paket entpacken, wird das Zertifikat automatisch an den entsprechenden Speicherort kopiert. Dadurch wird sichergestellt, dass das Zertifikat sofort in den bereitgestellten Diensten und Code-Beispielen funktioniert.

So erstellen Sie „ Qt Virtual Keyboard “ mit dem MyScript Text SDK

Der MyScript-Integrationscode wird automatisch aktiviert, sobald das MyScript Text SDK erkannt wird.

Sprachressourcen für das MyScript Text SDK werden im Verzeichnis [qtbase]/qtvirtualkeyboard/myscript installiert.

Statische Kompilierungen

Das Qt Virtual Keyboard kann statisch kompiliert und mit der Anwendung verknüpft werden. Dies setzt voraus, dass Qt ebenfalls statisch kompiliert wird (unter Verwendung der Option -static in der Befehlszeile von configure).