MacOS下CoppeliaSim启动Remote API服务参数无效问题求助

API 探路者

2026-7-2

解决MacOS上CoppeliaSim远程API启动参数无效及simRemoteApi未定义问题

问题分析

报错attempt to index a nil value (global 'simRemoteApi')说明远程API插件未被加载，核心原因是MacOS环境下启动参数传递异常，或是插件未正确初始化。

解决方案

1. 修正MacOS下的启动命令

直接运行二进制文件时，部分MacOS环境无法正确传递启动参数，改用open命令启动并传递参数：

open /Applications/coppeliaSim.app --args -gREMOTEAPISERVERSERVICE_19999_FALSE_TRUE

这种方式能确保启动参数被CoppeliaSim完整接收。

2. 手动加载远程API插件

如果启动参数仍未生效，可手动触发插件加载：

打开CoppeliaSim，点击顶部菜单 Plugins > Load plugin
在文件选择器中导航到/Applications/coppeliaSim.app/Contents/Resources/plugins/，找到libsimRemoteApi.dylib（或同目录下命名类似的远程API插件文件）并加载
加载完成后重新运行测试脚本

3. 适配新版本CoppeliaSim的API调用

CoppeliaSim 4.4+版本将simRemoteApi改为需手动引入的模块，修改测试脚本如下：

local sim = require("sim")
local simRemoteApi = require("simRemoteApiLegacy") -- 显式引入远程API模块

function sysCall_init()
    local status, _info, _serverVersion, _clientVersion, _clientIp =
        simRemoteApi.status(19999)
    if status == -1 then
        print([[
            Warning: you did not start CoppeliaSim in the way required to connect to the server.
            Please start with "-gREMOTEAPISERVERSERVICE_19999_FALSE_TRUE",
            using ./scripts/start_coppelia_sim
        ]])
    end
end