在现代Web应用中，人机交互已经成为了一个不可或缺的组成部分。botbuilder-calling 是一款使用 Node.js 来构建基于电话咨询的应用程序的框架和库，它广泛应用于语音识别和自然语言处理等前端技术领域。本文将为您详细介绍 botbuilder-calling 的使用教程，并提供示例代码。
安装
要使用 botbuilder-calling，首先需要安装 npm，然后在终端里输入以下命令：
npm install --save botbuilder-calling
以上命令会将 botbuilder-calling 安装在你的项目中，同时会将其添加到你的 package.json 依赖中。
使用
在 package.json 加入 botbuilder-calling 后，需要在文件头部引入 botbuilder-calling 和相关的 Node.js 模块，例如：
const {CallConnector, CallSession, CallMessage} = require('botbuilder-calling');
const restify = require('restify');接着，使用以下代码初始化你的 botbuilder-calling 应用，并为你的应用设置 URL：
const connector = new CallConnector({
callbackUrl: 'https://<your-server-host>/api/calls',
appId: process.env.MICROSOFT_APP_ID,
appPassword: process.env.MICROSOFT_APP_PASSWORD
});
const server = restify.createServer();
server.post('/api/calls', connector.listen());在设置了连接器之后，你需要准备一些场景并定义其逻辑。你可以通过音频提示和播放录音等方式模拟电话交互，并在调用回调时响应用户的请求。以下是一个示例，在连接后向用户发送欢迎音频信息：
-- -------------------- ---- -------
----- --- - --- -------------------
--------------- -
------- -- -
----- -------------- - --- --------------------
----------- ------------------ ----------
--------------------------------------------
-----------------------------
-
---此时，你的 botbuilder-calling 应用已经准备好了。在终端输入以下命令即可启动应用：
node app.js
在浏览器或其他的电话拨号工具中，你可以拨打支持 SIP Voice over Internet Protocol（VoIP）的 IP 电话号码来调用你的 botbuilder-calling 应用。
深入学习
botbuilder-calling 包含了大量可供深入学习的功能和API。下面是一些常用API的说明：
CallConnector
CallConnector 是用来连接 Twilio 接口的框架，它有两种使用方式：callback 和 Push Sensing（类似于 SignalR）。使用 callback，你需要在调用之前设定回调函数的 URL 地址，当 Twilio 发送消息时，CallConnector 会调用这个地址。例如：
const bot = new builder.UniversalBot(chatConnector, session => {
bot.beginDialog(session.address, '/');
});
server.post('/finland/callback', chatConnector.listen());使用 Push Sensing 的方式，你只需向 CallConnector 添加一个连接器。例如：
-- -------------------- ---- -------
----- --- - --- ----------------------------------- ------- -- -
-------------------------------- -----
---
----- -------- - --- -------------------------
-----------------------------
--------------------
----------
----- --------- - --- --------------------------------
-------------------------- - --------------
-------------------CallMessage
CallMessage 用于在电话接收器上发送消息，需要传入回调函数、文本和语音等参数。例如：
const welcomeMessage = new CallMessage(session)
.text('欢迎来到 botbuilder-calling 的示例应用程序。')
.audio('https://<path-to-welcome-message>');
session.send(welcomeMessage);CallSession
CallSession 是一个用于跟踪电话与用户交互的对象。例如，当用户说话时，CallConnector 会将它们的utterance传递给 CallSession 并调用回调函数。你可以在 CallSession 对象上进行处理并返回对话流程。例如：
-- -------------------- ---- -------
--------------- -
------- -- -
------------------ ------------------ ----------
--------------------------------
-
---
---------------------- -
--------- ----- -- -
------------------------------- ------- ---------------
--
--------- -------- -- -
-- ------------------ -
------------------ ------------------------------
- ---- -
--------------------------------
-
-
---以上代码演示了如何为你的 bot 仿真一个电话会话，请求用户选择从三个选项中选择一个。
结论
botbuilder-calling 是一款先进的框架和库，用于构建语音应用程序。我们在本文中提供了其安装和使用教程，并且提供了示例代码，以帮助你快速学习和使用此技术。祝你在前端领域的探索旅途愉快！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066c81ccdc64669dde4c98