Skip to main content

Wat is de native modus

In de native modus roep je VOICEVOX CORE rechtstreeks aan via PHP FFI, via VOICEVOX Core for PHP. Je kunt synthetiseren zonder de officiële engine te starten, maar je moet wel FFI en de lokale bibliotheek opzetten.
De native modus is niet bedoeld voor webservers. Gebruik hem in een lokale CLI. De beperkingen van FFI worden ook uitgelegd in PHP FFI.

Voorbereiding

  1. Je hebt Installatie en configuratie afgerond
  2. Je hebt de setup van VOICEVOX Core for PHP afgerond
  3. Je hebt VOICEVOX_CORE_PATH ingesteld in .env

Basisgebruik

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

Een stijl-ID opgeven

Bij id geef je een stijl-ID op dat voorkomt in de geladen .vvm.
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.
Het tap()-patroon zelf wordt behandeld in De tap()-helper en de Tappable-trait. VOICEVOX for Laravel is daarvan een praktijkvoorbeeld.

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.

Verschillen met de clientmodus

Volgende pagina’s

Native Song

Werk met zangmodellen via FFI.

VOICEVOX Core for PHP

Bekijk de setup en beperkingen van de pure PHP-wrapper.
Laatst gewijzigd op 6 september 2026