ChannelServiceHandler 類別

public ChannelServiceHandler(CredentialProvider credentialProvider, AuthenticationConfiguration authConfiguration, ChannelProvider channelProvider)

使用認證提供者，初始化 ChannelServiceHandler 類別的新實例。

參數:

protected ChannelProvider getChannelProvider()

取得實作 ChannelProvider 的通道提供者。

傳回:

public CompletableFuture handleCreateConversation(String authHeader, ConversationParameters parameters)

建立新的交談。

參數:

傳回:

public CompletableFuture handleDeleteActivity(String authHeader, String conversationId, String activityId)

刪除現有的活動。

參數:

傳回:

public CompletableFuture handleDeleteConversationMember(String authHeader, String conversationId, String memberId)

從交談中刪除成員。

參數:

傳回:

public CompletableFuture> handleGetActivityMembers(String authHeader, String conversationId, String activityId)

列舉活動的成員。

參數:

傳回:

public CompletableFuture> handleGetConversationMembers(String authHeader, String conversationId)

列舉交談的成員。

參數:

傳回:

public CompletableFuture handleGetConversationPagedMembers(String authHeader, String conversationId, Integer pageSize, String continuationToken)

一次列舉一頁交談的成員。

參數:

傳回:

public CompletableFuture handleGetConversations(String authHeader, String conversationId, String continuationToken)

列出 Bot 參與的交談。

參數:

傳回:

public CompletableFuture handleReplyToActivity(String authHeader, String conversationId, String activityId, Activity activity)

傳送回復至活動。

參數:

傳回:

public CompletableFuture handleSendConversationHistory(String authHeader, String conversationId, Transcript transcript)

上傳交談的歷史活動。

參數:

傳回:

public CompletableFuture handleSendToConversation(String authHeader, String conversationId, Activity activity)

將活動傳送至交談結尾。

參數:

傳回:

public CompletableFuture handleUpdateActivity(String authHeader, String conversationId, String activityId, Activity activity)

編輯先前傳送的現有活動。

參數:

傳回:

public CompletableFuture handleUploadAttachment(String authHeader, String conversationId, AttachmentData attachmentUpload)

在處理企業時，將數據儲存在符合規範的存放區中。

參數:

傳回:

protected CompletableFuture onCreateConversation(ClaimsIdentity claimsIdentity, ConversationParameters parameters)

