Skip to main content

在 Native 模式讓角色歌唱

Native 模式的歌聲合成使用 PHP FFI 直接呼叫 VOICEVOX CORE。 ScoreNote 的組合方式與 Client 模式相同。

事前準備

  1. 已完成 安裝與設定
  2. 已完成 VOICEVOX Core for PHP 的設定
  3. 已於 .env 設定 VOICEVOX_CORE_PATH
為使用歌聲模型,請確認 config/voicevox.phpcore.vvms 中包含 s0.vvm

建立 ScoreNote

基本用法

使用相同 Score,可在 Client 模式與 Native 模式共用相同譜面。

tap() 重新同步 F0 與音量

Native Song 中 tap() 一樣好用。可以調整 SongAudioQuery 後直接串接到 generate()
若要分別更新 F0 與音量,請務必依以下順序執行。

與 Client 模式的差異

FFI 機制請參閱 PHP FFI;核心 library 單獨的流程請參閱 VOICEVOX Core for PHP 用法

下一步閱讀

Score 與 Note 詳解

確認 Song 譜面資料的實務管理方式。

Client Song

與 HTTP client 版比較差異。

VOICEVOX for Laravel 概觀

集中確認各模式與相關頁面。
最後修改於 2026年8月2日