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)

会話のメンバーを一度に 1 ページずつ列挙します。

パラメーター:

戻り値:

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

ボットが参加した会話を一覧表示します。

パラメーター:

戻り値:

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。 新しい会話を作成するには、このメソッドをオーバーライドします。 *ボットが会話を作成するボットである * ボットを使用してこのメソッドに POST します。これが直接メッセージではない場合は IsGroup が true に設定されます (既定の instanceof false) * 会話に含めるメンバーを含む配列。戻り値は、メッセージ ペイロードと REST API URI で使用するのに適した会話 D を含む ResourceResponse です。 ほとんどのチャネルでは、直接メッセージの会話を開始するボットのセマンティクスのみがサポートされます。 その方法の例として、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 for Skill。 会話からメンバーを削除するには、このメソッドをオーバーライドします。 この 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 for Skill。 会話のメンバーを一度に 1 ページずつ列挙するには、このメソッドをオーバーライドします。 この REST API は ConversationId を受け取ります。 必要に応じて、pageSize または continuationToken を指定できます。 これは、会話のメンバーを表す ChannelAccounts の配列と、より多くの値を取得するために使用できる継続トークンを含む PagedMembersResult を返します。 呼び出しごとに ChannelAccounts レコードの 1 ページが返されます。 ページ内のレコードの数は、チャネルと呼び出しによって異なる場合があります。 pageSize パラメーターは、候補として使用できます。 追加の結果がない場合、応答には継続トークンは含まれません。 会話にメンバーが存在しない場合、メンバーは空であるか、応答に存在しません。 前の要求からの継続トークンを持つ要求に対する応答では、前の要求からメンバーを返す可能性はほとんどありません。

パラメーター:

戻り値:

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

スキル用の OnGetConversations() API。 このメソッドをオーバーライドして、このボットが参加した会話を一覧表示します。 スキップ トークンを持つこのメソッドからの GET 戻り値は ConversationsResult であり、ConversationMembers の配列とスキップ トークンが含まれています。 スキップ トークンが空でない場合は、さらに値が返されます。 返されたトークンを使用してこのメソッドをもう一度呼び出して、より多くの値を取得します。 各 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 for Skill。 このメソッドをこのメソッドにオーバーライドすると、履歴アクティビティを会話にアップロードできます。 送信者は、履歴アクティビティに一意の ID と適切なタイムスタンプがあることを確認する必要があります。 ID は、重複するアクティビティを処理するためにクライアントによって使用され、タイムスタンプはクライアントによって適切な順序でアクティビティをレンダリングするために使用されます。

パラメーター:

戻り値:

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

SendToConversation() API for Skill。 このメソッドを使用すると、会話の最後にアクティビティを送信できます。 これは ReplyToActivity() とは少し異なります。 * SendToConversation(conversationId) - チャネルのタイムスタンプまたはセマンティクスに従って、アクティビティを会話の最後に追加します。 * ReplyToActivity(conversationId,ActivityId) - チャネルでサポートされている場合は、アクティビティを別のアクティビティへの応答として追加します。 チャネルが入れ子になった応答をサポートしていない場合、ReplyToActivity は SendToConversation にフォールバックします。 会話内の特定のアクティビティに返信する場合は、ReplyToActivity を使用します。 SendToConversation は、他のすべてのケースで使用します。

パラメーター:

戻り値:

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

OnUpdateActivity() API。 以前に送信された既存のアクティビティを編集するには、このメソッドをオーバーライドします。 一部のチャネルでは、ボットの会話の新しい状態を反映するように既存のアクティビティを編集できます。 たとえば、他のユーザーが [承認] ボタンをクリックした後にボタンを削除できます。

パラメーター:

戻り値:

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

UploadAttachment() API。 企業を扱うときに準拠ストアにデータを格納するには、このメソッドをオーバーライドします。 応答は、AttachmentId を含む ResourceResponse であり、添付ファイル API での使用に適しています。

パラメーター:

戻り値: