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。
如果這不是直接訊息, (預設值為 false) ,則 POST 至這個方法的 * Bot 是建立交談的 Bot * IsGroup 設定為 true
傳回值是 ResourceResponse,其中包含適合用於訊息承載和 REST API URI 的交談識別碼。
大部分通道只支援起始直接訊息交談的 Bot 語意。 如何執行此動作的範例如下:
var resource = await connector.conversations.CreateConversation (new ConversationParameters () { Bot= bot, members = new ChannelAccount[] { new ChannelAccount (「user1」) } ) ; await connect。Conversations.OnSendToConversationAsync (資源。Id, new Activity () ... ) ;
結束。