> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Native-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel

> Beschreibt, wie Sie im Native-Modus von VOICEVOX für Laravel VOICEVOX CORE direkt über PHP-FFI aufrufen und Text-Sprachsynthese durchführen.

## Was ist der Native-Modus?

Der Native-Modus ruft VOICEVOX CORE über [VOICEVOX Core für PHP](/de/packages/voicevox-core-php) direkt über PHP-FFI auf.

Sie können synthetisieren, ohne die offizielle Engine zu starten, doch FFI und lokale Bibliothek müssen eingerichtet sein.

<Warning>
  Der Native-Modus ist nicht für Webserver gedacht. Verwenden Sie ihn in lokalen CLI-Umgebungen. Die Einschränkungen von FFI sind unter [PHP FFI](/de/advanced/ffi) erläutert.
</Warning>

## Vorbereitung

1. [Installation und Konfiguration](/de/packages/laravel-voicevox/installation) ist abgeschlossen.
2. Die Einrichtung von [VOICEVOX Core für PHP](/de/packages/voicevox-core-php) ist abgeschlossen.
3. In `.env` ist `VOICEVOX_CORE_PATH` gesetzt.

```dotenv theme={null}
VOICEVOX_CORE_PATH=/path/to/voicevox_core/
```

## Grundlegende Verwendung

Im Native-Modus wird der `talk()`-Helper verwendet.

```php theme={null}
use function Revolution\Voicevox\talk;

$response = talk('ネイティブ版なのだ', id: 1)
    ->generate(id: 1);

$response->storeAs('native', 'talk.wav');
```

## Angabe der Style-ID

Für `id` geben Sie eine Style-ID an, die in der geladenen `.vvm` enthalten ist.

```php theme={null}
use function Revolution\Voicevox\talk;

$response = talk('ずんだもんなのだ', id: 1)
    ->generate(id: 1);
```

Es können nur die Modelle verwendet werden, die in `core.vvms` in `config/voicevox.php` enthalten sind.

## Audio-Query mit `tap()` anpassen

Die Verwendung von `tap()` ist im Native-Modus identisch. Beachten Sie jedoch, dass `TalkAudioQuery` eine andere Klasse als im Client-Modus ist.

```php theme={null}
use Revolution\Voicevox\Talk\TalkAudioQuery;
use function Revolution\Voicevox\talk;

$response = talk('速めに話すのだ', id: 1)
    ->tap(function (TalkAudioQuery $talk) {
        $talk->audioQuery['speedScale'] = 1.2;
        $talk->audioQuery['pitchScale'] = 0.05;
        $talk->audioQuery['intonationScale'] = 1.5;
        $talk->audioQuery['volumeScale'] = 1.0;
    })
    ->generate(id: 1);
```

<Info>
  Das Muster von `tap()` selbst ist unter [tap()-Helper und Tappable-Trait](/de/advanced/tap) beschrieben. VOICEVOX für Laravel ist ein praktisches Beispiel dafür.
</Info>

## Kana in AquesTalk-ähnlicher Notation verwenden

Da im Native-Modus `enable_katakana_english` fehlt, eignet er sich nicht dafür, englisch-vermischten Input direkt zu lesen.

Stattdessen können Sie mit `kana()` Kana in AquesTalk-ähnlicher Notation direkt übergeben.

```php theme={null}
use function Revolution\Voicevox\kana;

$response = kana("ネイティブ'バンナ/ノダ'", id: 1)
    ->generate(id: 1);

$response->storeAs('native', 'kana.wav');
```

## Unterschiede zum Client-Modus

| Aspekt                                        | Client Talk        | Native Talk        |
| --------------------------------------------- | ------------------ | ------------------ |
| Engine-Start                                  | Erforderlich       | Nicht erforderlich |
| FFI                                           | Nicht erforderlich | Erforderlich       |
| Automatische Katakana-Umwandlung von Englisch | Vorhanden          | Nicht vorhanden    |
| API-Einstieg                                  | `Voicevox::talk()` | `talk()`           |

## Nächste Seiten

<Columns cols={2}>
  <Card title="Native Song" href="/de/packages/laravel-voicevox/native-song" icon="music">
    Das Gesangsmodell über FFI nutzen.
  </Card>

  <Card title="VOICEVOX Core für PHP" href="/de/packages/voicevox-core-php" icon="library">
    Einrichtung und Einschränkungen des reinen PHP-Wrappers.
  </Card>
</Columns>


## Related topics

- [Client-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/client-talk.md)
- [Engine-API-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/engine-talk.md)
- [Native-Modus - Presets - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-presets.md)
- [Native-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-song.md)
- [Engine-API-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/engine-song.md)