Cinema 4D 软件连接
通过 Bridge，Quicker 可以调用 Cinema 4D 中的文档和对象、选择与材质、命令搜索与调用、Python等能力。完整安装过程见安装与管理，本页说明该软件的差异。
适用范围
2024–2026；已有 2026.3 真机记录。面向 Windows x64。支持范围不等于所有小版本均已真机测试；实际可安装的版本组合以设置页检测与选择结果为准。
安装前准备与首次启用
安装机制：当前用户偏好目录中的 plugins。
先启动并退出一次 Cinema 4D，让其生成用户偏好目录，再关闭所有桌面版实例并安装。通常不需要管理员权限。
重启后后台插件自动加载。多个年份有各自偏好目录，应核对软件卡片列出的目标；Commandline、c4dpy、Team Render 配置不是桌面版目标。
确认连接
安装并重启后，打开 Quicker 设置 → 软件连接 → Cinema 4D，确认出现在线实例。打开命令工具并选择实例，用空对象 {} 调用 bridge.ping。成功响应及 pong: true 表明本次会话可调用；版本与当前文档摘要以实际结果为准。
宿主没有打开文档时，部分业务命令可能不可用；先测试连接，再测试文档命令。详细步骤见连接状态与命令工具。
创建动作
使用Cinema 4D控制，或在命令工具选择命令、填写参数后点击 生成动作，粘贴到 Quicker 面板。模块页提供只读的最小连接示例。
动作根据触发时前台窗口对应的 PID 与进程启动时间精确定位宿主进程。该实例未连接时失败，不回退到其他在线实例。同一进程内的活动文档仍由具体命令决定。
动作不保存工具窗口选择的临时 session。请阅读立即调用与动作目标的区别，再配置快捷键、面板或轮盘触发。
限制与排障
部分增强命令尚需逐项真机复测；连接验证不等于所有命令已验证。任意 Python 脚本需自行处理撤销。
命令全集来自当前实例的 command.list，本文不保证每个命令在所有宿主版本或文档状态下均可用。遇到问题先保存错误和版本信息，按通用排障定位安装、加载、连接或命令执行阶段。