Skip to main content

什麼是 Native 模式

Native 模式透過 VOICEVOX Core for PHP 從 PHP FFI 直接呼叫 VOICEVOX CORE。 不需啟動官方引擎即可合成,但需要 FFI 與本機 library 的設定。
Native 模式不適合 Web 伺服器。請於本機 CLI 使用。FFI 的限制也在 PHP FFI 中說明。

事前準備

  1. 已完成 安裝與設定
  2. 已完成 VOICEVOX Core for PHP 的設定
  3. 已於 .env 設定 VOICEVOX_CORE_PATH

基本用法

在 Native 模式使用 talk() helper。

Style ID 指定

id 請指定已載入 .vvm 中所包含的 style ID。
只可使用 config/voicevox.phpcore.vvms 中所包含的模型。

使用 tap() 調整 Audio Query

Native 模式的 tap() 用法相同。但 TalkAudioQuery 與 Client 模式為不同類別。
tap() 模式本身整理於 tap() helper 與 Tappable trait。VOICEVOX for Laravel 是其實踐範例。

使用 AquesTalk 風格記法的假名

Native 模式沒有 enable_katakana_english,不適合直接朗讀含英文的輸入。 可改用直接傳入 AquesTalk 風格記法假名的 kana()

與 Client 模式的差異

下一步閱讀

Native Song

透過 FFI 處理歌聲模型。

VOICEVOX Core for PHP

確認 Pure PHP wrapper 端的設定與限制。
最後修改於 2026年8月2日