控件指令须知


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

{
    "id": "t0",
    "name": "you define",
    "prop": {
        "txt": "hello,world",
        "color": "#FF0000",
        "bgcolor": "#00FF00",
        "bgopa": 60,
        "opa": 100
    }
}
  • id:表示文本控件的唯一标识符,可用于在程序中找到指定的控件。

  • name:表示用户自定义的控件名称,用于标识和识别控件,可用于在程序中找到指定的控件。

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

在这个串口指令中:

  • id:表示文本控件的唯一标识符,用于在程序中找到指定的控件。例如,您可以将其设置为 “t0”。

  • name:表示用户自定义的控件名称,用于标识和识别控件。例如,您可以将其设置为 “you define”。

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

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

或者:

{
    "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,以确保操作的准确性。