通过 Waterfall Dialogs 使用自适应卡片
在本机上，自适应卡片不像提示那样工作。出现提示时，提示将显示并等待用户输入，然后再继续。但是使用自适应卡片（即使它包含一个输入框和一个提交按钮），自适应卡片中没有任何代码会导致瀑布对话框在继续对话框之前等待用户输入。
因此，如果您使用的是接受用户输入的自适应卡片，您通常希望处理用户在瀑布对话框上下文之外提交的任何内容。
话虽如此，如果您想将自适应卡片用作瀑布对话框的一部分，则有一种解决方法。基本上，你：
- 显示自适应卡片
- 显示文本提示
- 将用户的自适应卡片输入转换为文本提示的输入
在您的瀑布对话框类中（步骤 1 和 2）：
private async Task<DialogTurnResult> DisplayCardAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
// Display the Adaptive Card
var cardPath = Path.Combine(".", "AdaptiveCard.json");
var cardJson = File.ReadAllText(cardPath);
var cardAttachment = new Attachment()
{
ContentType = "application/vnd.microsoft.card.adaptive",
Content = JsonConvert.DeserializeObject(cardJson),
};
var message = MessageFactory.Text("");
message.Attachments = new List<Attachment>() { cardAttachment };
await stepContext.Context.SendActivityAsync(message, cancellationToken);
// Create the text prompt
var opts = new PromptOptions
{
Prompt = new Activity
{
Type = ActivityTypes.Message,
Text = "waiting for user input...", // You can comment this out if you don't want to display any text. Still works.
}
};
// Display a Text Prompt and wait for input
return await stepContext.PromptAsync(nameof(TextPrompt), opts);
}
private async Task<DialogTurnResult> HandleResponseAsync(WaterfallStepContext stepContext, CancellationToken cancellationToken)
{
// Do something with step.result
// Adaptive Card submissions are objects, so you likely need to JObject.Parse(step.result)
await stepContext.Context.SendActivityAsync($"INPUT: {stepContext.Result}");
return await stepContext.NextAsync();
}
在您的主机器人类 (<your-bot>.cs) 中，在 OnTurnAsync() 下，靠近方法的开头，在调用 await dialogContext.ContinueDialogAsync(cancellationToken) 之前的某个位置（第 3 步）：
var activity = turnContext.Activity;
if (string.IsNullOrWhiteSpace(activity.Text) && activity.Value != null)
{
activity.Text = JsonConvert.SerializeObject(activity.Value);
}
附加上下文
自适应卡片发送的提交结果与常规用户文本略有不同。当用户在聊天中键入并发送正常消息时，它会以Context.Activity.Text 结束。当用户在自适应卡上填写输入时，它会以Context.Activity.Value 结尾，这是一个对象，其中键名是您卡中的id，值是自适应卡中的字段值。
例如json：
{
"type": "AdaptiveCard",
"body": [
{
"type": "TextBlock",
"text": "Test Adaptive Card"
},
{
"type": "ColumnSet",
"columns": [
{
"type": "Column",
"items": [
{
"type": "TextBlock",
"text": "Text:"
}
],
"width": 20
},
{
"type": "Column",
"items": [
{
"type": "Input.Text",
"id": "userText",
"placeholder": "Enter Some Text"
}
],
"width": 80
}
]
}
],
"actions": [
{
"type": "Action.Submit",
"title": "Submit"
}
],
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
"version": "1.0"
}
.. 创建一张如下所示的卡片：
如果用户在文本框中输入“Testing Testing 123”并点击提交，Context.Activity 将类似于：
{ type: 'message',
value: { userText: 'Testing Testing 123' },
from: { id: 'xxxxxxxx-05d4-478a-9daa-9b18c79bb66b', name: 'User' },
locale: '',
channelData: { postback: true },
channelId: 'emulator',
conversation: { id: 'xxxxxxxx-182b-11e9-be61-091ac0e3a4ac|livechat' },
id: 'xxxxxxxx-182b-11e9-ad8e-63b45e3ebfa7',
localTimestamp: 2019-01-14T18:39:21.000Z,
recipient: { id: '1', name: 'Bot', role: 'bot' },
timestamp: 2019-01-14T18:39:21.773Z,
serviceUrl: 'http://localhost:58453' }
用户提交可见Context.Activity.Value.userText。
请注意，自适应卡片提交是作为 postBack 发送的，这意味着提交数据不会作为对话的一部分出现在聊天窗口中，而是保留在自适应卡片上。