Vai al contenuto principale

Cos’è la modalità nativa

La modalità nativa chiama VOICEVOX CORE direttamente tramite PHP FFI, passando per VOICEVOX Core for PHP. Puoi sintetizzare senza avviare l’engine ufficiale, ma occorre configurare FFI e la libreria locale.
La modalità nativa non è pensata per server Web. Utilizzala tramite CLI locale. I vincoli di FFI sono descritti anche in PHP FFI.

Preparazione

  1. Aver completato Installazione e configurazione
  2. Aver completato la configurazione di VOICEVOX Core for PHP
  3. Aver impostato VOICEVOX_CORE_PATH nel .env

Uso di base

In modalità nativa si usa l’helper talk().

Specificare l’ID di stile

In id specifica l’ID di stile contenuto in un .vvm già caricato.
Puoi usare solo i modelli contenuti in core.vvms di config/voicevox.php.

Regolare l’Audio Query con tap()

Anche in modalità nativa l’uso di tap() è lo stesso. Attenzione però: TalkAudioQuery è una classe diversa da quella della modalità client.
Il pattern tap() in sé è raccolto in Helper tap() e trait Tappable. VOICEVOX for Laravel ne è un esempio pratico.

Usare i kana in notazione stile AquesTalk

La modalità nativa non dispone di enable_katakana_english, quindi non è adatta a leggere input contenenti inglese così come sono. Al suo posto puoi usare kana() che riceve direttamente i kana in notazione stile AquesTalk.

Sintesi vocale in streaming

stream() segue la stessa specifica di /streaming_synthesis di VOICEVOX Engine 0.26.0 e restituisce un TalkStream che emette il WAV in ordine dall’inizio. Sono supportati solo gli stili di tipo streaming_talk (formato VVM v2).
Se startOffset è maggiore o uguale alla durata dell’audio, stream() lancia una InvalidArgumentException. Internamente esegue il rendering dell’AudioFeature di VOICEVOX Core segmento per segmento. Per i dettagli, consulta Uso di VOICEVOX Core for PHP.

Differenze con la modalità client

Pagine successive da leggere

Native Song

Gestisci i modelli di canto tramite FFI.

VOICEVOX Core for PHP

Consulta la configurazione e i vincoli del wrapper PHP puro.
Ultima modifica il 2 novembre 2026