Merge pull request #39 from actlaboratory/master

Release 1.1.0

Author: yncat

addon/doc/en/readme.md

@@ -39,6 +39,18 @@ Set speech engines which will be used as Japanese and non-Japanese speeches, res
 
 Currently, it is not supported to use the same speech engine for different languages. For example, when you are using SAPI5 speech engine for non-Japanese, you cannot use SAPI5 for Japanese.
 
+### Volume / Rate adjustment options
+
+You can fine-tune the volume and rate for each language.
+
+The adjustment is specified in a range of plus or minus 100, relative to UML's own rate and volume settings.
+
+A value of 100 represents the amount of change when the slider is moved to its maximum on top of each speech engine's configured value. -100 represents the amount of change when the slider is moved to its minimum.
+
+For example, if UML's configured rate is 50, a language with a "rate adjustment" of 20 will be spoken at rate 70 by its corresponding speech engine. Conversely, a "rate adjustment" of -20 results in rate 30.
+
+Adjusted values are automatically clamped to the maximum / minimum supported by each speech engine.
+
 ## Recommended settings
 
 It is strongly recommended to check the "Trust voice's language when processing characters and symbols" checkbox, which is located under NVDA's speech settings. It is a bit hard to describe, but it results in better reading.
@@ -47,7 +59,7 @@ It is strongly recommended to check the "Trust voice's language when processing
 
 Some combinations of speech engines will not work properly. In most cases, it is due to the synthDriver's incorrect implementations, and it is not fixable no matter how Universal Multilingual tries its best. 
 
-In order to change settings of each speech engine, you need to switch to the speech engine from NVDA's speech settings first, then modify to your preference there. Universal Multilingual is responsible only for switching speech engines, and does not support any features which hook into the behaviors of speech engines under its control.
+In order to change settings other than "rate" and "volume" for each speech engine, you need to switch to the speech engine from NVDA's speech settings first, then modify to your preference there.
 
 Some events like cap pitch changing have not been supported yet. The support is planned in a near future.
 
@@ -61,6 +73,14 @@ For email support, please send an email to "support@actlab.org".
 
 ## Changelog
 
