ChannelServiceHandlerBase.OnCreateConversationAsync 方法

定义

命名空间:

Microsoft.Bot.Builder

程序集:

Microsoft.Bot.Builder.dll

包:

Microsoft.Bot.Builder v4.22.7

CreateConversation () API。

protected virtual System.Threading.Tasks.Task<Microsoft.Bot.Schema.ConversationResourceResponse> OnCreateConversationAsync (System.Security.Claims.ClaimsIdentity claimsIdentity, Microsoft.Bot.Schema.ConversationParameters parameters, System.Threading.CancellationToken cancellationToken = default);

abstract member OnCreateConversationAsync : System.Security.Claims.ClaimsIdentity * Microsoft.Bot.Schema.ConversationParameters * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ConversationResourceResponse>
override this.OnCreateConversationAsync : System.Security.Claims.ClaimsIdentity * Microsoft.Bot.Schema.ConversationParameters * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ConversationResourceResponse>

Protected Overridable Function OnCreateConversationAsync (claimsIdentity As ClaimsIdentity, parameters As ConversationParameters, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ConversationResourceResponse)

参数

claimsIdentity

ClaimsIdentity

机器人的 claimsIdentity 应具有 AudienceClaim、AppIdClaim 和 ServiceUrlClaim。

parameters

ConversationParameters

要从中创建会话的参数。

cancellationToken

CancellationToken

取消标记。

返回

Task<ConversationResourceResponse>

会话资源响应的任务。

注解

重写此方法以创建新的 Conversation。

POST 到此方法，其中 * 机器人是创建聊天的机器人 * 如果这不是直接消息，则 IsGroup 设置为 true (默认值为 false) * 包含要包含在聊天中的成员的数组

返回值为 ResourceResponse，其中包含适合在消息有效负载和 REST API URI 中使用的会话 ID。

大多数通道仅支持启动直接消息会话的机器人的语义。 如何执行此操作的示例为：

var resource = await connector.conversations.CreateConversation (new ConversationParameters () { Bot= bot， members = new ChannelAccount[] { new ChannelAccount (“user1”) } ) ; await connect。Conversations.OnSendToConversationAsync (资源。Id， new Activity () ... ) ;

结束。