互联网不景气了那就玩玩嵌入式吧，用纯.NET开发并制作一个智能桌面呆板人（ ...

媒介

前段时间太忙了博客不停都没来得及更新，但是不代表我已经停止开发了，刚好最近把语音部分给调整了一下，所以就来分享一下具体的内容了。我想说一下，更新晚还是有好处的，社区已经有很多的小伙伴自己实现了一些语音对话功能的案例，比如小智也有.NET客户端了，还有就是一些树莓派对接实时语音api实现对话的功能，这些都是挺好的案例，很适合有兴趣的小伙伴来学习使用。
我做的还是比较传统的对话，通过Azure的语音服务进行关键字的训练，然后通过文本转语音和语音转文本再联合BotSharp智能体框架可以做到不集成小智服务实现对话的本领，而且拥有会话管理，提示词管理还有一些工具调用的本领。我已经如饥似渴的想分享给各人了。

问题解答

为啥选择树莓派不是单片机

有朋友以为树莓派代价贵，还说单片机就能完成开发之类的，我给各人阐明下我们目前做的是针对Linux系统下的.NET的一些实践，如果以为树莓派贵可以买一些国产的板子平替，有本领的可以自己搞库映射。至于单片机开发的事情，如果真的感兴趣单片机开发，那我们可以后期出一些文章讲这个做一些有趣的玩具。
表情播放目前的方案选择是啥

上一篇文章有讲什么是lottie动画，文章有说效果不好，但是我检查代码之后发现是代码写的有bug才导致播放很差，所以就不消转成文本的mp4了，lottie动画文件很小，适合放到板子上。
下图上面是在电脑上使用Lottie动画播放的效果。

名词解释

我是真的想让各人亲自上手试试，所以文章会讲一些基础的内容，各人不要嫌啰嗦，能看到这篇文章的小伙伴阐明各人至少应该有个板子而且点亮了屏幕。
BotSharp

BotSharp 是一个开源的多智能体应用开发框架，从简单的聊天呆板人，再到多智能体协作，以及复杂的任务如【Text To Sql】框架都提供了开箱即用的使用方法，可以快速的将大模子的本领接入到现有的业务系统中，而且内置知识库和会话管理功能等。
在我们的智能桌面呆板人项目中，BotSharp提供会话管理和多智能体调用以及工具调用的功能。

• BotSharp官方GitHub
  
• BotSharp文档
  

Azure语音服务

Azure语音服务是微软提供的云端AI服务，支持语音转文本、文本转语音、语音翻译等功能。在我们的智能桌面呆板人项目中，Azure语音服务用于将用户的语音指令转换为文本（用于理解用户意图）以及将呆板人的文本复兴转换为自然语音输出。此外，它还支持关键词辨认功能，可用于唤醒我们的呆板人。

• Azure语音服务官方文档
  
• .NET中使用Azure语音服务指南
  
• 关键词辨认文档
  

ALSA

ALSA（Advanced Linux Sound Architecture）是Linux系统中的音频架构，提供了对声卡硬件的驱动功能和API。在树莓派等Linux设备上，ALSA是处理声音输入输出的基础系统。我们的呆板人项目需要ALSA来管理麦克风输入和扬声器输出。

• ALSA项目主页
  
• ALSA Wiki
  

aplay

aplay是ALSA提供的命令行工具，用于播放音频文件。在Linux系统中，可以使用aplay命令来测试和播放各种格式的音频文件，验证扬声器是否正常工作。在我们的项目中，可以通过步伐调用aplay来播放合成的语音文件。

• aplay命令手册
  

arecord

arecord是ALSA的录音工具，用于从麦克风或其他音频输入设备捕捉音频。在树莓派上，我们可以使用arecord来录制用户的语音，然后将录制的音频文件发送给语音辨认服务进行处理。

• arecord命令手册
  
• 使用arecord录音指南
  

amixer

amixer是ALSA提供的另一个命令行工具，用于控制音频混合器设置，如音量调治、输入输出设备选择等。在我们的呆板人项目中，可以使用amixer来调整麦克风和扬声器的音量，确保语音交互体验良好。

