模型抓取通用控制

模型抓取通用控制用于给模型增加整体或部件级抓取能力。它可以监听实体被选中、抓取和放开的状态，也可以通过逻辑元控制整个实体或指定部位是否允许抓取。

该资源适合需要学员拿起物体、移动部件、按步骤抓取指定部位的交互训练。

资源文件

项目	内容
分类	交互控制
最新资源	模型抓取通用控制-v1.1.xobj
原始说明	模型抓取通用控制-文档.txt
更新日志	模型抓取通用控制-更新日志.txt
来源目录	00 通用/交互控制/模型抓取通用控制

使用前提

• 课程中已经有需要抓取的模型实体。
• 在属性栏中把模型配置到“可交互的物体”。
• 如果按部位控制抓取，部位名称需要能被事件或行为中的星号匹配。
• 根据训练提示强度配置禁用、可交互、选中和点击状态效果。

参数说明

参数	作用	推荐配置	注意事项
可交互的物体	指定可被选中和抓取的目标模型。	选择当前步骤需要学员操作的模型。	不要把无关装饰模型加入交互对象，避免误触发。
禁用时效果	设置目标不可抓取时的表现。	使用无效果或低强度提示。	禁用表示不能抓取，不表示模型被隐藏。
可交互时效果	设置目标可抓取但未选中时的提示。	使用边缘发光等轻量提示。	提示强度应符合教学或考核阶段要求。
选中时效果	设置目标被输入焦点选中时的表现。	使用描边或高亮，提示当前可抓取对象。	选中不代表已经开始抓取。
点击时效果	设置点击或抓取触发瞬间的反馈。	使用短暂高亮作为操作反馈。	如果课程只关注抓取结果，可主要监听抓取和放开事件。

监听事件

事件	触发条件	典型用途
选中实体	任意一个部位被选中。	显示抓取提示。
取消选中实体	任意一个部位取消选中。	收起抓取提示。
实体被抓取	任意一个部位被抓取。	判断学员开始拿取模型。
实体被放开	任意一个部位被放开。	判断学员结束本次抓取。
选中部位*	指定部位被选中。	对某个部件显示提示。
取消选中部位*	指定部位取消选中。	恢复该部件默认表现。
部位*被抓取	指定部位被抓取。	判断是否抓取了指定部件。
部位*被放开	指定部位被放开。	判断指定部件抓取操作结束。

可执行行为

行为	效果	常见调用时机
禁止抓取实体	禁止所有部位被抓取。	当前步骤不允许操作或答案已确认。
允许抓取实体	允许所有部位被抓取。	进入可操作步骤。
禁止抓取部位*	禁止指定部位被抓取。	某个部件不允许移动或已经完成操作。
允许抓取部位*	允许指定部位被抓取。	分步骤开放指定部件。

使用步骤

1. 将资源导入课程工程。
2. 在属性栏中选择“可交互的物体”。
3. 配置禁用、可交互、选中、点击状态效果。
4. 在逻辑元中监听实体或部位的抓取事件。
5. 需要限制范围时，执行实体级或部位级允许/禁止抓取行为。

常见问题

问题	建议
模型无法被抓取。	检查是否已配置“可交互的物体”，并确认没有执行禁止抓取行为。
部位级控制不生效。	确认星号替换后的部位名称与模型节点名称一致。
只能选中但没有抓取结果。	检查课程逻辑监听的是“实体被抓取”还是“实体被放开”。
完成后仍能重复抓取。	操作完成后执行“禁止抓取实体”或“禁止抓取部位*”。