什麼是使用者字典
使用使用者字典可讓 VOICEVOX 記住專有名詞或專業術語的讀音。登記的詞彙會在語音合成時以正確發音朗讀。概觀
Laravel VOICEVOX 的使用者字典功能是使用 VOICEVOX Core 的 UserDict 實作的 Native 實作。字典資料以 JSON 格式持久化於storage/voicevox/user_dict.json。
由於使用與官方 VOICEVOX 引擎獨立的儲存,Laravel 端登記的詞彙不會反映到官方引擎端(反向亦然)。
設定
預設會儲存於storage/voicevox/user_dict.json。若要使用其他路徑,可於 config/voicevox.php 變更。
基本用法
新增詞彙
以dict() helper 的 add() 登記詞彙。
參數
surface(必填): 表記pronunciation(必填): 讀音(僅片假名)accentType(必填): 重音型別(0= 平板,1以上 = 重音位置)wordType(選填): 詞性(COMMON_NOUN、PROPER_NOUN、VERB、ADJECTIVE、SUFFIX)priority(選填): 優先度(預設5)
重音型別
0: 平板重音1: 第一拍2: 第二拍3: 第三拍
更新詞彙
刪除詞彙
取得所有詞彙
匯入字典
匯出字典
透過 Engine API 存取
若有啟動 Laravel VOICEVOX 的 Engine API,也可透過 HTTP 操作使用者字典。不會 fallback 至官方引擎,而是使用 Native 字典。取得所有詞彙
新增詞彙
更新詞彙
刪除詞彙
匯入字典
字典登記後的語音合成
登記於使用者字典的詞彙會在語音合成時自動參照。注意事項
- Laravel 版的使用者字典與官方 VOICEVOX 引擎的使用者字典為分開管理。
- 詞彙的新增、更新、刪除會立即儲存至 JSON 檔案。
- 若不清楚重音型別,建議先嘗試
0(平板)。
疑難排解
詞彙未反映
- 請確認 storage 目錄的寫入權限
- 請確認
storage/voicevox/user_dict.json是否正確建立 - 請確認片假名表記是否正確