说话者 ID 管理

从 Unreal Blueprints 中创建、列出和删除 Speaker ID 记录，使每个玩家在会话之间保持稳定的记忆身份。

Speaker ID 是 Convai 身份记录，用于长期记忆工作流。每个玩家创建一条记录，保存其 SpeakerID，并将该值分配为 EndUserID ，在开始会话之前。有关分配步骤，请参阅 最终用户身份.

FConvaiSpeakerInfo

FConvaiSpeakerInfo 是由 Convai 创建 Speaker ID 和 Convai 列出 Speaker ID.

字段	类型	描述
SpeakerID	FString	Convai 分配的标识符。请保存此值并将其再次用作 EndUserID.
名称	FString	Convai 返回的发言人名称。
DeviceID	FString	Convai 返回的设备 ID。未提供或未返回设备 ID 时为空。

创建一个 Speaker ID

使用 Convai 创建 Speaker ID 在首次创建玩家配置文件时。

1

添加该节点

在配置文件设置期间运行的 Blueprint 中，添加 Convai 创建 Speaker ID 来自 Convai|LTM 类别下的字段中。

2

设置输入

设置 Speaker 名称 为非空的玩家显示名称。将 Device Id 如果可用，则设置为稳定的设备或账户标识符。

如果 Speaker 名称 为空时，插件会记录 发言人名称为空 并触发 On Failure ，然后再发送请求。

3

持久化结果

在 成功时，拆分返回的 FConvaiSpeakerInfo 并保存 SpeakerID 到你的 SaveGame 或账户配置文件中加载。

在后续启动时，加载已保存的值并跳过记录创建。

不要在游戏每次启动时都创建新的 Speaker ID。重复创建会为同一玩家生成多条记录，这会使身份调试更加困难。

列出 Speaker ID

使用 Convai 列出 Speaker ID 以检查为已配置 API 密钥可用的记录。

1. Add Convai 列出 Speaker ID 来自 Convai|LTM 类别下的字段中。
2. Bind 成功时.
3. 遍历返回的 FConvaiSpeakerInfo 数组。
4. 打印或显示 SpeakerID, 名称，以及 DeviceID.

这对于测试工具、管理面板以及调试共享设备身份问题很有用。

删除一个 Speaker ID

使用 Convai 删除 Speaker ID 当需要移除玩家身份时。

1

选择该记录

找到目标 SpeakerID 从你保存的配置文件数据中，或从 Convai 列出 Speaker ID.

2

调用删除节点

Add Convai 删除 Speaker ID 并设置 Speaker ID 为目标值。

在 成功时，清除已存储的 SpeakerID 从你的保存数据中，以免项目重新使用已删除的身份。

3

如有需要，创建新身份

如果玩家应继续使用 LTM，则创建一个新的 Speaker ID，并将其分配为下一个 EndUserID。参见 最终用户身份.

删除终端用户身份会移除该用户记录以及该用户在所有角色中的相关长期记忆记录。在向玩家或管理员公开此操作之前，请添加确认步骤。

何时使用各项操作

目标	操作
注册首次玩家	Convai 创建 Speaker ID
重用回归玩家的记忆	加载已保存的 SpeakerID；不要再次调用创建
审核身份记录	Convai 列出 Speaker ID
移除测试或用户身份	Convai 删除 Speaker ID
在不删除身份的情况下开始新的对话	ResetConversation()

下一步

最终用户身份LTM Blueprint 参考长期记忆使用示例