• amixer命令手册
  

准备工作

首先准备麦克风和喇叭

可以通过购买现成的声卡，接到树莓派上的USB口或者OTG口，而且根据上面的aplay和arecord工具测试麦克风和喇叭是否正常。

1. cat /proc/asound/cards #查看声卡设备
2. cat /proc/asound/devices #查看设备
3. arecord -l # 列出设备
4. aplay -l # 列出设备
5. arecord -D "plughw:0,0" -f S16_LE -r 16000 -d 5 -t wav test.wav #录制一段测试声音
6. aplay -D "plughw:0,0" test.wav # 播放测试声音
7. alsamixer #调节系统的音量

复制代码

部分指令测试图如下：

获取Azure语音服务的API KEY

需要在微软的Azure服务中创建语音资源，获取Api Key。
获取微软的Azure OpenAI或者其他的大模子的API KEY

目前微软新出的Azure AI Foundry服务，可以在里面创建并使用多种模子，适合有订阅的用户使用，代价还算合适各人可以试试，流行的一些模子都可以在上面使用。

如果没有各人也可以申请国内的一些Key，例如阿里的百炼平台和DeepSeek的一些API KEY。
BotSharp简单上手

BotSharp

BotSharp 是一个开源的多智能体应用开发框架，从简单的聊天呆板人，再到多智能体协作，以及复杂的任务如【Text To Sql】框架都提供了开箱即用的使用方法，可以快速的将大模子的本领接入到现有的业务系统中，而且内置知识库和会话管理功能等。

大语言模子的函数调用（这个是理解BotSharp框架的核心知识点）

函数调用答应您将模子连接到外部工具和系统。这对于许多事情都很有用，例如为 AI 助手提供功能，或在应用步伐和模子之间构建深度集成。
openai官方文档函数调用介绍文档
运行BotSharp源码

首先准备一台安装了Visual Studio并安装了Aspire组件的电脑，电脑再安装nodejs环境用来运行前端UI项目。
克隆前后端代码到同一目次。
BotSharp C#源码克隆指令如下：

1. git clone https://github.com/SciSharp/BotSharp.git

复制代码

BotSharp前端UI代码克隆指令如下:

1. git clone https://github.com/SciSharp/BotSharp-UI.git

复制代码

命令行进入到BotSharpUI的代码目次执行npm install 安装依靠
确保前端连接的后台服务地址为当地服务

然后Visual Studio打开BotSharp办理方案，配置大模子的api key的然后启动图上的项目

详细的使用文档请查看社区的文档链接：BotSharp社区文档
ElectronBot.Standalone 项目整体代码讲解

主流程

关键词的唤醒和BotSharp嵌入的流程图如下：
图上有些功能并没有实现，但是辅助各人理解是足够的了。

图上流程图对应的代码在下图所示的HostedService类中

