TurnContext 类

参考

创建新的 TurnContext 实例。 :p aram adapter_or_context：:p aram 请求：

构造函数

TurnContext(adapter_or_context, request: Activity = None)

参数

名称	说明
adapter_or_context 必需
request	默认值: None

方法

apply_conversation_reference	使用对话引用中的传递信息更新活动。在传入活动get_conversation_reference后调用此消息将正确解决对接收活动的回复。 :p aram 活动：:p aram 引用：:p aram is_incoming：：return：
copy_to	当此 TurnContext 实例传递到新 TurnContext 实例的构造函数时调用。可以在派生类中重写。 :p aram 上下文：：return：
delete_activity	删除现有活动。 :p aram id_or_reference：：return：
get
get_conversation_reference	返回活动的会话引用。这可以保存为普通的旧 JSON 对象，然后稍后用于主动向用户发送消息。用法示例：reference = TurnContext.get_conversation_reference（context.request） :p aram 活动：：return：
get_mentions
get_reply_conversation_reference
has	返回 True 为 set（）已为键调用。缓存的值可能的类型为“None”。 :p aram 键：：return：
on_delete_activity	注册要通知的处理程序，并可能截获正在删除的活动。 :p aram 处理程序：：return：
on_send_activities	注册要通知的处理程序，并可能截获发送活动。 :p aram 处理程序：：return：
on_update_activity	注册要通知的处理程序，并可能截获正在更新的活动。 :p aram 处理程序：：return：
remove_mention_text
remove_recipient_mention
send_activities
send_activity	向用户发送单个活动或消息。 :p aram activity_or_text：：return：
send_trace_activity
set	缓存当前轮次生存期的值。 :p aram 键：:p aram 值：：return：
update_activity	替换现有活动。 :p aram 活动：：return：

apply_conversation_reference

使用对话引用中的传递信息更新活动。在传入活动get_conversation_reference后调用此消息将正确解决对接收活动的回复。 :p aram 活动：:p aram 引用：:p aram is_incoming：：return：

static apply_conversation_reference(activity: Activity, reference: ConversationReference, is_incoming: bool = False) -> Activity

参数

名称	说明
activity 必需
reference 必需
is_incoming	默认值: False

copy_to

当此 TurnContext 实例传递到新 TurnContext 实例的构造函数时调用。可以在派生类中重写。 :p aram 上下文：：return：

copy_to(context: TurnContext) -> None

参数

名称	说明
context 必需

delete_activity

删除现有活动。 :p aram id_or_reference：：return：

async delete_activity(id_or_reference: str | ConversationReference)

参数

名称	说明
id_or_reference 必需

get

get(key: str) -> object

参数

名称	说明
key 必需

get_conversation_reference

返回活动的会话引用。这可以保存为普通的旧 JSON 对象，然后稍后用于主动向用户发送消息。

用法示例：reference = TurnContext.get_conversation_reference（context.request） :p aram 活动：：return：

static get_conversation_reference(activity: Activity) -> ConversationReference

参数

名称	说明
activity 必需

get_mentions

static get_mentions(activity: Activity) -> List[Mention]

参数

名称	说明
activity 必需

get_reply_conversation_reference

static get_reply_conversation_reference(activity: Activity, reply: ResourceResponse) -> ConversationReference

参数

名称	说明
activity 必需
reply 必需

has

返回 True 为 set（）已为键调用。缓存的值可能的类型为“None”。 :p aram 键：：return：

has(key: str) -> bool

参数

名称	说明
key 必需

on_delete_activity

注册要通知的处理程序，并可能截获正在删除的活动。 :p aram 处理程序：：return：

on_delete_activity(handler) -> TurnContext

参数

名称	说明
handler 必需

on_send_activities

注册要通知的处理程序，并可能截获发送活动。 :p aram 处理程序：：return：

on_send_activities(handler) -> TurnContext

参数

名称	说明
handler 必需

on_update_activity

注册要通知的处理程序，并可能截获正在更新的活动。 :p aram 处理程序：：return：

on_update_activity(handler) -> TurnContext

参数

名称	说明
handler 必需

remove_mention_text

static remove_mention_text(activity: Activity, identifier: str) -> str

参数

名称	说明
activity 必需
identifier 必需

remove_recipient_mention

static remove_recipient_mention(activity: Activity) -> str

参数

名称	说明
activity 必需

send_activities

async send_activities(activities: List[Activity]) -> List[ResourceResponse]

参数

名称	说明
activities 必需

send_activity

向用户发送单个活动或消息。 :p aram activity_or_text：：return：

async send_activity(activity_or_text: Activity | str, speak: str = None, input_hint: str = None) -> ResourceResponse | None

参数

名称	说明
activity_or_text 必需
speak	默认值: None
input_hint	默认值: None

send_trace_activity

async send_trace_activity(name: str, value: object = None, value_type: str = None, label: str = None) -> ResourceResponse

参数

名称	说明
name 必需
value	默认值: None
value_type	默认值: None
label	默认值: None

set

缓存当前轮次生存期的值。 :p aram 键：:p aram 值：：return：

set(key: str, value: object) -> None

参数

名称	说明
key 必需
value 必需

update_activity

替换现有活动。 :p aram 活动：：return：

async update_activity(activity: Activity)

参数

名称	说明
activity 必需