TurnContext.SendActivityAsync 方法

定義

命名空間:

Microsoft.Bot.Builder

組件:

Microsoft.Bot.Builder.dll

套件:

Microsoft.Bot.Builder v4.22.7

多載

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>
override this.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

取消權杖。

傳回

Task<ResourceResponse>

表示要執行之工作佇列的工作。

實作

SendActivityAsync(IActivity, CancellationToken)

例外狀況

ArgumentNullException

activity 為 null。

備註

如果成功傳送活動，工作結果會 ResourceResponse 包含物件，其中包含指派給活動的接收通道識別碼。

SendActivityAsync(String, String, String, CancellationToken)

將訊息活動傳送給傳入活動的傳送者。

public System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse> SendActivityAsync (string textReplyToSend, string speak = default, string inputHint = default, System.Threading.CancellationToken cancellationToken = default);

abstract member SendActivityAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.ResourceResponse>
override this.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 = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ResourceResponse)

參數

textReplyToSend

String

要傳送之訊息的文字。

speak

String

在已啟用語音功能的通道上，Bot 所要說出的文字是選擇性的。

inputHint

String

選擇性，指出您的 Bot 在訊息傳遞至用戶端之後是否接受、預期或忽略使用者輸入。 其中一個：「acceptingInput」、「ignoringInput」 或 「expectingInput」。 預設為 Null。

cancellationToken

CancellationToken

取消語彙基元。

傳回

Task<ResourceResponse>

表示要執行之工作佇列的工作。

實作

SendActivityAsync(String, String, String, CancellationToken)

例外狀況

ArgumentNullException

textReplyToSend 為 null 或空白字元。

備註

如果成功傳送活動，工作結果會 ResourceResponse 包含物件，其中包含指派給活動的接收通道識別碼。

如需對 內容 textReplyToSend 所加加的限制，請參閱通道的檔。

若要控制 Bot 語音的各種特性，例如語音、速率、音量、發音和音調，請在語音合成標記語言中指定 speak (SSML) 格式。