距离检测

在鲸孪生组件中，我们可以设置“距离检测”，距离检测指的是“参考对象”和“检测对象”之间的距离，设置完成后我们还需要为“参考对象”添加具体的交互，这样当距离检测满足条件时，就会自动触发交互，从而实现预设效果。

1. 设置参考对象

只有鲸孪生中的部分模型组件可以被设置为“参考对象”，它们的样式设置中都有“距离检测设置项”，常见类型有建筑物、交通工具、室外装饰、人和动物等。

打开一个添加了鲸孪生组件的项目，双击进入鲸孪生组件的“编辑模式”。

在左侧“组件图层”中点击“模型层”，选中需要设置距离检测的模型，然后在右侧的样式中打开“距离检测”的开关，如下图所示：

2. 设置检测对象

鲸孪生中添加的绝大部分组件都可以被设置为检测对象，“模型”和“相机”经常被作为检测对象来使用，而鲸孪生组件中共有四种类型的相机，分别是鸟瞰相机、跟随相机、漫游相机、第一人称相机，它们都支持被选定为检测对象。

当我们打开参考对象的“距离检测设置项”后，点击左侧的三角形图标展开“检测对象”的具体设置：

在下拉框中选择需要绑定的检测对象，如下图所示：

备注：“主相机”指的是当前场景设置的默认相机，该相机可以是鸟瞰相机、跟随相机、漫游相机、第一人称相机中的一种，“主相机”可以通过选中“场景”然后在右侧进行设置。

3. 设置交互

当打开参考对象的距离检测设置并选择“检测对象”后，我们还需要为参考对象添加具体的交互，当参考对象与检测对象之间的距离满足条件时，就会自动触发交互，从而实现预设效果。

距离检测的交互触发方式为“距离检测对象靠近时”和“距离检测对象远离时”，如下图所示：

接下来将演示如何通过设置“距离检测”来触发交互，从而实现“弹窗的自动打开/关闭”和“模型的显示/隐藏”这两种效果。

3.1 控制弹窗的打开/关闭

首先点击左侧菜单栏中的“标绘”，添加一个标记，如下图所示：

然后点击右上角“退出编辑”按钮，退出鲸孪生的“编辑模式”，点击左侧菜单栏的“控件”，添加一个“弹窗”组件，并更改弹窗的标题和内容，如下图所示：

双击再次进入鲸孪生的“编辑模式”，选中刚刚添加的标记点，在右侧样式设置中打开“标记面板”开关，在“选择弹窗”中选择我们刚刚添加的弹窗，将弹窗绑定到标记点上，如下图所示：

然后点击左侧菜单栏中的“模型”，选择“交通工具”，添加一个小车模型，这个小车模型将作为“检测对象”。

选中这个小车模型，点击菜单栏中的“动效”，为小车添加一个路径动画。（路径动画设置相关教程请移步 →路径动画）

路径动画设置效果如下图所示：

接着选中需要添加交互的参考对象，这里以“建筑 2”模型作为演示，打开右侧的“距离检测”开关，并将检测对象设置为“俩厢车白 2”，如下图所示：

在上方切换到“交互”窗口，点击“添加交互”按钮，如下图所示。

首先添加一个新的交互用来打开弹窗，将触发选项设置为“检测对象靠近时”，距离设置为“40m”，动作选项设置为“控制弹窗”，选择弹窗设置为“弹窗 2”，操作选择“打开弹窗”，最后点击“确认”按钮完成交互的添加，如下图所示：

然后再添加一个新的交互用来关闭弹窗，触发选项设置为“检测对象远离时”，距离设置为“60m”，动作选项设置为“控制弹窗”，选择弹窗设置“弹窗 2”，操作选择“关闭弹窗”，顺序选择“在上一动作之后”，最后点击“确认”按钮完成交互的添加，如下图所示：

随着小车运动，当“建筑 2”和“俩厢车白 2”之间的距离小于 40 时，触发第一个交互，自动弹出弹窗，随着小车继续运动，当“建筑 2”和“俩厢车白 2”之间的距离大于 60 时，触发第二个交互，自动关闭弹窗，如下图所示：

3.2 控制模型的显示/隐藏

选中“建筑 3”模型，添加一个新的状态，在这个状态中，将“是否显示”开关关闭，达到隐藏的效果，如下图所示：

首先切换回“默认状态”，添加一个新的交互，触发选项设置为“检测对象靠近时”，距离设置为“60m”，动作选项设置为“切换状态”，目标组件设置为“建筑 3”，状态设置为“隐藏”，最后点击“确认”按钮完成交互的添加，如下图所示：

然后切换到“隐藏状态”再添加一个新的交互，触发选项设置为“检测对象远离时”，距离设置为“80m”，动作选项设置为“切换状态”，目标组件设置为“建筑 3”，状态设置为“默认状态”，最后点击“确认”按钮完成交互的添加，如下图所示：

随着小车运动，当“建筑 3”和“俩厢车白 2”之间的距离小于 60 时，触发第一个交互，自动切换为“隐藏状态”，建筑 3 模型隐藏。随着小车继续运动，当“建筑 1”和“俩厢车白 2”之间的距离大于 80 时，触发第二个交互，自动切换回“默认状态”，建筑 3 模型重新显示，如下图所示：