Gebäude Qt Virtual Keyboard

Übersicht

Dieses Dokument beschreibt, wie man das Qt Virtual Keyboard Plugin erstellt.

Das Projekt ist in die folgenden Unterprojekte aufgeteilt:

Konfigurationsoptionen

Die folgende Tabelle enthält die wichtigsten Optionen für die 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 Entwicklungsheader gefunden werden. 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-Quellen verwendet werden, 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-Quellen und der Wörterbuchdateien aussehen sollte, ist unten aufgeführt:

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

Cerence Handwriting-Integration

Die Cerence Handwriting Integration unterstützt die Alphabetic und CJK (Chinese Japanese Korean) Engines. Beide Engines werden über T9WriteInputMethod integriert. Die Eingabemethode wird jeweils mit einer Engine initialisiert. Die Auswahl der Engine erfolgt automatisch auf der Grundlage des aktuellen Eingabegebietsschemas.

Cerence Handwriting Kompatibilität

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

Cerence Handwriting Build-Vorbereitungen

Der Inhalt des SDK muss mit Hilfe des Skripts unpack.py entpackt werden, das sich im cerence-Verzeichnis befindet. Dadurch wird die korrekte Verzeichnisstruktur sichergestellt, damit CMake den Inhalt finden kann.

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

Dadurch wird der Inhalt in das Verzeichnis src/plugins/cerence/sdk entpackt, wo CMake ihn automatisch auffinden kann.

Alternativ können Sie auch in ein beliebiges anderes Verzeichnis entpacken, indem Sie einen zusätzlichen Parameter in der Befehlszeile angeben. In diesem Fall muss der Speicherort des SDKs an das configure-Skript übergeben werden.

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

Aufbau des Cerence SDK

Der entpackte Inhalt des SDKs 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

Wo die Inhalte der einzelnen Verzeichnisse sind:

Der Cerence Handwriting- und XT9-Integrationscode wird automatisch aktiviert, wenn das Cerence SDK erkannt wird.

Alle anderen Erweiterungen sollten aus dem Verzeichnis [qtbase]/plugins/virtualkeyboard entfernt werden, bevor die Cerence-Erweiterungen erstellt werden, um ein widersprüchliches Verhalten zur Laufzeit zu vermeiden. Die Cerence-Erweiterungen benötigen keine anderen virtuellen Tastatur-Plugins, um zu funktionieren.

Handschriftdatenbanken und Sprachdatenbanken für XT9 werden im Verzeichnis [qtbase]/qtvirtualkeyboard/cerence installiert. Darüber hinaus gibt es zwei weitere Alternativen für das Auffinden dieser Dateien:

• Ein benutzerdefinierter Speicherort zur Laufzeit, der durch Umgebungsvariablen definiert wird
• Die Befehlszeilenoption -vkb-bundle-cerence zum Einbetten von Ressourcen in die Plugin-Binärdateien

MyScript Text SDK-Integration

MyScript Text wurde für die Erstellung von Anwendungen entwickelt, die die Erkennung von handgeschriebenem Text ermöglichen. MyScript Text unterstützt die Erkennung von isolierten Zeichen, kursiver Schrift, Druckschrift und überlagerter Schrift. MyScript Superimposed Writing ist in Qt Virtual Keyboard integriert. Es ermöglicht die Erkennung von Buchstaben, Wörtern oder Wortteilen, die übereinander geschrieben werden, ohne dass eine explizite Trennung zwischen aufeinanderfolgenden Fragmenten erfolgt. Es ist in der Lage, auf Geräten mit begrenztem Speicher und begrenzter CPU zu laufen.

Eingabe-Handschriftstile von MyScript Text SDK

Der Endbenutzer kann ein Wortfragment über ein anderes oder ein Zeichen über ein anderes schreiben, wie unten dargestellt. Leerzeichen zwischen zwei geschriebenen Wörtern werden automatisch hinzugefügt, so dass keine explizite Geste erforderlich ist.

Sprachabdeckung von MyScript Text SDK

MyScript Superimposed unterstützt 72 Sprachen.

MyScript Text SDK-Pakete Installation

Das MyScript-Lieferungsteam kann Ihnen die Pakete mit verschiedenen .zip Archiven zur Verfügung stellen. Um auf den gesamten Code, die Tools und die Ressourcen zuzugreifen, die Sie für die Erstellung Ihrer eigenen Handschriftanwendung benötigen, extrahieren Sie alle Pakete in denselben Zielordner wie src/plugins/myscript/sdk, wo CMake sie automatisch aufnimmt.

Alternativ können Sie die Pakete auch in ein beliebiges anderes Verzeichnis entpacken. In diesem Fall muss der Ort des SDKs an das configure-Skript übergeben werden.

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

Die Dateihierarchie sollte wie unten dargestellt 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 für den Inhalt der einzelnen Verzeichnisse sind:

Einstellen des Zertifikats von MyScript Text SDK

Für die Verwendung des MyScript Text SDK ist ein gültiges Zertifikat 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 nachzuvollziehen.

Das Zertifikat wird im Paket [your_login].vo.zip package geliefert. Wenn Sie dieses Paket entpacken, wird das Zertifikat automatisch an der entsprechenden Stelle abgelegt. Dadurch wird sichergestellt, dass das Zertifikat sofort mit den Services und Codebeispielen funktioniert, die Sie erhalten haben.

So erstellen Sie Qt Virtual Keyboard mit MyScript Text SDK

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

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

Statische Builds

Die virtuelle Tastatur kann statisch gebaut und mit der Anwendung verknüpft werden. Dies impliziert, dass Qt ebenfalls statisch gebaut wird (mit der Option -static in der Befehlszeile von configure).