计算信号：组合多个输入再映射

简体中文 | English

计算信号把多个读数变成可复用结果。选择输入和运算，调整响应，再为结果命名，之后即可在任意输出绑定中选用。本页从常见组合开始，继续说明空间与时间运算。

工作台操作 · 来源与输出

从输入到动作

OSC／定位、手动、脚本、反馈、回放或常量
                   ↓
              具名计算结果
                   ↓
      各输出的范围、曲线与目标 → 一个或多个输出

定位输入选择“定位测量”（SensaPoint），再选对象和指标。例如，SPS 四点定位提供解算后的位置，Contact 提供位置与速度，Shader 还提供轴向和缩放。计算会沿用这些测量的有效性检查。指标含义

每个计算信号有一个固定标识和一个便于辨认的名称。其他计算、轴映射或输出绑定通过标识引用它，所以同一个结果可以用于多个目标。计算结果保留原始数值，之后由每条映射分别转换为需要的动作范围。

在工作台中建立计算

1. 打开 流程，在“计算信号”区点击“新增计算信号”；OSC → 映射也提供同一组计算的编辑入口。
2. 填写便于辨认的名称，选择运算方式，再逐项添加输入。
3. 选择 OSC 参数、定位测量、姿态指标、手动、脚本、设备反馈、录制回放、另一计算或固定数值。参数填写真实路径；定位同时选择对象路径和指标。
4. 在轴映射或输出绑定中选择“计算信号”作为来源，再选择刚建立的计算，设置目标和输入／输出范围。
5. 点击“保存计算与映射”。实时预览随已保存设置计算；检查读数和范围后，再启用当前输入。

保存配置会关闭输入。含定位指标的计算沿用实验空间输入开关和对应定位方案的有效性条件。纯常量计算也要被映射或绑定使用，并启用输入，才会驱动输出。

加权平均：决定每个输入的影响

设输入 A=0.2、B=0.8，权重分别为 1 和 3：

结果 = (0.2 × 1 + 0.8 × 3) ÷ (1 + 3) = 0.65

B 的影响占 75%，A 占 25%。权重可以使用任意非负有限数，只要总和大于零；同时把所有权重乘以相同数，结果保持不变。权重为零的输入不参与此次计算，也不要求它提供样本。

两个输入都按 0～1 表示同类强度时，结果可继续使用 0～1 输入量程。组合不同量程的数据前，先用常量和运算把它们调整到有可比含义的范围。映射中的量程设置作用于最终计算结果。

窄屏输入设置

支持的运算

数值组合支持 1～16 个输入，相减与相除固定为两项；时间与门限处理使用一个输入，正弦波可使用零或一个输入。权重只在加权平均中使用。计算按依赖顺序执行，每个结果在同一次求值中只计算一次；配置最多包含 64 个计算，引用层数最多 16 层。保存时会检查重复标识、缺失引用和循环引用；删除计算前，先调整引用它的计算和映射。

处理时间、门限与事件

timeMs 可设为 0～60000 ms，迟滞关闭阈值不高于开启阈值。正弦频率为 0～100 Hz，幅度、偏移和阈值应为有限数值。设备或绑定的发送频率另行决定结果交付的节奏。

例如，将迟滞设为 0.7 开启、0.5 关闭，可让触碰开关在边界附近保持稳定；用“持续条件”要求接触保持 500 ms；需要事件维持一段时间时使用“脉冲”。边沿和冷却只在一次求值中输出事件，可连接到“正向触发时发送”输出；后端按顺序交付事件，并遵守该绑定的发送频率。

输入失效、切换来源、时钟倒退、重新配置或关闭输入时，时间处理会清除相应历史状态。边沿处理先建立基准，再响应之后的跨阈值变化。延迟保留历史样本时间，额外有效期应覆盖需要的延迟；延迟缓冲最多 4096 项。

使用 Shader 的轴向与缩放

