> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention.md).

# 凝视注意力

凝视注意力允许玩家通过注视带标签的世界对象来引导 Convai 角色的关注。请在 `UConvaiPlayerComponent`中启用它，在道具上添加 `UConvaiObjectComponent`标签，角色即可响应玩家正在注视的内容。

{% hint style="info" %}
凝视注意力建立在场景元数据和角色动作之上。在开始之前，请确认你的关卡具有：

* 至少一个带有 `UConvaiObjectComponent` 以及一个非空的 **名称**记录的警告。请参阅 [场景元数据快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-quick-start.md) 如果你还没有给对象添加标签。
* **启用操作** 在聊天机器人中勾选于 **Convai | 操作** → **环境**记录的警告。请参阅 [角色动作快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/character-actions-quick-start.md) 如果尚未配置动作。
* `UConvaiPlayerComponent` 在玩家 Pawn 上，使用 **启用凝视注意力** 已开启。

这是你第一次接触此功能吗？先从 [凝视注意力的工作原理](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/how-gaze-attention-works.md) 开始，了解完整流程，然后再按照 [凝视注意力快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-quick-start.md).
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>凝视注意力的工作原理</strong><br>了解跟踪流程、注意力提升计时器、组件作用域目标选择以及注意力来源锁定规则。</td><td><a href="/pages/d8a57f062e27764c8ec780df8b4e07d5b4d4282b">/pages/d8a57f062e27764c8ec780df8b4e07d5b4d4282b</a></td></tr><tr><td><strong>凝视注意力快速入门</strong><br>在 Player Component 上启用凝视注意力，并验证当玩家看向带标签的对象时角色会作出响应。</td><td><a href="/pages/c5d49eeda517161a96ea3016fa123bc1694b506f">/pages/c5d49eeda517161a96ea3016fa123bc1694b506f</a></td></tr><tr><td><strong>凝视注意力参考</strong><br>所有凝视注意力组件及其默认值的完整属性、事件、方法和类参考。</td><td><a href="/pages/797ae18ef94bcef2ec7816f079c7a35fb212a26c">/pages/797ae18ef94bcef2ec7816f079c7a35fb212a26c</a></td></tr><tr><td><strong>凝视注意力使用示例</strong><br>关于凝视事件、自定义高亮视觉效果、组件作用域目标选择以及手动注意力锁定的蓝图方案。</td><td><a href="/pages/2f301cf695f654f0b6dc66672ff9462854021237">/pages/2f301cf695f654f0b6dc66672ff9462854021237</a></td></tr><tr><td><strong>排查凝视注意力故障</strong><br>诊断并修复对象未高亮、注意力未提升、光标未出现以及组件作用域凝视不匹配等问题。</td><td><a href="/pages/ca4f4235151ab1fee69bb58487611f1c6ec30cc6">/pages/ca4f4235151ab1fee69bb58487611f1c6ec30cc6</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.