using System.ComponentModel;
using System.Text;
using NewLife.XCoder.Services;
using NewLife.XCoder.Tools.Platform;
using NewLife.XCoder.Tools.Voice;
using Xunit;
namespace XCoder.App.Tests;
/// <summary>本地语音合成(TTS)真实链路测试(NET-8)</summary>
/// <remarks>
/// 走工具实际使用的命令行(Windows SAPI / Linux espeak / macOS say),把文本合成为音频文件再校验,
/// 不发声、不弹窗。缺少语音引擎时自动跳过(Windows 一般自带 SAPI;Linux 需 apt install espeak-ng)。
/// </remarks>
public class SpeechSynthesisTests
{
/// <summary>探测语音引擎是否可用</summary>
private static Boolean EngineAvailable()
{
try
{
var probe = SpeechCommandBuilder.BuildProbe(PlatformCapabilities.IsWindows, PlatformCapabilities.IsMacOS);
var output = ProcessRunner.Run(probe, 15000);
return !String.IsNullOrWhiteSpace(output);
}
catch
{
return false;
}
}
[Fact]
[DisplayName("语音引擎探测命令能列出音色")]
public void Probe_ListsVoices()
{
if (!EngineAvailable()) return;
var probe = SpeechCommandBuilder.BuildProbe(PlatformCapabilities.IsWindows, PlatformCapabilities.IsMacOS);
var output = ProcessRunner.Run(probe, 15000);
Assert.False(String.IsNullOrWhiteSpace(output));
Assert.DoesNotContain("Exception", output, StringComparison.OrdinalIgnoreCase);
}
[Fact]
[DisplayName("文本合成为 WAV 文件且文件头正确")]
public void Synthesize_WritesWaveFile()
{
if (!EngineAvailable()) return;
var path = Path.Combine(Path.GetTempPath(), "xcoder-tts-" + Guid.NewGuid().ToString("N") + ".wav");
try
{
var command = SpeechCommandBuilder.Build(PlatformCapabilities.IsWindows, PlatformCapabilities.IsMacOS, "hello xcoder", path, 0, 100, null);
ProcessRunner.Run(command, 60000);
Assert.True(File.Exists(path), "未生成音频文件");
var bytes = File.ReadAllBytes(path);
Assert.True(bytes.Length > 1024, $"音频文件过小:{bytes.Length} 字节");
// WAV 头应是 RIFF....WAVE
var header = Encoding.ASCII.GetString(bytes, 0, 12);
Assert.StartsWith("RIFF", header);
Assert.Contains("WAVE", header);
}
finally
{
try { File.Delete(path); } catch (IOException) { }
}
}
[Fact]
[DisplayName("空文本构建命令被拒绝(边界)")]
public void Build_EmptyText_Throws()
{
Assert.Throws<ArgumentException>(() => SpeechCommandBuilder.Build(true, false, ""));
Assert.Throws<ArgumentException>(() => SpeechCommandBuilder.Build(false, false, " "));
}
[Fact]
[DisplayName("含单引号与换行的文本被正确转义")]
public void Build_EscapesText()
{
var command = SpeechCommandBuilder.Build(true, false, "it's\na test");
// 单引号在 PowerShell 单引号串里需成对转义,换行被压成空格
Assert.Contains("it''s a test", command);
Assert.DoesNotContain("\n", command);
}
[Fact]
[DisplayName("指定输出文件时命令带上写文件参数")]
public void Build_WithOutputFile_IncludesWriter()
{
var win = SpeechCommandBuilder.Build(true, false, "hi", @"C:\temp\a.wav");
Assert.Contains("SetOutputToWaveFile", win);
var linux = SpeechCommandBuilder.Build(false, false, "hi", "/tmp/a.wav");
Assert.Contains("-w \"/tmp/a.wav\"", linux);
var mac = SpeechCommandBuilder.Build(false, true, "hi", "/tmp/a.aiff");
Assert.Contains("-o \"/tmp/a.aiff\"", mac);
}
}
|