Activity クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アクティビティは、Bot Framework 3.0 プロトコルの基本的な通信の種類です。
public class Activity : Microsoft.Bot.Schema.ICommandActivity, Microsoft.Bot.Schema.ICommandResultActivity, Microsoft.Bot.Schema.IContactRelationUpdateActivity, Microsoft.Bot.Schema.IConversationUpdateActivity, Microsoft.Bot.Schema.IEndOfConversationActivity, Microsoft.Bot.Schema.IEventActivity, Microsoft.Bot.Schema.IHandoffActivity, Microsoft.Bot.Schema.IInstallationUpdateActivity, Microsoft.Bot.Schema.IInvokeActivity, Microsoft.Bot.Schema.IMessageDeleteActivity, Microsoft.Bot.Schema.IMessageReactionActivity, Microsoft.Bot.Schema.IMessageUpdateActivity, Microsoft.Bot.Schema.ISuggestionActivity, Microsoft.Bot.Schema.ITraceActivity, Microsoft.Bot.Schema.ITypingActivity
type Activity = class
interface IActivity
interface IConversationUpdateActivity
interface IContactRelationUpdateActivity
interface IInstallationUpdateActivity
interface IMessageActivity
interface IMessageUpdateActivity
interface IMessageDeleteActivity
interface IMessageReactionActivity
interface ISuggestionActivity
interface ITypingActivity
interface IEndOfConversationActivity
interface IEventActivity
interface IInvokeActivity
interface ITraceActivity
interface IHandoffActivity
interface ICommandActivity
interface ICommandResultActivity
Public Class Activity
Implements ICommandActivity, ICommandResultActivity, IContactRelationUpdateActivity, IConversationUpdateActivity, IEndOfConversationActivity, IEventActivity, IHandoffActivity, IInstallationUpdateActivity, IInvokeActivity, IMessageDeleteActivity, IMessageReactionActivity, IMessageUpdateActivity, ISuggestionActivity, ITraceActivity, ITypingActivity
- 継承
-
Activity
- 実装
-
IActivity ICommandActivity ICommandResultActivity IContactRelationUpdateActivity IConversationUpdateActivity IEndOfConversationActivity IEventActivity IHandoffActivity IInstallationUpdateActivity IInvokeActivity IMessageActivity IMessageDeleteActivity IMessageReactionActivity IMessageUpdateActivity ISuggestionActivity ITraceActivity ITypingActivity
注釈
Activity クラスには、個々のより具体的なアクティビティに含めることができるすべてのプロパティが含まれます。 これはスーパーセット型です。
コンストラクター
フィールド
ContentType |
メディアの種類のリソースを識別する Activity HTTP |
プロパティ
Action |
contactRelationUpdate の受信者が送信者の連絡先リストに追加されたか、送信者の連絡先リストから削除されたかを示す文字列を取得または設定します。 |
AttachmentLayout |
複数の添付ファイルのレイアウト ヒントを取得または設定します。 既定値: list。 指定できる値は、 によって定義されます AttachmentLayoutTypes。 |
Attachments |
アクティビティの添付ファイルを取得または設定します。 |
CallerId |
ボットの呼び出し元を識別する IRI を含む文字列を取得または設定します。 このフィールドは、ネットワーク経由で送信されるものではありません。その代わりに、呼び出し元 (トークンなど) の ID をアサートする暗号的に検証可能なデータに基づいて、ボットとクライアントによって設定されます。 |
ChannelData |
チャネル固有のコンテンツを取得または設定します。 |
ChannelId |
チャネルを一意に識別する ID を取得または設定します。 チャネルによって設定されます。 |
Code |
スレッドが終了した理由を示す endOfConversation アクティビティのコードを取得または設定します。 指定できる値は、 で EndOfConversationCodes定義されます。 |
Conversation |
アクティビティが属する会話を取得または設定します。 |
DeliveryMode |
アクティビティの受信者の代替配信パスに通知する配信ヒントを取得または設定します。 既定の配信モードは "default" です。 指定できる値は、 で DeliveryModes定義されます。 |
Entities |
メッセージに記載されたエンティティを取得または設定します。 |
Expiration |
アクティビティが "期限切れ" と見なされ、受信者に表示されない時刻を取得または設定します。 |
From |
メッセージの送信者を取得または設定します。 |
HistoryDisclosed |
チャネルの以前の履歴が開示されるかどうかを示す値を取得または設定します。 |
Id |
チャネルのアクティビティを一意に識別する ID を取得または設定します。 |
Importance |
アクティビティの重要度を取得または設定します。 指定できる値は、 で ActivityImportance定義されます。 |
InputHint |
メッセージがクライアントに配信された後にボットがユーザー入力を受け入れるか、予期しているか、無視しているかを示す文字列を取得または設定します (「」を参照)。InputHints |
Label |
アクティビティの説明ラベルを取得または設定します。 |
ListenFor |
音声および言語プライミング システムがリッスンするフレーズと参照の一覧を取得または設定します。 |
Locale |
テキスト フィールドの内容の BCP-47 ロケール名を取得または設定します。 |
LocalTimestamp |
ISO-8601 形式で表された、メッセージが送信された日時をローカル時刻で取得または設定します。 たとえば、2016-09-23T13:07:49.4714686-07:00 などです。 |
LocalTimezone |
メッセージのローカル時刻を定義するために使用されるタイムゾーンの名前を IANA タイム ゾーン データベース形式で表す値を取得または設定します。 例: America/Los_Angeles。 |
MembersAdded |
スレッドに追加されたメンバーのコレクションを取得または設定します。 |
MembersRemoved |
スレッドから削除されたメンバーのコレクションを取得または設定します。 |
Name |
呼び出しまたはイベント アクティビティに関連付けられている操作の名前を取得または設定します。 |
Properties |
型によって Activity 定義されていないが、シリアル化された REST JSON オブジェクトに表示される可能性があるプロパティを取得または設定します。 |
ReactionsAdded |
会話に追加されたリアクションのコレクションを取得または設定します。 |
ReactionsRemoved |
スレッドから削除されたリアクションのコレクションを取得または設定します。 |
Recipient |
メッセージの受信者を取得または設定します。 |
RelatesTo |
を別の ConversationReference 会話またはアクティビティに対して取得または設定します。 |
ReplyToId |
このメッセージが応答であるメッセージの ID を取得または設定します。 |
SemanticAction |
この要求に付随するプログラムによるオプションのアクションを取得または設定します。 |
ServiceUrl |
チャネルのサービス エンドポイントを指定する URL を取得または設定します。 チャネルによって設定されます。 |
Speak |
読み上げるテキストを取得または設定します。 |
SuggestedActions |
アクティビティに推奨されるアクションを取得または設定します。 |
Summary |
チャネルがカードをレンダリングできない場合に表示するテキストを取得または設定します。 |
Text |
メッセージのテキスト コンテンツを取得または設定します。 |
TextFormat |
テキスト フィールドの形式を取得または設定します。 既定値: markdown。 指定できる値は、 によって定義されます TextFormatTypes。 |
TextHighlights |
アクティビティに ReplyToId 値が含まれている場合に強調表示するテキスト フラグメントのコレクションを取得または設定します。 |
Timestamp |
ISO-8601 形式で表された、メッセージが送信された日時を UTC で取得または設定します。 |
TopicName |
スレッドの更新されたトピック名を取得または設定します。 |
Type |
アクティビティの種類を取得または設定します。 使用できる値は、'message'、'contactRelationUpdate'、'conversationUpdate'、'typing'、'endOfConversation'、'event'、'invoke'、'deleteUserData'、'messageUpdate'、'messageDelete'、'installationUpdate'、'messageReaction'、'suggestion'、'trace'、'handoff' です。 |
Value |
アクティビティに関連付けられている値を取得または設定します。 |
ValueType |
アクティビティの値オブジェクトの型を取得または設定します。 |
メソッド
ApplyConversationReference(ConversationReference, Boolean) |
このアクティビティを、既存ConversationReferenceの からの配信情報と共に更新します。 |
AsCommandActivity() |
このアクティビティを ICommandActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsCommandResultActivity() |
このアクティビティを ICommandResultActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsContactRelationUpdateActivity() |
このアクティビティを IContactRelationUpdateActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsConversationUpdateActivity() |
このアクティビティを IConversationUpdateActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsEndOfConversationActivity() |
このアクティビティを IEndOfConversationActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsEventActivity() |
このアクティビティを IEventActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsHandoffActivity() |
このアクティビティを IHandoffActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsInstallationUpdateActivity() |
このアクティビティを IInstallationUpdateActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsInvokeActivity() |
このアクティビティを IInvokeActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsMessageActivity() |
このアクティビティを IMessageActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsMessageDeleteActivity() |
このアクティビティを IMessageDeleteActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsMessageReactionActivity() |
このアクティビティを IMessageReactionActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsMessageUpdateActivity() |
このアクティビティを IMessageUpdateActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsSuggestionActivity() |
このアクティビティを ISuggestionActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsTraceActivity() |
このアクティビティを ITraceActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
AsTypingActivity() |
このアクティビティを ITypingActivity オブジェクトとして返します。その種類のアクティビティでない場合は null を返します。 |
CreateContactRelationUpdateActivity() |
クラスのインスタンスを Activity オブジェクトとして IContactRelationUpdateActivity 作成します。 |
CreateConversationUpdateActivity() |
クラスのインスタンスを Activity オブジェクトとして IConversationUpdateActivity 作成します。 |
CreateEndOfConversationActivity() |
クラスのインスタンスを Activity オブジェクトとして IEndOfConversationActivity 作成します。 |
CreateEventActivity() |
クラスのインスタンスを Activity オブジェクトとして IEventActivity 作成します。 |
CreateHandoffActivity() |
クラスのインスタンスを Activity オブジェクトとして IHandoffActivity 作成します。 |
CreateInvokeActivity() |
クラスのインスタンスを Activity オブジェクトとして IInvokeActivity 作成します。 |
CreateMessageActivity() |
クラスのインスタンスを Activity オブジェクトとして IMessageActivity 作成します。 |
CreateReply(String, String) |
このアクティビティへの応答として新しいメッセージ アクティビティを作成します。 |
CreateTrace(String, Object, String, String) |
このアクティビティに基づいて新しいトレース アクティビティを作成します。 |
CreateTraceActivity(String, String, Object, String) |
クラスのインスタンスを Activity オブジェクトとして ITraceActivity 作成します。 |
CreateTypingActivity() |
クラスのインスタンスを Activity オブジェクトとして ITypingActivity 作成します。 |
GetChannelData<TypeT>() |
このアクティビティのチャネル データを厳密に型指定されたオブジェクトとして取得します。 |
GetConversationReference() |
このアクティビティに基づいて を ConversationReference 作成します。 |
GetMentions() |
このアクティビティのエンティティからのメンションを解決します。 |
GetReplyConversationReference(ResourceResponse) |
このアクティビティの会話情報と、アクティビティの送信からの ResourceResponse に基づいて ConversationReference を作成します。 |
HasContent() |
このアクティビティにコンテンツがあるかどうかを示します。 |
IsActivity(String) |
このアクティビティが指定されたアクティビティの種類であるかどうかを示します。 |
IsFromStreamingConnection() |
アクティビティが Http/Https 接続またはストリーミング経由で送信されたかどうかを確認します。これは、ServiceUrl プロパティを調べることで判断できます。(1) http/https 経由でメッセージを送信するすべてのチャネルがストリーミングを行っていない (2) ストリーミング経由でメッセージを送信するチャネルには、http/https で始まらない ServiceUrl があります。 |
TryGetChannelData<TypeT>(TypeT) |
このアクティビティのチャネル データを厳密に型指定されたオブジェクトとして取得します。 戻り値は、操作が成功したかどうかを表します。 |
拡張メソッド
TeamsGetChannelId(IActivity) |
現在のアクティビティからチームのチャネル ID を取得します。 |
TeamsGetMeetingInfo(IActivity) |
現在のアクティビティから TeamsMeetingInfo オブジェクトを取得します。 |
TeamsGetSelectedChannelId(IActivity) |
現在のアクティビティからチームの選択したチャネル ID を取得します。 |
TeamsGetTeamInfo(IActivity) |
現在のアクティビティから TeamsInfo オブジェクトを取得します。 |
TeamsNotifyUser(IActivity) |
Teams 内で通知を生成するように現在のアクティビティを構成します。 |
TeamsNotifyUser(IActivity, Boolean, String) |
Teams 内で通知を生成するように現在のアクティビティを構成します。 |
MentionsId(IMessageActivity, String) |
Text プロパティに ID のメンションはありますか。 |
MentionsRecipient(IMessageActivity) |
Text プロパティに Recipient.Id の言及はありますか。 |
RemoveMentionText(IMessageActivity, String) |
指定された ID のメンション テキストを Activity.Text プロパティから削除します。 たとえば、Hi Bot というメッセージ @echoBot を指定すると、"@echoBot" が削除され、"Hi Bot" は残ります。 |
RemoveRecipientMention(IMessageActivity) |
Text プロパティから受信者のメンション テキストを削除します。 この関数はアクティビティのテキストを変更するため、注意して使用してください。 |
GetLocale(IActivity) |
アクティビティのロケールを取得します。 |
SetLocale(IActivity, String) |
アクティビティのロケールを設定します。 |