1. using BotSharp.Abstraction.Agents.Enums;
2. using BotSharp.Abstraction.Conversations;
3. using BotSharp.Abstraction.Conversations.Models;
4. using BotSharp.Abstraction.Routing;
5. using ElectronBot.Standalone.Core.Contracts;
6. using ElectronBot.Standalone.Core.Enums;
7. using ElectronBot.Standalone.Core.Models;
8. using ElectronBot.Standalone.Core.Repositories;
9. using Microsoft.Extensions.DependencyInjection;
10. using Microsoft.Extensions.Hosting;
11. using Microsoft.Extensions.Logging;
12. using NetCoreAudio;
14. namespace ElectronBot.Standalone.Core.Services;
16. /// <summary>
17. /// A hosted service providing the primary conversation loop for Semantic Kernel with OpenAI ChatGPT.
18. /// </summary>
19. public class HostedService : IHostedService, IDisposable
20. {
21.     private readonly ILogger<HostedService> _logger;
23.     private readonly IWakeWordListener _wakeWordListener;
25.     private readonly IServiceProvider _serviceProvider;
27.     private BotSpeechSetting _options;
29.     private Task? _executeTask;
31.     private readonly CancellationTokenSource _cancelToken = new();
33.     // Notification sound support
34.     private readonly string _notificationSoundFilePath;
35.     private readonly Player _player;
37.     private readonly IServiceScopeFactory _serviceScopeFactory;
39.     private readonly IBotPlayer _botPlayer;
41.     /// <summary>
42.     /// Constructor
43.     /// </summary>
44.     public HostedService(IWakeWordListener wakeWordListener,
45.         ILogger<HostedService> logger,
46.         IServiceProvider serviceProvider,
47.         BotSpeechSetting options,
48.         IServiceScopeFactory serviceScopeFactory,
49.         IBotPlayer botPlayer)
50.     {
51.         _logger = logger;
52.         _wakeWordListener = wakeWordListener;
53.         _notificationSoundFilePath = Path.Combine(AppContext.BaseDirectory, "Asserts", "bing.mp3");
54.         _player = new Player();
55.         _serviceProvider = serviceProvider;
56.         _options = options;
57.         _serviceScopeFactory = serviceScopeFactory;
58.         _botPlayer = botPlayer;
59.     }
61.     /// <summary>
62.     /// Start the service.
63.     /// </summary>
64.     public Task StartAsync(CancellationToken cancellationToken)
65.     {
66.         _botPlayer.ShowDateToSubScreenAsync();
67.         _executeTask = ExecuteAsync(_cancelToken.Token);
68.         return Task.CompletedTask;
69.     }
71.     /// <summary>
72.     /// Primary service logic loop.
73.     /// </summary>
74.     public async Task ExecuteAsync(CancellationToken cancellationToken)
75.     {
76.         while (!cancellationToken.IsCancellationRequested)
77.         {
78.             try
79.             {
80.                 // Play a notification to let the user know we have started listening for the wake phrase.
81.                 await _player.Play(_notificationSoundFilePath);
83.                 var botSpeech = _serviceProvider.GetRequiredService<IBotSpeecher>();
85.                 // Wait for wake word or phrase
86.                 if (!await _wakeWordListener.WaitForWakeWordAsync(cancellationToken))
87.                 {
88.                     continue;
89.                 }
90.                 await _player.Play(_notificationSoundFilePath);
92.                 var helloString = _options.AnswerText;
93.                 // Say hello on startup
94.                 await botSpeech.SpeakAsync(helloString ?? "Hello!", cancellationToken);
95.                 // Start listening
96.                 while (!cancellationToken.IsCancellationRequested)
97.                 {
98.                     // Listen to the user
99.                     var userSpoke = await botSpeech.ListenAsync(cancellationToken);
100.                     await _botPlayer.StopLottiePlaybackAsync();
102.                     _logger.LogInformation($"User spoke: {userSpoke}");
103.                     // Get a reply from the AI and add it to the chat history.
104.                     var reply = string.Empty;
106.                     using (var scope = _serviceScopeFactory.CreateScope())
107.                     {
108.                         var serviceProvider = scope.ServiceProvider;
109.                         var repo = serviceProvider.GetRequiredService<IBraincaseRepository>();
111.                         var setting = await repo.GetSettingAsync();
113.                         var inputMsg = new RoleDialogModel(AgentRole.User, userSpoke)
114.                         {
115.                             MessageId = Guid.NewGuid().ToString(),
116.                             CreatedAt = DateTime.UtcNow
117.                         };
119.                         var conversationService = serviceProvider.GetRequiredService<IConversationService>();
120.                         var routing = serviceProvider.GetRequiredService<IRoutingService>();
122.                         routing.Context.SetMessageId(setting.CurrentConversationId, inputMsg.MessageId);
123.                         conversationService.SetConversationId(setting.CurrentConversationId, new());
125.                         try
126.                         {
127.                             // 启动动画但不阻塞当前执行流程
128.                             var animationTask = _botPlayer.PlayLottieByNameIdAsync("think", -1);
130.                             // 可以选择添加异常处理
131.                             animationTask?.ContinueWith(t =>
132.                             {
133.                                 if (t.IsFaulted)
134.                                 {
135.                                     _logger.LogError($"Animation playback failed: {t.Exception}");
136.                                 }
137.                             }, TaskContinuationOptions.OnlyOnFaulted);
138.                         }
139.                         catch (Exception ex)
140.                         {
141.                             _logger.LogError($"Failed to start animation: {ex.Message}");
142.                             await _botPlayer.StopLottiePlaybackAsync();
143.                             // 根据需要处理异常
144.                         }
146.                         await Task.Run(async () =>
147.                         {
148.                             await conversationService.SendMessage(VerdureAgentId.VerdureChatId, inputMsg,
149.                                 replyMessage: null,
150.                                 msg =>
151.                                 {
152.                                     reply = msg.Content;
153.                                     return Task.CompletedTask;
154.                                 });
155.                         });
157.                         await _botPlayer.StopLottiePlaybackAsync();
158.                         // Speak the AI's reply
159.                         await botSpeech.SpeakAsync(reply, cancellationToken);
161.                         // If the user said "Goodbye" - stop listening and wait for the wake work again.
162.                         if (userSpoke.StartsWith("再见") || userSpoke.StartsWith("goodbye", StringComparison.InvariantCultureIgnoreCase))
163.                         {
164.                             break;
165.                         }
166.                     }
167.                 }
168.             }
169.             catch (Exception aiex)
170.             {
171.                 await _botPlayer.StopLottiePlaybackAsync();
172.                 _logger.LogError($"OpenAI returned an error.{aiex.Message}");
173.             }
174.         }
175.     }
177.     /// <summary>
178.     /// Stop a running service.
179.     /// </summary>
180.     public Task StopAsync(CancellationToken cancellationToken)
181.     {
182.         _cancelToken.Cancel();
183.         return Task.CompletedTask;
184.     }
186.     /// <inheritdoc/>
187.     public virtual void Dispose()
188.     {
189.         _cancelToken.Dispose();
190.         _wakeWordListener.Dispose();
191.     }
192. }

复制代码

语音服务

微软的Azure认知服务提供了开箱即用的C#接入SDK，我们直接集成代码而且配置我们的麦克风设备和语音服务的apikey就行了。主要是要配置麦克风设备，因为在树莓派上的录音设备如果不是默认的，需要我们指定具体的设备，不然听不到声音，我配置的设备信息如下可以作为参考。

ElectronBot.Standalone 项目怎样集成BotSharp

对话呆板人项目地址如下：
https://github.com/maker-community/ElectronBot.Standalone
项目是使用Nuget包的情势集成BotSharp，宿主是WebAPI项目，当然也可以是桌面项目或者控制台项目。

项目的启动代码如下：

1. using BotSharp.Abstraction.Messaging.JsonConverters;
2. using BotSharp.Abstraction.Repositories;
3. using BotSharp.Abstraction.Users;
4. using BotSharp.Core;
5. using BotSharp.Logger;
6. using ElectronBot.Standalone.Core.Contracts;
7. using ElectronBot.Standalone.Core.Handlers;
8. using ElectronBot.Standalone.Core.Models;
9. using ElectronBot.Standalone.Core.Repositories;
10. using ElectronBot.Standalone.Core.Services;
11. using ElectronBot.Standalone.DataStorage;
12. using ElectronBot.Standalone.DataStorage.Repository;
13. using Verdure.Braincase.Copilot.Plugin.Services.BotSharp;
15. var builder = WebApplication.CreateBuilder(args);
17. // Add services to the container.
19. builder.Services.AddControllers();
20. // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
21. builder.Services.AddEndpointsApiExplorer();
22. builder.Services.AddSwaggerGen();
23. var dbSettings = new BotSharpDatabaseSettings();
24. builder.Configuration.Bind("Database", dbSettings);
25. builder.Services.AddSingleton(dbSettings);
27. var brainSettings = new BraincaseDatabaseSettings();
28. builder.Configuration.Bind("Database", brainSettings);
30. brainSettings.BraincaseLiteDB = "braincase.db";
32. builder.Services.AddSingleton(brainSettings);
34. var botSpeechSettings = new BotSpeechSetting();
35. builder.Configuration.Bind("BotSpeechSetting", botSpeechSettings);
36. builder.Services.AddSingleton(botSpeechSettings);
38. builder.Services.AddScoped<BraincaseLiteDBContext>();
39. builder.Services.AddSingleton<IBotPlayer, DefaultBotPlayer>();
40. builder.Services.AddSingleton<IBotSpeecher, AzBotSpeecher>();
41. builder.Services.AddSingleton<IWakeWordListener, AzCognitiveServicesWakeWordListener>();
42. builder.Services.AddScoped<IBotCopilot, DefaultBotCopilot>();
43. builder.Services.AddScoped<IBraincaseRepository, BraincaseRepository>();
44. builder.Services.AddHostedService<HostedService>();
45. builder.Services.AddBotSharpCore(builder.Configuration, options =>
46.   {
47.       options.JsonSerializerOptions.Converters.Add(new RichContentJsonConverter());
48.       options.JsonSerializerOptions.Converters.Add(new TemplateMessageJsonConverter());
49.   }).AddBotSharpLogger(builder.Configuration);
51. builder.Services.AddHttpContextAccessor();
52. builder.Services.AddScoped<IUserIdentity, BotUserIdentity>();
53. var app = builder.Build();
55. // Configure the HTTP request pipeline.
56. if (app.Environment.IsDevelopment())
57. {
58.     app.UseSwagger();
59.     app.UseSwaggerUI();
60. }
62. app.UseAuthorization();
64. app.MapControllers();
65. // Use BotSharp
66. //app.UseBotSharp();
68. // Add startup code
69. app.Lifetime.ApplicationStarted.Register(async () =>
70. {
71.     // Your startup code here
72.     Console.WriteLine("Application has started.");
74.     // Retrieve IBotCopilot from DI container
75.     using (var scope = app.Services.CreateScope())
76.     {
77.         var botCopilot = scope.ServiceProvider.GetRequiredService<IBotCopilot>();
78.         await botCopilot.InitCopilotAsync();
79.     }
80. });
82. app.Run();

