You need to enable JavaScript to run this app. 如何在Unity项目中实现与C#/C/C++脚本的变量双向读写
优惠活动
大模型
产品
解决方案
定价
更多

如何在Unity项目中实现与C#/C/C++脚本的变量双向读写

Unity 与外部/C# 脚本双向读写变量实现方案

同工程内 C# 脚本与 Unity 交互(零依赖,最高效率)

这是 Unity 开发最常用的场景,由于 Unity 本身的运行时基于 .NET 框架,所有和 Unity 同程序集编译的 C# 脚本和场景内的 MonoBehaviour 处于同一个进程内存空间,不需要额外通信机制即可直接读写变量:

  • 全局静态变量方案:直接在独立的 C# 脚本类中定义静态的 string、int 等类型变量,只要该类被 Unity 运行时加载,场景内所有脚本都可以直接通过类名访问、修改对应变量
    // 独立脚本文件,不需要挂在场景物体上
    public static class ExternalVarStore
    {
        public static int ConfigInt = 10;
        public static string ConfigStr = "default_value";
    }
    
    Unity 侧访问示例:
    public class UnitySideTest : MonoBehaviour
    {
        void Start()
        {
            // 读脚本侧的变量
            Debug.Log(ExternalVarStore.ConfigInt);
            // 修改脚本侧的变量
            ExternalVarStore.ConfigStr = "value_from_unity";
        }
    }
    
  • 场景单例方案:如果需要让变量和场景生命周期绑定,不需要用全局静态类,可以把变量挂在常驻场景物体的 MonoBehaviour 上单例化,其他脚本可以通过单例实例直接读写这些 public/SerializeField 标记的变量,和上述静态类的访问逻辑完全一致。

独立运行的外部脚本(脱离 Unity 进程)双向交互

如果你的 C#/C++ 脚本是独立运行的程序、不参与 Unity 的编译流程,需要和 Unity Editor 或者 PlayMode 下的 Unity 进程跨进程交换变量,可以根据场景选择以下方案:

  • 低实时性要求场景:本地文件/共享配置交互
    外部脚本把 int、string 类型的变量值序列化成纯文本/JSON,写入固定路径的本地配置文件;Unity 侧通过协程定时读取这个文件内容,解析后缓存成本地变量。反向流程同理:Unity 把自身要对外暴露的变量修改后写入同一个配置文件,外部脚本定时轮询读取即可拿到最新值。注意加文件锁避免读写冲突。
  • 高实时性要求场景:本地 Socket/命名管道通信
    外部脚本启动本地 TCP 服务端,绑定 127.0.0.1 的固定空闲端口,Unity 作为客户端主动建立连接,双方约定统一的数据帧格式(比如变量类型,变量名,变量值的纯文本格式),要修改变量时直接发送对应格式的数据包,对端收到后解析缓存即可。该方案不需要第三方依赖,C#、C++ 都有原生的网络 API 支持,端到端延迟可以控制在 1ms 以内。
  • C/C++ 原生动态库交互
    如果你的 C/C++ 代码是编译成 DLL(Windows)/so(Linux)/dylib(macOS)的动态链接库,不需要跨进程通信,Unity 可以直接把库加载到自身进程空间内:
    在 C/C++ 侧导出统一的变量读写接口,比如:
    extern "C" __declspec(dllexport) int GetIntValue(const char* key);
    extern "C" __declspec(dllexport) void SetIntValue(const char* key, int value);
    extern "C" __declspec(dllexport) const char* GetStringValue(const char* key);
    extern "C" __declspec(dllexport) void SetStringValue(const char* key, const char* value);
    
    Unity 侧通过 [DllImport] 特性直接调用这些导出函数,就能直接读写动态库内部存储的变量,全程没有额外通信开销。

注意事项

  • 跨进程/跨语言传 string 时,统一使用 UTF-8 编码,避免中文内容乱码
  • 使用动态库交互时,要对齐 C# 和 C++ 的基础类型内存大小,避免读取出的数值错乱
  • 不要为同进程内的变量交互额外叠加网络/序列化层,徒增性能开销

内容的提问来源于stack exchange,提问作者IGamesI

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 09:36:08