CreateConversation（） API。 覆寫此方法以建立新的 Conversation。 POST 至此方法時，使用 * Bot 作為建立交談的 Bot * IsGroup 設為 true，如果這不是直接訊息 （預設實例為 false） * 陣組，其中包含要包含在交談中的成員。傳回值是 ResourceResponse，其中包含適合用於訊息承載和 REST API URI 的交談 D。 大部分通道只支援 Bot 起始直接訊息交談的語意。 如何執行此作業的範例為：var resource = connector.getconversations（）。CreateConversation（new ConversationParameters（）{ Bot = bot， members = new ChannelAccount[] { new ChannelAccount（“user1”） } ; connect.getConversations（）。OnSendToConversation（resource.getId（）， new Activity（） ... ;結束。

參數:

傳回:

protected CompletableFuture onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

OnDeleteActivity（） API。 覆寫此方法以刪除現有的活動。 某些通道可讓您刪除現有的活動，如果成功，這個方法將會移除指定的活動。

參數:

傳回:

protected CompletableFuture onDeleteConversationMember(ClaimsIdentity claimsIdentity, String conversationId, String memberId)

DeleteConversationMember（） 技能 API。 覆寫此方法以刪除交談中的成員。 此 REST API 會採用 ConversationId 和 memberId（類型為 String），並從交談中移除該成員。 如果該成員是交談的最後一個成員，也會刪除交談。

參數:

傳回:

protected CompletableFuture> onGetActivityMembers(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

OnGetActivityMembers（） API。 覆寫此方法以列舉活動的成員。 此 REST API 會採用 ConversationId 和 ActivityId，傳回 ChannelAccount 物件的陣列，代表交談中特定活動的成員。

參數:

傳回:

protected CompletableFuture> onGetConversationMembers(ClaimsIdentity claimsIdentity, String conversationId)

GetConversationMembers（） 技能 API。 覆寫此方法以列舉交談的成員。 此 REST API 會取得 ConversationId，並傳回代表交談成員的 ChannelAccount 物件陣列。

參數:

傳回:

protected CompletableFuture onGetConversationPagedMembers(ClaimsIdentity claimsIdentity, String conversationId, Integer pageSize, String continuationToken)

GetConversationPagedMembers（） 技能 API。 覆寫此方法，以一次列舉一頁交談的成員。 此 REST API 會採用 ConversationId。 您可以選擇提供 pageSize 和/或 continuationToken。 它會傳回 PagedMembersResult，其中包含 ChannelAccounts 陣列，代表交談的成員和可用來取得更多值的接續令牌。 每個呼叫都會傳回 ChannelAccounts 記錄的一頁。 頁面中的記錄數目可能會因通道和呼叫而有所不同。 pageSize 參數可用來做為建議。 如果沒有其他結果，回應將不會包含接續令牌。 如果交談中沒有任何成員，則成員在回應中將會是空的或不存在的。 對先前要求具有接續令牌的要求回應，可能很少會從先前的要求傳回成員。

參數:

傳回:

protected CompletableFuture onGetConversations(ClaimsIdentity claimsIdentity, String conversationId, String continuationToken)

OnGetConversations（） 技能 API。 覆寫此方法以列出此 Bot 參與的交談。 使用 skip Token 從這個方法取得 傳回值是 ConversationsResult，其中包含 ConversationMembers 和 skip Token 的陣列。 如果略過令牌不是空的，則會傳回其他值。 使用傳回的令牌再次呼叫這個方法，以取得更多值。 每個 ConversationMembers 物件都包含交談的 D，以及描述交談成員的 ChannelAccounts 陣列。

參數:

傳回:

protected CompletableFuture onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

OnReplyToActivity（） API。 覆寫此方法允許回復活動。 這與 SendToConversation（稍有不同）。 * SendToConversation（conversationId） - 會根據通道的時間戳或語意，將活動附加至交談結尾。 * ReplyToActivity（conversationId，ActivityId） - 如果通道支持活動，請將活動新增為另一個活動的回復。 如果通道不支援巢狀回復，ReplyToActivity 會回復為 SendToConversation。 在回復交談中的特定活動時，請使用 ReplyToActivity。 在所有其他情況下使用 SendToConversation。

參數:

傳回:

protected CompletableFuture onSendConversationHistory(ClaimsIdentity claimsIdentity, String conversationId, Transcript transcript)

SendConversationHistory（） 技能 API。 將此方法覆寫至此方法，可讓您將歷史活動上傳至交談。 傳送者必須確保歷史活動具有唯一標識碼和適當的時間戳。 用戶端會使用標識碼來處理重複的活動，而用戶端會使用時間戳，以正確的順序轉譯活動。

參數:

傳回:

protected CompletableFuture onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

適用於技能的 SendToConversation（） API。 這個方法可讓您將活動傳送至交談結尾。 這與 ReplyToActivity（） 稍有不同。 * SendToConversation（conversationId） - 會根據通道的時間戳或語意，將活動附加至交談結尾。 * ReplyToActivity（conversationId，ActivityId） - 如果通道支持活動，請將活動新增為另一個活動的回復。 如果通道不支援巢狀回復，ReplyToActivity 會回復為 SendToConversation。 在回復交談中的特定活動時，請使用 ReplyToActivity。 在所有其他情況下使用 SendToConversation。

參數:

傳回:

protected CompletableFuture onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

OnUpdateActivity（） API。 覆寫此方法以編輯先前傳送的現有活動。 某些通道可讓您編輯現有的活動，以反映 Bot 交談的新狀態。 例如，您可以在某人按兩下 [核准] 按鈕之後移除按鈕。

參數:

傳回:

protected CompletableFuture onUploadAttachment(ClaimsIdentity claimsIdentity, String conversationId, AttachmentData attachmentUpload)

UploadAttachment（） API。 覆寫此方法，以在處理企業時將數據儲存在相容的存放區中。 回應是 ResourceResponse，其中包含適合用於附件 API 的 AttachmentId。

參數:

傳回: