ChannelServiceHandlerBase.OnCreateConversationAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
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
bot 的 claimsIdentity 應該具有 AudienceClaim、AppIdClaim 和 ServiceUrlClaim。
- parameters
- ConversationParameters
要從中建立交談的參數。
- cancellationToken
- CancellationToken
取消權杖。
傳回
交談資源回應的工作。
備註
覆寫此方法以建立新的 Conversation。
POST 這個方法,並用 * Bot 表示建立對話的機器人 * IsGroup 設為 true(如果這不是私訊(預設為 false) * 包含要參與對話的成員的陣列
回傳值為 ResourceResponse,包含一個適合用於訊息有效載荷及 REST API URI 的對話 ID。
大部分通道只支援 Bot 起始直接訊息交談的語意。 如何執行此動作的範例如下:
var resource = waitit、connector.conversations.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount(“user1”)} ;wait、connect。Conversations.OnSendToConversationAsync(資源。ID,新活動(... );
結束。