复制代码

ElectronBot.Standalone 代码测试

我们配置完Azure语音服务的Key和大模子的key并设置到对应的智能体上，默认使用的是Azure AI Foundry里的gpt-4o-mini的模子，如果需要修改，请根据下图的配置进行修改。
我训练的唤醒关键词为 小娜，可以用你好小娜进行关键词唤醒。

启动项目便会将配置更新到LiteDB存储里，各人也可以直接修改数据库里的数据。
代码做了兼容，意味着在windows系统下也可以进行测试。
测试效果如下：

代码到这里就算是讲解完了，实际的效果各人可以亲自测试下。
总结感悟

写这篇文章距离上一篇隔了有一两个月了，不禁感慨AI行业发展的是真的快，之前的MCP协议还不是很火，随着智能体框架的兴起以及一些大厂的跟进，MCP也火了起来，.NET社区针对MCP的支持也迅速美满了。
说起DeepSeek，他们最近也更新了V3版本的模子，虽然是小版本号升级，但是本领提拔却很大了，之前不能胜任的一些操作现在也可以很好的支持了。我使用了BotSharp框架里比较复杂的功能测试DeepSeek V3的新模子发现效果出奇的好，国产大模子真是越来越好了。
OpenAI 也发布了新的生图功能，针对按指令生图修图完成的都很好了，说句实话，感觉如许下去，文章都不消写了，各人直接跟着AI学习就好了。
总而言之盼望各人都能进步，这篇文章也能给各人带来一些启发。
参考保举文档项目如下：

• 创客社区地址
  
• BotSharp文档
  
• 桌面桌面呆板人仓库地址
  
• .NET IoT库源码地址
  
• .NET IoT官方地址
  
• .NET IoT社区人员张高兴保举
  
• 什么是lottie动画？
  
• 参考的语音对话项目conversational-speaker
  
• 小智C#客户端
  
• C# MCP SDK
  
• 树莓派学习之旅（2）— 使用USB声卡进行录音
  
• BotSharp官方GitHub
  
• EdgeVoice AI 聊天呆板人
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

继续阅读请点击广告