ITurnContext.SendActivityAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| SendActivityAsync(IActivity, CancellationToken) |
將活動傳送給傳入活動的傳送者。 |
| SendActivityAsync(String, String, String, CancellationToken) |
將訊息活動傳送給傳入活動的傳送者。 |
SendActivityAsync(IActivity, CancellationToken)
將活動傳送給傳入活動的傳送者。
public System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse> SendActivityAsync(Microsoft.Bot.Schema.IActivity activity, System.Threading.CancellationToken cancellationToken = default);
abstract member SendActivityAsync : Microsoft.Bot.Schema.IActivity * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>
Public Function SendActivityAsync (activity As IActivity, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse)
參數
- activity
- IActivity
要傳送的活動。
- cancellationToken
- CancellationToken
一種可被其他物件或執行緒用來接收取消通知的取消標記。
傳回
工作,表示要執行的工作佇列。
備註
如果成功傳送活動,工作結果會包含 ResourceResponse 物件,其中包含指派給活動的接收通道標識碼。
另請參閱
- UpdateActivityAsync(IActivity, CancellationToken)
- DeleteActivityAsync(ConversationReference, CancellationToken)
- OnSendActivities(SendActivitiesHandler)
- SendActivityAsync(String, String, String, CancellationToken)
- SendActivitiesAsync(IActivity[], CancellationToken)
適用於
SendActivityAsync(String, String, String, CancellationToken)
將訊息活動傳送給傳入活動的傳送者。
public System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse> SendActivityAsync(string textReplyToSend, string speak = default, string inputHint = "acceptingInput", System.Threading.CancellationToken cancellationToken = default);
abstract member SendActivityAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>
Public Function SendActivityAsync (textReplyToSend As String, Optional speak As String = Nothing, Optional inputHint As String = "acceptingInput", Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse)
參數
- textReplyToSend
- String
要傳送之訊息的文字。
- speak
- String
選擇性的文字,由 Bot 在啟用語音功能的通道上說出。
- inputHint
- String
選擇性表示 Bot 在訊息傳遞至客戶端之後是否接受、預期或忽略使用者輸入。 InputHints 定義了可能的值。 預設值為 AcceptingInput。
- cancellationToken
- CancellationToken
一種可被其他物件或執行緒用來接收取消通知的取消標記。
傳回
工作,表示要執行的工作佇列。
備註
若活動成功傳送,任務結果會包含 ResourceResponse 一個物件,該物件包含接收通道指派給該活動的 ID。
如需對 textReplyToSend內容施加的限制,請參閱通道的檔。
若要控制 Bot 語音的各種特性,例如語音、速率、音量、發音和音調,請以語音合成標記語言 (SSML) 格式指定 speak。
另請參閱
- UpdateActivityAsync(IActivity, CancellationToken)
- DeleteActivityAsync(ConversationReference, CancellationToken)
- OnSendActivities(SendActivitiesHandler)
- SendActivityAsync(IActivity, CancellationToken)
- SendActivitiesAsync(IActivity[], CancellationToken)