将来源设为定位测量（SensaPoint），填写 Sensa/Shader/42/** 这样的根点路径，再选择 RightX/Y/Z、ForwardX/Y/Z 或 AvatarScale。两条轴保留方向和长度，缩放表示每根局部单位对应的世界米数。来源自动检查完整十二字段、空间输入启用、有效状态与帧时效；冻结后依赖它的计算也会失效。

要把局部 X 位移换算成米，建立“相乘”，输入同一来源的 X 和 AvatarScale，结果采用 AvatarRootMeters。反向换算使用“比值”：米制位移除以 AvatarScale，得到 AvatarRootLocal。也可以用同类轴向分量求向量长度或点积；位置、轴向和缩放分别保留各自的量纲。

组合根点坐标

在“流程 → 计算信号”展开“空间计算预设”，选好运算后点击“新增空间计算”。界面把 XYZ 放在一组：可以填写固定坐标、选择某个定位对象的位置，或选择 Shader 的 Forward／Right 方向；需要组合其他来源时，展开逐分量设置，分别指定 OSC 参数或计算结果。

法线就是垂直于平面的方向。默认 (0,0,1) 表示 XY 平面，+Z 为深度正方向。系统会归一化法线，因此 (0,0,1) 与 (0,0,2) 得到相同结果。两条轴只需确定平面方向；默认 U=(1,0,0)、V=(0,1,0) 得到 +Z 法线。交换 U、V 会翻转深度正负，侧向距离保持不变。

例如，参考点 O=(0,0,0)，测量位置 P=(0.03,0.04,0.12)，法线沿 +Z：

如果位置采用米，以上结果也采用米。已有单点 Distance 指标表示该点到其坐标原点的距离；“两点距离”可以直接选择另一个测量位置作为参照。

下面两张图分别展示实际运行的“测量位置”和“平面朝向”输入组：P=(0.3,0.4,0.2)，N=(0,3,4)。固定坐标用于试算；连接实时测量时，在“三分量来源”中选择对应定位对象。

窄屏位置设置

窄屏朝向设置

让平面跟随 Avatar 动作

Tracking Frame 与 Shader 模板用于自己 Avatar 内测量点与参考对象的相对运动。双方 Avatar 的互动使用接收方 Socket 局部系下的配对三点姿态，可直接选择 SensaPose 的深度比例、入口偏移和角度指标。

在 Unity 添加 Tracking Frame，选择它跟随的骨骼、SPS 根点或标记，调整中心和朝向。它发布 <名称>_Origin、<名称>_Forward、<名称>_Right 三个点的位置。Forward−Origin 给出当前深度方向；骨骼转动后，方向会随实际读数改变。

在工作台展开“空间计算预设 → 跟随移动平面”，定位方式选择 Tracking Frame · Origin / Forward。填写“测量对象路径”和“平面参考对象路径”，例如 Sensa/Contact/Target/** 与 Sensa/Contact/Frame_Origin/**，再点击“添加跟随平面草稿”。模板自动读取同名 _Forward，生成三个方向差值，以及深度和偏移，共 5 个计算；勾选“同时创建两点距离”可再增加一项。检查实例并保存计算与映射，再把结果连接到输出。这样同一个目标可以同时提供深度和偏离中心的反馈。Unity 配置与坐标

定位方式也可选择 Shader · 位置与 Forward 方向，以所选 Shader 的位置为平面中心、Forward 为法线，直接生成深度和偏移两个草稿。

Shader 已提供 Forward／Right 方向，可直接用于法线或两轴平面。例如用 Forward 作法线，深度方向就跟随测得的 Forward：默认姿态下朝 +Z，旋转后随该方向改变；用 Right 与 Forward 作为 U、V 时，默认姿态下法线朝 −Y，调换顺序则朝 +Y。

让输出跟随入口范围

以 Contact 的米制坐标为例，先得到平面深度 D 和平面内偏移 R。需要在目标进入平面且靠近中心时驱动传统轴输出，可组合以下计算：

把“允许输出”映射到门控（关闭则停止）（GateEnable），输入范围设为 0～1，映射范围保留完整的 0～999，并保持正向；另把 D 映射到主轴行程（L0）（Depth），按目标动作设置量程。可在允许输出后追加“持续条件”（Duration），设阈值 0.5、时间 100 ms，再把该结果接到门控，要求条件稳定成立后再开启。上述距离是配置示例，根据测量单位和实际入口大小调整。

GateEnable 控制传统轴映射的停止与恢复；独立输出绑定按各自来源和有效性运行。将深度乘以 0 会得到有效的零目标，需要停止轴输出时使用门控。双方 Avatar 的互动可直接使用配对三点姿态；它按接收方入口范围与姿态判断 Valid 和 Engaged。

坐标、单位与有效输入

参与计算的位置使用同一 OSC 来源、参照、坐标轴和单位。SPS 四点定位与 Shader 的 AvatarRootLocal 使用制作时的 Avatar 根局部单位；Contact 直接定位的 AvatarRootMeters 使用米。系统检查定位来源携带的坐标标识；独立 Point／Handle／Pose 的 ReferenceLocal 按实例区分。先选择相同坐标框，再组合位置；必要时用同一来源的 AvatarScale 完成单位换算。

Shader 的轴向没有位置单位。已知的 AvatarRootLocal 轴向可为 AvatarRootMeters 位置提供方向，因为它们共用 Avatar 根坐标轴。原始 OSC 参数和固定数值由你指定含义，配置时确认它们使用同一参照和单位。长度结果沿用位置单位，角度结果以度表示。

系统还会核对已知输入的物理含义：位置组使用位置坐标，方向组可使用轴向或速度向量。求变化率得到的加速度、角速度等保留各自的单位标识，适合按对应物理量配置后续计算。

零坐标是有效位置。法线或方向向量需要非零长度，两条平面轴需要形成明确夹角；归一化后的叉积长度大于 0.0001 才能确定平面。输入失效、方向无法确定或结果超出有限数值范围时，该计算显示无效，并保留来源的样本时效检查。

三点姿态的角度按读到的数值参与运算；例如 Roll 使用 −180°～180° 的原始角度。动作经过 ±180° 边界时会发生数值跳转，选取连续区间内的量程进行映射；平均值运算采用普通算术平均。

有效结果与样本时效

每个必需输入都应唯一匹配一个参数或一个定位对象。选择“使用来源”可固定要读取的 OSC 来源；多个参数或来源同时匹配时，界面会显示等待或无效的原因，补全路径和来源选择后再检查。

计算的样本时间取所有参与输入中最旧的时间，引用另一计算时继续保留这个时间。“输入有效期（ms）”默认 0，表示沿用 OSC 接收设置，计算本身不额外限制时效。常规 OSC 接收超时默认关闭，适合数值变化时才发送的参数；静止值可继续参与计算。

需要定期确认每项输入更新时，可将计算有效期设为 100～60000 ms。例如设为 1000，任一参与样本超过 1 秒就会使计算失效，其他输入更新不会为它续期。纯常量结果随当前求值有效。定位输入始终遵守其自身的 Sample／Frame、几何和时效检查。

缺失或过期输入、定位失效、除以零和非有限结果都会使相关计算无效；引用它的计算同样失效。计算无效时，相关输出绑定沿依赖关系停止，现有轴映射保留动作运行时的停止规则；输入启用状态保持不变，新的有效样本到达后，联动可自动恢复。需要持续保持停止时，关闭输入或使用急停；配置保存或急停解除后，再明确启用输入。

多条映射指向同一个角色时，现有融合规则按归一化优先级选择结果。要按比例混合多个输入，应先建立加权平均，再把它映射到该角色。功能参考 · 参数字典

普通 SensaPoint／SensaPose 映射优先控制其目标轴，该轴的其他直接映射、计算映射或 DepthOverride 保留这一优先关系。需要先组合或加权定位结果时，用计算信号映射该轴，并替换原来通往同轴的单点／姿态映射。

手动输入使用 L0 等轴名；脚本输入可选 L0、Progress（0～1）或 Time（秒）。设备反馈使用对应输出提供的标识。录制回放中，funscript 使用 录制输出标识/value 提供 0～1 位置；JSON Lines／CSV 使用 录制输出标识/信号标识 读取原始值。组合方式允许这些来源共同参与；OSC 输入仍使用同一选定来源，空间输入保留坐标框相容性检查。来源与目标设置

配置文件示例

通常在工作台配置即可。需要手工编辑时，下面展示对应字段：将 TouchA、TouchB 换成实际参数名，并保留配置中的其他设置。名称最长 80 个字符；计算标识以英文字母开头，可使用字母、数字、下划线和连字符，最长 48 个字符。工作台会自动生成标识。

{
  "computedSignals": [
    {
      "id": "touch_mix",
      "name": "双区域触碰",
      "operation": "WeightedAverage",
      "maxAgeMs": 0,
      "inputs": [
        { "sourceMode": "Direct", "oscPath": "TouchA", "weight": 1 },
        { "sourceMode": "Direct", "oscPath": "TouchB", "weight": 3 }
      ]
    }
  ],
  "signals": [
    {
      "sourceMode": "Computed",
      "oscPath": "touch_mix",
      "role": "V0",
      "vrchatMin": 0,
      "vrchatMax": 1,
      "curve": "Linear"
    }
  ]
}

计算信号保存在 Sensa 配置中；Avatar 继续发送原有 OSC 参数。新的标识用于 Sensa 内部引用。自定义预设保存 OSC 参数和定位映射；流程页可将轴映射、轴配置、计算与输出一起导出为整套方案，导入时先检查再应用。预设 · 整套方案