using System;
using System.Text;
namespace NewLife.XCoder.Tools.Voice;
/// <summary>跨平台语音合成命令构建</summary>
/// <remarks>
/// Windows 走 SAPI(由系统语音组件直接播报),Linux 走 espeak,macOS 走 say。
/// 这里只负责构建命令与转义,真正执行由调用方决定,便于测试与在无语音环境降级。
/// </remarks>
public static class SpeechCommandBuilder
{
/// <summary>构建朗读命令</summary>
/// <param name="isWindows">是否 Windows</param>
/// <param name="isMacOS">是否 macOS</param>
/// <param name="text">要朗读的文本</param>
/// <param name="outputFile">导出音频文件路径,可为空</param>
/// <param name="rate">语速(-10~10,仅 Windows 生效)</param>
/// <param name="volume">音量(0~100,仅 Windows 生效)</param>
/// <param name="voice">音色名,空则用系统默认</param>
/// <returns>命令行文本(含可执行文件名)</returns>
public static String Build(Boolean isWindows, Boolean isMacOS, String text, String? outputFile = null, Int32 rate = 0, Int32 volume = 100, String? voice = null)
{
if (String.IsNullOrWhiteSpace(text)) throw new ArgumentException("朗读文本不能为空", nameof(text));
var safe = Escape(text);
if (isWindows)
{
// Windows 用 PowerShell 调 SAPI,避免额外依赖;有输出文件时写 WAV
var speak = new StringBuilder();
speak.Append("Add-Type -AssemblyName System.Speech;$s=New-Object System.Speech.Synthesis.SpeechSynthesizer;");
if (!String.IsNullOrWhiteSpace(voice)) speak.Append("$s.SelectVoice('").Append(Escape(voice!.Trim())).Append("');");
if (rate != 0) speak.Append("$s.Rate=").Append(Math.Clamp(rate, -10, 10)).Append(';');
if (volume >= 0 && volume <= 100 && volume != 100) speak.Append("$s.Volume=").Append(volume).Append(';');
if (!String.IsNullOrWhiteSpace(outputFile))
speak.Append("$s.SetOutputToWaveFile('" + outputFile!.Trim().Replace("'", "''") + "');");
speak.Append("$s.Speak('" + safe + "');$s.Dispose()");
return $"powershell -NoProfile -Command \"{speak}\"";
}
if (isMacOS)
{
var voiceArg = String.IsNullOrWhiteSpace(voice) ? "" : $" -v \"{Escape(voice!.Trim())}\"";
var file = String.IsNullOrWhiteSpace(outputFile) ? "" : $" -o \"{outputFile!.Trim()}\"";
return $"say{voiceArg} \"{safe}\"{file}";
}
var espeakVoice = String.IsNullOrWhiteSpace(voice) ? "zh" : Escape(voice!.Trim());
var espeakFile = String.IsNullOrWhiteSpace(outputFile) ? "" : $" -w \"{outputFile!.Trim()}\"";
return $"espeak -v {espeakVoice} \"{safe}\"{espeakFile}";
}
/// <summary>构建可用语音引擎检查命令,用于缺依赖时提示安装</summary>
/// <param name="isWindows">是否 Windows</param>
/// <param name="isMacOS">是否 macOS</param>
/// <returns>命令行文本</returns>
public static String BuildProbe(Boolean isWindows, Boolean isMacOS)
{
if (isWindows) return "powershell -NoProfile -Command \"Add-Type -AssemblyName System.Speech; (New-Object System.Speech.Synthesis.SpeechSynthesizer).GetInstalledVoices() | ForEach-Object { $_.VoiceInfo.Name }\"";
return isMacOS ? "say -v ?" : "espeak --voices=zh";
}
private static String Escape(String text)
{
var sb = new StringBuilder(text.Length + 8);
foreach (var ch in text.Trim())
{
switch (ch)
{
case '\'': sb.Append("''"); break;
case '"': sb.Append("\\\""); break;
case '\r':
case '\n': sb.Append(' '); break;
default: sb.Append(ch); break;
}
}
return sb.ToString();
}
}
|