+### 2026/03/08 Version 1.1.0
+
+1. Fixed a bug where speech would freeze and not recover in certain situations. ( [#33](https://github.com/actlaboratory/UML/pull/33) , by [@mo29cg](https://github.com/mo29cg) )
+2. You can now fine-tune the rate and volume for each speech engine. These settings are accessible from both the UML settings dialog and the Settings Ring. ( [#34](https://github.com/actlaboratory/UML/pull/34) , by [@mo29cg](https://github.com/mo29cg) )
+3. UML now only prompts for reload when necessary after changing settings.
+4. As an internal change, the text processing method has been changed to use ExtensionPoints. This reduces the chance of breaking the behavior of other add-ons.
+5. Tested using NVDA 2026 alpha version and updated LastTestedNVDAVersion.
+
 ### 2025/11/19 Version 1.0.5
 
 1. Fixed a bug where speech would freeze due to an NVDA internal code change.

addon/doc/ja/readme.md

@@ -38,6 +38,18 @@
 
 現在、複数の言語で同じ音声エンジンを使用することはサポートしていません。たとえば、日本語以外の音声エンジンでSAPI5を使っているときに、日本語をSAPI5にすることはできません。
 
+### 音量調整 / 速度調整オプション
+
+言語ごとに、音量や速度を微調整することができます。
+
+微調整は、UML本体の速度と音量設定を基準として、プラスマイナス 100 の範囲で指定できます。
+
+100 という値は、それぞれの音声エンジンの設定値の上で、スライダーを最大まで調整した場合の変化量です。 -100 は、スライダーを最小まで調整した場合の変化量です。
+
+たとえば、 UML の設定値が「速度 50」のとき、「速度調整」を「20」にした言語は、対応する音声エンジンで読み上げる際に「速度 70」で読み上げられます。逆に、「速度調整」を「-20」にすると、「速度30」で読み上げられます。
+
+微調整後の値は、各音声エンジンが対応している最大値 / 最長値で自動的に丸められます。
+
 ## お勧めの設定
 
 NVDAの音声設定で、「記号と文字の説明に音声の言語を使用」のチェックボックスにチェックを入れておくことを推奨しています。言葉で説明するのがなかなか難しいのですが、チェックを付けるほうが意図した読み上げになります。
@@ -46,7 +58,7 @@ NVDAの音声設定で、「記号と文字の説明に音声の言語を使用
 
 音声エンジンの組み合わせによっては、正しく動作しない可能性があります。多くの場合、それは音声エンジンドライバの間違った実装による問題であり、Universal Multilingualがどんなに頑張っても解決することはできません。
 
-使用する音声エンジンの設定を個別で変更するには、NVDAの音声設定で、その音声エンジンを使用する設定に変更したあとで、お好みの設定に調整する必要があります。Universal Multilingualは音声を出し分けるだけであり、コントロール下にある音声エンジンの設定に干渉する機能は搭載していません。
+使用する音声エンジンの「速度」と「音量」以外の設定を個別で変更するには、NVDAの音声設定で、その音声エンジンを使用する設定に変更したあとで、お好みの設定に調整する必要があります。
 
 大文字のピッチ変更など、一部のイベントにまだ対応できていません。そのうち対応したいと思っています。
 
@@ -60,6 +72,14 @@ GitHubのアカウントを持っている方は、 [Universal Multilingualのis
 
 ## 更新履歴
 
+### 2026/03/08 Version 1.1.0
+
+1. 一部の状況に置いて、読み上げがフリーズして戻ってこなくなる不具合を修正しました ( [#33](https://github.com/actlaboratory/UML/pull/33) , by (@mo29cg)[https://github.com/mo29cg])
+2. 音声エンジンごとに、速度と音量を微調整できるようになりました。これらの設定は、 UML の設定ダイアログのほか、簡単音声設定からもアクセス可能です ( [#34](https://github.com/actlaboratory/UML/pull/34) , by (@mo29cg)[https://github.com/mo29cg])
+3. UML の設定を変更したとき、必要な場合だけ UML の再読み込みを問い合わせるようにしました。
+4. 内部処理の変更として、テキストの処理方法を ExtensionPoints ベースに変更しました。これにより、他のアドオンの動作を壊す可能性が減りました。
+5. NVDA 2026 アルファ版での動作を確認し、 LastTestedNVDAVersion を更新しました。
+
 ### 2025/11/19 Version 1.0.5
 1. NVDAの内部コードが変更されていたことに伴い、読み上げがフリーズしていた不具合を修正しました。
 

addon/globalPlugins/UML/__init__.py

@@ -27,6 +27,10 @@ def _(x): return x
     "japanese": "string(default=_)",
     "fallback": "string(default=_)",
     "checkForUpdatesOnStartup": "boolean(default=True)",
+    "volumeOffset_ja": "integer(default=0, min=-100, max=100)",
+    "volumeOffset_en": "integer(default=0, min=-100, max=100)",
+    "rateOffset_ja": "integer(default=0, min=-100, max=100)",
+    "rateOffset_en": "integer(default=0, min=-100, max=100)",
 }
 config.conf.spec["UML_global"] = confspec
 
@@ -87,6 +91,10 @@ def settings(self, evt):
             "primary_language": config.conf["UML_global"]["primaryLanguage"],
             "strategy": config.conf["UML_global"]["strategy"],
             "engineMap": engineMap,
+            "volumeOffset_ja": config.conf["UML_global"]["volumeOffset_ja"],
+            "volumeOffset_en": config.conf["UML_global"]["volumeOffset_en"],
+            "rateOffset_ja": config.conf["UML_global"]["rateOffset_ja"],
+            "rateOffset_en": config.conf["UML_global"]["rateOffset_en"],
         }
         dlg = SettingsDialog(opts)
         ret = dlg.ShowModal()
@@ -97,11 +105,24 @@ def settings(self, evt):
     def _saveSettings(self, data):
         # If the new settings fail, revert to the previous one.
         backup = list(config.conf["UML_global"].items())
+        old_japanese = config.conf["UML_global"]["japanese"]
+        old_fallback = config.conf["UML_global"]["fallback"]
         config.conf["UML_global"]["primaryLanguage"] = data["primary_language"]
         config.conf["UML_global"]["strategy"] = data["strategy"]
         config.conf["UML_global"]["japanese"] = data["engineMap"]["ja"]
         config.conf["UML_global"]["fallback"] = data["engineMap"]["en"]
-        if synthDriverHandler.getSynth().name == "UML":
+        config.conf["UML_global"]["volumeOffset_ja"] = data["volumeOffset_ja"]
+        config.conf["UML_global"]["volumeOffset_en"] = data["volumeOffset_en"]
+        config.conf["UML_global"]["rateOffset_ja"] = data["rateOffset_ja"]
+        config.conf["UML_global"]["rateOffset_en"] = data["rateOffset_en"]
+        synth = synthDriverHandler.getSynth()
+        if synth and synth.name == "UML":
+            synth._applySettings()
+        engine_changed = (
+            data["engineMap"]["ja"] != old_japanese
+            or data["engineMap"]["en"] != old_fallback
+        )
+        if engine_changed and synthDriverHandler.getSynth().name == "UML":
             self._askHotReload(backup)
 
     def _askHotReload(self, backup):

addon/globalPlugins/UML/settings.py

@@ -72,10 +72,49 @@ def __init__(self, opts):
             self, wx.ID_ANY, label=sbtnLabel, name=sbtnLabel)
         self.selectEngineButton.Bind(wx.EVT_BUTTON, self.onSynthSelect)
 
-        msz.Add(enginesLabel)
-        msz.Add(self.enginesList, 0, wx.EXPAND)
-        msz.Add(self.selectEngineButton, 1, wx.ALIGN_RIGHT)
-        msz.AddSpacer(40)
+        msz.Add(enginesLabel)
+        msz.Add(self.enginesList, 0, wx.EXPAND)
+        msz.Add(self.selectEngineButton, 1, wx.ALIGN_RIGHT)
+        msz.AddSpacer(20)
+
+        adjLabel = wx.StaticText(self, wx.ID_ANY, label=_("Voice adjustments"))
+        msz.Add(adjLabel)
+        msz.AddSpacer(5)
+
+        offsetMin = -100
+        offsetMax = 100
+        self.volumeOffsets = {}
+        self.rateOffsets = {}
+        for lang in self.langValues:
+            code = lang["internal"]
+            name = lang["user"]
+
+            volName = _("%s volume adjustment (%d to %d)") % (
+                name, offsetMin, offsetMax)
+            volLabel = wx.StaticText(self, wx.ID_ANY, label=volName)
+            self.volumeOffsets[code] = wx.SpinCtrl(
+                self, wx.ID_ANY, min=offsetMin, max=offsetMax,
+                initial=opts.get("volumeOffset_%s" % code, 0),
+                name=volName)
+            vsz = wx.BoxSizer(wx.HORIZONTAL)
+            vsz.Add(volLabel, 1)
+            vsz.Add(self.volumeOffsets[code], 1)
+            msz.Add(vsz, 0, wx.EXPAND)
+
+            rateName = _("%s rate adjustment (%d to %d)") % (
+                name, offsetMin, offsetMax)
+            rateLabel = wx.StaticText(self, wx.ID_ANY, label=rateName)
+            self.rateOffsets[code] = wx.SpinCtrl(
+                self, wx.ID_ANY, min=offsetMin, max=offsetMax,
+                initial=opts.get("rateOffset_%s" % code, 0),
+                name=rateName)
+            rsz = wx.BoxSizer(wx.HORIZONTAL)
+            rsz.Add(rateLabel, 1)
+            rsz.Add(self.rateOffsets[code], 1)
+            msz.Add(rsz, 0, wx.EXPAND)
+            msz.AddSpacer(5)
+
+        msz.AddSpacer(20)
 
         ok = wx.Button(self, wx.ID_OK, _("OK"))
         ok.SetDefault()
@@ -125,12 +164,17 @@ def _findSynthDisplayName(self, synths, target):
         # end for
         return ""
 
-    def GetData(self):
-        return {
-            "primary_language": self.langValues[self.langList.GetSelection()]["internal"],
-            "strategy": self.strategyValues[self.strategyList.GetSelection()]["internal"],
-            "engineMap": self.engineMap,
-        }
+    def GetData(self):
+        data = {
+            "primary_language": self.langValues[self.langList.GetSelection()]["internal"],
+            "strategy": self.strategyValues[self.strategyList.GetSelection()]["internal"],
+            "engineMap": self.engineMap,
+        }
+        for lang in self.langValues:
+            code = lang["internal"]
+            data["volumeOffset_%s" % code] = self.volumeOffsets[code].GetValue()
+            data["rateOffset_%s" % code] = self.rateOffsets[code].GetValue()
+        return data
 
     def onSynthSelect(self, evt):
         selected = self.enginesList.GetFocusedItem()

addon/locale/ja/LC_MESSAGES/nvda.po

@@ -170,6 +170,20 @@ msgstr "エンジン"
 msgid "Select engine"
 msgstr "エンジンを選択"
 
+#: addon\globalPlugins\UML\settings.py:80
+msgid "Voice adjustments"
+msgstr "音声調整"
+
+#: addon\globalPlugins\UML\settings.py:92
+#, python-format
+msgid "%s volume adjustment (%d to %d)"
+msgstr "%s 音量調整 (%d から %d)"
+
+#: addon\globalPlugins\UML\settings.py:104
+#, python-format
+msgid "%s rate adjustment (%d to %d)"
+msgstr "%s 速度調整 (%d から %d)"
+
 #: addon\globalPlugins\UML\settings.py:117
 msgid "Not set"
 msgstr "未設定"