> ## Documentation Index > Fetch the complete documentation index at: https://kawax.biz/llms.txt > Use this file to discover all available pages before exploring further. # Client-Modus - Benutzerwörterbuch - VOICEVOX für Laravel > Beschreibt, wie Sie im Client-Modus von VOICEVOX für Laravel das Benutzerwörterbuch der offiziellen Engine verwalten und die Aussprache von Eigennamen und Fachbegriffen registrieren. Mit dem Benutzerwörterbuch können Sie die Aussprache von Eigennamen und Fachbegriffen in der offiziellen VOICEVOX-Engine registrieren. Im Client-Modus wird das Wörterbuch nicht auf Laravel-Seite gespeichert, sondern die Wörterbuch-API der verbundenen offiziellen Engine wird direkt verwendet. ## Übersicht Das Benutzerwörterbuch im Client-Modus wird über die `Voicevox`-Facade verwaltet. Intern werden HTTP-Requests an die Endpunkte `/user_dict`, `/user_dict_word` und `/import_user_dict` der offiziellen VOICEVOX-Engine gesendet. Die Wörterbuchdaten der offiziellen Engine werden je nach Betriebssystem im Benutzerbereich gespeichert. In der macOS-Build-Version der VOICEVOX-Anwendung (Produktversion) ist der übliche Speicherort: ```text theme={null} ~/Library/Application Support/voicevox-engine/user_dict.json ``` Auch wenn Sie die offizielle Engine über Docker starten, wird sie im Benutzerbereich innerhalb des Containers gespeichert. Solange derselbe Container weiterverwendet wird, bleiben die Daten auch nach einem Neustart erhalten. Wenn Sie jedoch mit `docker run --rm` jedes Mal einen temporären Container erstellen, geht das Wörterbuch beim Beenden verloren. Um das Wörterbuch zuverlässig persistent zu speichern, mounten Sie den Benutzerbereich des Containers über ein Docker-Volume. Es handelt sich um eine separate Verwaltung vom Native-Modus mit `storage/voicevox/user_dict.json`. `config('voicevox.core.user_dict')` auf Laravel-Seite wird im Client-Modus nicht verwendet. ## Vorbereitung Starten Sie die offizielle VOICEVOX-Engine. ```shell theme={null} docker pull voicevox/voicevox_engine:cpu-latest docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest ``` Das Verbindungsziel können Sie über `VOICEVOX_URL` ändern. ```env theme={null} VOICEVOX_URL=http://127.0.0.1:50021 ``` ## Grundlegende Verwendung ### Wort hinzufügen Sie können mit `Voicevox::addWord()` ein Wort registrieren. ```php theme={null} use Revolution\Voicevox\Voicevox; $uuid = Voicevox::addWord( surface: 'Laravel', pronunciation: 'ララベル', accentType: 0, ); // Im Client-Modus wird eine UUID mit "-" zurückgegeben // Beispiel: "a1b2c3d4-0000-0000-0000-000000000000" ``` #### Parameter | Parameter | Typ | Beschreibung | | --------------- | ------------ | --------------------------------------------------------------------- | | `surface` | string | Schreibweise (der tatsächliche Wort-String) | | `pronunciation` | string | Aussprache (nur Katakana) | | `accentType` | int | Akzenttyp (0 = flach, 1 oder mehr = Akzentposition) | | `wordType` | string\|null | Wortart (`COMMON_NOUN`, `PROPER_NOUN`, `VERB`, `ADJECTIVE`, `SUFFIX`) | | `priority` | int\|null | Priorität | ### Alle Wörter abrufen Sie können alle registrierten Wörter abrufen. ```php theme={null} use Revolution\Voicevox\Voicevox; $words = Voicevox::userDict(); /* [ "a1b2c3d4-0000-0000-0000-000000000000" => [ "surface" => "Laravel", "pronunciation" => "ララベル", "accent_type" => 0, "word_type" => "COMMON_NOUN", "priority" => 5, ], ... ] */ ``` ### Wort aktualisieren Geben Sie die beim Hinzufügen zurückgegebene UUID an, um zu aktualisieren. ```php theme={null} use Revolution\Voicevox\Voicevox; Voicevox::updateWord( wordUuid: 'a1b2c3d4-0000-0000-0000-000000000000', surface: 'Laravel', pronunciation: 'ラレベル', accentType: 1, ); ``` ### Wort löschen ```php theme={null} use Revolution\Voicevox\Voicevox; Voicevox::deleteWord('a1b2c3d4-0000-0000-0000-000000000000'); ``` ### Wörterbuch importieren Sie können Arrays im Benutzerwörterbuchformat der offiziellen Engine importieren. Bei `override: false` (Standard) bleiben bestehende Wörter erhalten und die importierten werden hinzugefügt. ```php theme={null} use Revolution\Voicevox\Voicevox; $words = json_decode(file_get_contents('other_user_dict.json'), true); Voicevox::importUserDict($words, override: false); // Bei override: true wird das bestehende Wörterbuch ersetzt Voicevox::importUserDict($words, override: true); ``` Wenn Sie das Wörterbuch exportieren möchten, speichern Sie das Ergebnis von `Voicevox::userDict()` als JSON. ```php theme={null} $json = json_encode(Voicevox::userDict(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE); file_put_contents('exported_user_dict.json', $json); ``` ## Sprachsynthese nach der Wörterbuchregistrierung Wörter, die im Benutzerwörterbuch registriert sind, werden bei der Sprachsynthese durch die offizielle Engine automatisch berücksichtigt. ```php theme={null} use Revolution\Voicevox\Voicevox; Voicevox::addWord( surface: 'Laravel', pronunciation: 'ララベル', accentType: 0, ); $response = Voicevox::talk('Laravelで開発するのは楽しいです', id: 1)->generate(id: 1); $response->storeAs('client', 'laravel.wav'); ``` ## Zuordnung zur Engine-API Die Methoden der `Voicevox`-Facade entsprechen den APIs der offiziellen Engine. | Laravel | Offizielle Engine-API | | ---------------------------- | ------------------------------------ | | `Voicevox::userDict()` | `GET /user_dict` | | `Voicevox::addWord()` | `POST /user_dict_word` | | `Voicevox::updateWord()` | `PUT /user_dict_word/{word_uuid}` | | `Voicevox::deleteWord()` | `DELETE /user_dict_word/{word_uuid}` | | `Voicevox::importUserDict()` | `POST /import_user_dict` | ## Unterschiede zum Native-Modus | Aspekt | Client-Modus | Native-Modus | | -------------------- | -------------------------------------------------------------- | --------------------------------------------- | | Nutzung | `Voicevox`-Facade | `dict()`-Helper | | Speicherort | Benutzerbereich der offiziellen Engine | `storage/voicevox/user_dict.json` von Laravel | | Beispiel unter macOS | `~/Library/Application Support/voicevox-engine/user_dict.json` | `storage/voicevox/user_dict.json` | | UUID beim Hinzufügen | Mit `-` | Von Core ohne `-` | | Engine-Prozess | Erforderlich | Nicht erforderlich (FFI erforderlich) | ## Hinweise Geben Sie `pronunciation` in Katakana an. Hiragana oder Kanji sind nicht zulässig. * Im Client-Modus wird das Wörterbuch auf der Seite der offiziellen Engine aktualisiert. Es wird nicht im `storage` des Laravel-Projekts gespeichert. * Bei temporären Containern (z. B. `docker run --rm`) geht das Wörterbuch beim Beenden des Containers verloren. * Die beim Hinzufügen zurückgegebene UUID hat das Format mit Bindestrich wie `a1b2c3d4-0000-0000-0000-000000000000`. ## Fehlerbehebung ### Wörter werden nicht übernommen 1. Prüfen Sie, ob die offizielle VOICEVOX-Engine läuft. 2. Prüfen Sie, ob `VOICEVOX_URL` auf das richtige Ziel zeigt. 3. Prüfen Sie, ob die Aussprache in Katakana geschrieben ist. 4. Prüfen Sie, ob Sie in Docker nicht einen anderen Container neu gestartet haben. ### Der Speicherort der Wörterbuchdatei ist unklar In der macOS-Build-Version prüfen Sie folgenden Ort. ```text theme={null} ~/Library/Application Support/voicevox-engine/user_dict.json ``` In Docker wird sie im Benutzerbereich der offiziellen Engine (innerhalb des Containers) gespeichert. Wenn Persistenz erforderlich ist, mounten Sie den Benutzerbereich des Containers als Docker-Volume. ## Related topics - [Native-Modus - Benutzerwörterbuch - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-user-dict.md) - [Client-Modus - Presets - VOICEVOX für Laravel](/de/packages/laravel-voicevox/client-presets.md) - [Client-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/client-song.md) - [Client-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/client-talk.md) - [Native-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-song.md)