本页采用了机器翻译。点击此处可查看最新英文版本。

roadrunnerAPI

RoadRunner 创作 API

自 R2025a 起

全页展开

    说明

    roadrunnerAPI 对象支持通过编程方式创建 RoadRunner 场景与情境，例如利用 MATLAB® 创建道路与车道、添加角色以及构建情境逻辑。通过编程方式创建场景和情境，您能够快速自动化重复性创作任务，生成自动化测试的变体，并在无需在应用程序间切换的情况下构建和修改仿真参数。要在 MATLAB 中使用 RoadRunner 创作 API，您必须先为您的 RoadRunner 会话创建一个 roadrunnerAPI 对象。

    创建对象

    语法

    rrApi = roadrunnerAPI(rrApp)

    描述

    rrApi = roadrunnerAPI(rrApp) 返回当前 RoadRunner 会话 rrApp 的 RoadRunner 创作 API 对象 rrApi。

    输入参量

    全部展开

    RoadRunner 应用程序，指定为对象。

    属性

    全部展开

    此 属性 为只读。

    当前 RoadRunner 场景，表示为一个 Scene 对象。

    示例: scn = rrApi.Scene 从 RoadRunner 创作 API rrApi 的 Scene 属性中提取场景对象 scn。

    此 属性 为只读。

    当前 RoadRunner 情境，以 Scenario (RoadRunner Scenario) 对象形式呈现。

    示例: scnro = rrApi.Scenario 从 RoadRunner 创作 API rrApi 的 Scenario 属性中提取场景对象 scnro。

    此 属性 为只读。

    当前的 RoadRunner 工程，以 Project 对象的形式呈现。

    示例

    全部折叠

    创建一个 roadrunner 对象，指定现有工程的路径。例如，此代码显示 Windows® 计算机上位于 "C:\RR\MyProject" 的工程的路径。此代码假设 RoadRunner 已安装在默认位置，并返回一个名为 rrApp 的对象，该对象提供用于执行基本任务的函数，例如打开、关闭和保存场景及工程。

    rrApp = roadrunner(ProjectFolder="C:\RR\MyProject");

    注意

    若您首次从 MATLAB 打开 RoadRunner，或自上次从 MATLAB 打开以来更改了 RoadRunner 的安装位置，可使用该功能指定新的默认工程和安装文件夹，以便在打开 RoadRunner 时使用。您可以在 MATLAB 会话之间通过从对应下拉菜单中选择 Across MATLAB sessions 选项来保存这些文件夹。

    使用 openScene 函数打开 RoadRunner 中的现有场景，指定 roadrunner 对象 rrApp 以及要打开的特定场景的文件名。然后，使用 newScenario 函数创建一个新情境。

    openScene(rrApp,"ScenarioBasic.rrscene")
newScenario(rrApp)

    创建一个对象，用于 RoadRunner 创作 API 的 rrAPI，该对象引用当前 RoadRunner 实例 rrApp 的对象。rrApi 对象支持通过编程方式创建场景和情境，例如使用 MATLAB 添加和修改道路、车道、交通参与者及逻辑组件。

    rrApi = roadrunnerAPI(rrApp);

    限制

    • 若未通过 roadrunner 函数从 MATLAB 打开 RoadRunner，或在打开 MATLAB 之前先打开了 RoadRunner 会话，则必须在 MATLAB 会话中添加包含 RoadRunner 创作 API 的文件夹路径，方可使用 RoadRunner 创作 API 函数。默认情况下，位于 Windows 上的 RoadRunner 创作 API 文件夹的路径为 C:\Program Files\RoadRunner R20NNx\bin\win64\Tools\MATLAB\api，其中 R20NNx 是您正在使用的发布版本。

    版本历史记录

    在 R2025a 中推出

    另请参阅

    (RoadRunner Scenario) | | (RoadRunner Scenario) | (RoadRunner Scenario) | (RoadRunner Scenario)

    主题