###  控件指令须知

\
以下是关于文本控件的串口指令描述：

```json
{
    "id": "t0",
    "name": "you define",
    "prop": {
        "txt": "hello,world",
        "color": "#FF0000",
        "bgcolor": "#00FF00",
        "bgopa": 60,
        "opa": 100
    }
}

```

*   **id**：表示文本控件的唯一标识符，可用于在程序中找到指定的控件。
*   **name**：表示用户自定义的控件名称，用于标识和识别控件，可用于在程序中找到指定的控件。



```json
{
    "id": "t0",
    "name": "you define"
}

```

在这个串口指令中：

*   **id**：表示文本控件的唯一标识符，用于在程序中找到指定的控件。例如，您可以将其设置为 "t0"。
*   **name**：表示用户自定义的控件名称，用于标识和识别控件。例如，您可以将其设置为 "you define"。

您只需提供其中的一个属性（id 或者 name），Guition 平台就能够根据提供的属性值找到对应的文本控件。例如，您可以发送以下任一串口指令来操作指定的文本控件：

```json
{
    "id": "t0",
    "prop": {
        "txt": "hello,world",
        "color": "#FF0000",
        "bgcolor": "#00FF00",
        "bgopa": 60,
        "opa": 100
    }
}

```

或者：

```json
{
    "name": "you define",
    "prop": {
        "txt": "hello,world",
        "color": "#FF0000",
        "bgcolor": "#00FF00",
        "bgopa": 60,
        "opa": 100
    }
}

```

\
当提供了同时包含 id 和 name 的串口指令时，**Guition 平台会优先根据 id 来查找控件，而忽略 name**。因此，如果 id 和 name 所指示的控件不一致，Guition 会选择使用 id 所指示的控件。这意味着在指定控件时，应优先使用 id 而不是 name，以确保操作的准确性。