> ## 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 (tekst-naar-spraak) - VOICEVOX for Laravel

> Uitleg over tekst-naar-spraaksynthese in de native modus van VOICEVOX for Laravel door VOICEVOX CORE rechtstreeks via PHP FFI aan te roepen.

## Wat is de native modus

In de native modus roep je VOICEVOX CORE rechtstreeks aan via PHP FFI, via [VOICEVOX Core for PHP](/nl/packages/voicevox-core-php).

Je kunt synthetiseren zonder de officiële engine te starten, maar je moet wel FFI en de lokale bibliotheek opzetten.

<Warning>
  De native modus is niet bedoeld voor webservers. Gebruik hem in een lokale CLI. De beperkingen van FFI worden ook uitgelegd in [PHP FFI](/nl/advanced/ffi).
</Warning>

## Voorbereiding

1. Je hebt [Installatie en configuratie](/nl/packages/laravel-voicevox/installation) afgerond
2. Je hebt de setup van [VOICEVOX Core for PHP](/nl/packages/voicevox-core-php) afgerond
3. Je hebt `VOICEVOX_CORE_PATH` ingesteld in `.env`

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

## Basisgebruik

In de native modus gebruik je de `talk()`-helper.

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

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

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

## Een stijl-ID opgeven

Bij `id` geef je een stijl-ID op dat voorkomt in de geladen `.vvm`.

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

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

Alleen modellen die zijn opgenomen in `core.vvms` in `config/voicevox.php` zijn bruikbaar.

## De Audio Query aanpassen met `tap()`

Ook in de native modus gebruik je `tap()` op dezelfde manier. Let wel: `TalkAudioQuery` is een andere klasse dan in de clientmodus.

```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>
  Het `tap()`-patroon zelf wordt behandeld in [De tap()-helper en de Tappable-trait](/nl/advanced/tap). VOICEVOX for Laravel is daarvan een praktijkvoorbeeld.
</Info>

## Kana in AquesTalk-achtige notatie gebruiken

Omdat de native modus geen `enable_katakana_english` heeft, is hij niet geschikt om invoer met Engels erin direct voor te lezen.

In plaats daarvan kun je `kana()` gebruiken, waarmee je kana in AquesTalk-achtige notatie direct doorgeeft.

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

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

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

## Verschillen met de clientmodus

| Onderdeel                                  | Client Talk        | Native Talk |
| ------------------------------------------ | ------------------ | ----------- |
| Engine starten                             | Nodig              | Niet nodig  |
| FFI                                        | Niet nodig         | Nodig       |
| Automatische katakana-conversie van Engels | Ja                 | Nee         |
| API-ingang                                 | `Voicevox::talk()` | `talk()`    |

## Volgende pagina's

<Columns cols={2}>
  <Card title="Native Song" href="/nl/packages/laravel-voicevox/native-song" icon="music">
    Werk met zangmodellen via FFI.
  </Card>

  <Card title="VOICEVOX Core for PHP" href="/nl/packages/voicevox-core-php" icon="library">
    Bekijk de setup en beperkingen van de pure PHP-wrapper.
  </Card>
</Columns>


## Related topics

- [Engine-API-modus: talk (tekst-naar-spraak) - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/engine-talk.md)
- [Clientmodus: talk (tekst-naar-spraak) - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/client-talk.md)
- [VOICEVOX for Laravel](/nl/packages/laravel-voicevox/index.md)
- [Installatie en configuratie - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/installation.md)
- [Engine-API-modus: song (zangsynthese) - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/engine-song.md)