跳至主要内容

图形输入节点

Graph Input Node Screenshot

概述​

Graph Input节点用于定义图的输入。当使用SDK调用图时，可以传入此输入；或者当图被用作子图时，它定义了其中一个输入端口。

Graph Input节点特别适合创建可重复使用的子图，这些子图每次使用时可以接受不同的输入。例如，您可以创建一个子图，接受string输入并输出一个附加了输入值的string值。然后您可以在图中的多个位置使用这个子图，每次传入不同的值。

输入项​

标题数据类型描述默认值备注
Default ValueAnyThe default value for the input if no value is provided when the graph is called.(optional)The input will be coerced into the data type specified in the Editor Settings. This input is only available if the Use Default Value Input setting is enabled.

示例1：为图表定义输入​

  1. 创建一个Graph Input节点。
  2. 在编辑器设置中，将ID设置为input1，数据类型设置为string。将默认值设置为Hello World。
  3. 运行图形。Graph Input Node 将输出默认值 Hello World。

Graph Input Node Example 1

示例2：在子图中使用Graph Input节点​

  1. 创建一个新图表并向其中添加一个Graph Input节点。
  2. 在编辑器设置中，将ID设为input1，数据类型设为string。
  3. 向图中添加一个文本节点并将图形输入节点连接到它。
  4. 保存图表并返回主图表。
  5. 在主图中添加一个子图节点，并选择你刚刚创建的图。
  6. 您会看到子图节点有一个名为input1的输入端口。这是由子图中的图形输入节点定义的输入。

Graph Input Node Example 2 Graph Input Node Example 2

错误处理​

如果输入值无法强制转换为指定的数据类型，Graph Input Node 将会报错。

常见问题​

问：我可以使用Graph Input Node为图表定义多个输入吗？

A: 是的，您可以在图中添加多个Graph Input Node来定义多个输入。每个Graph Input Node将为图定义一个单独的输入。

问：如果在调用图形时没有为输入提供值会发生什么？

A: 如果在调用图形时没有为输入提供值，Graph Input Node将使用编辑器设置中指定的默认值。如果启用了Use Default Value Input设置，该节点将使用提供给Default Value输入端口的值。

问：我可以在主图中使用Graph Input节点吗？

A: 是的，您可以在主图中使用Graph Input Node来定义图的输入。这些输入可以在使用SDK调用图时提供。更多信息请参阅RunGraphOptions文档。

另请参阅​