编译器定义(Compiler Defines)

realvirtual.io 使用一些编译器定义(也称为脚本定义符号 Scripting Define Symbols)来管理不同的配置。编译器定义是可以设置的开关,用于定义 C# 源代码的哪些部分被编译或不编译。有时需要使用编译器定义来防止不必要的编译器错误消息。

需要设置哪些编译器定义取决于您购买的资源(realvirtual.io Starter、realvirtual.io Professional)。

大多数编译器定义通常在安装 realvirtual.io 资源时自动创建。您可以通过选择 Tools > realvirtual > Apply standard settings 来重置 realvirtual.io 设置,包括编译器定义:

您可以在 File > Build Settings > Player Settings > Other Settings > Scripting Define Symbols: 下找到当前的编译器定义

编译定义(示例设置 - 仅使用安装中所需的内容)
ℹ️

某些接口需要特殊的编译器定义(Compiler Defines)——这在接口文档页面上有说明。

以下是使用的编译器定义列表和说明。(2022年之前 - GAME4AUTOMATION)

编译器定义(Compiler Define)描述
REALVIRTUAL需要设置以启用 realvirtual.io Standard 和 Professional 的标准编译器定义
REALVIRTUAL_PROFESSIONAL仅需要为 realvirtual.io Professional 设置的编译器定义。realvirtual.io Professional 的编译器定义标准设置是 GAME4AUTOMATION; GAME4AUTOMATION_PROFESSIONAL
REALVIRTUAL_PLAYMAKER需要设置此编译器定义才能使用 realvirtual.io Playmaker 节点。这些节点仅包含在 Professional 版本中。只有在安装 Playmaker 后才应设置此定义。参见 https://github.com/game4automation/doc/tree/doc/advanced-topics/broken-reference/README.md
OPCUA4UNITYOPCUA (Pro) 的编译器定义
REALVIRTUAL_VISCUALSCRIPTING如果已安装 Unity Visual Scripting 包且应由 realvirtual.io 使用,则设置此编译器定义。参见 Unity Visual Scripting
CINEMACHINE如果已安装 Unity的 Cinemachine 且应使用,则设置此编译器定义。
REALVIRTUAL_AGX如果已安装 AGX Unity Plugin,则在 realvirtual.io 中启用 AGX 物理仿真功能
REALVIRTUAL_BESTHTTP对于基于 BestHTTPV2 的接口(如 TwinCAT HMI (Pro)MQTT (Pro))需要
REALVIRTUAL_BESTMQTT对于基于 BESTMQTT v1 的接口(如 MQTT (Pro))需要
REALVIRTUAL_JSON对于基于 JSON的接口(如 TwinCAT HMI (Pro))需要
REALVIRTUAL_BESTHTTP3对于基于 BestHTTP V3 的接口(如 TwinCAT HMI (Pro)MQTT (Pro))需要
REALVIRTUAL_BESTMQTT3对于基于 BESTMQTT V3 的接口(如 MQTT (Pro))需要
REALVIRTUAL_CUTTER用于 Cutter 组件
REALVIRTUAL_TEST如果应使用 测试自动化 且已安装 Unity Test Framework,则需要设置
REALVIRTUAL_BURST如果在 运动学工具(Kinematic Tool) 中应使用接触检测且已安装 Unity Burst Compiler 包,则需要设置