Display text on the device screen
Display text on the device screen. If a slide, slideshow, or image display is ongoing, the text is added on top of the content.
Applicable Products: 8410, 8420
Minimum Firmware Version: 5.7
URI
POST /api/controls/screen-text/start
Parameter
Element | Description | Type | Required | Notes |
|---|---|---|---|---|
duration | How long the text displays (in seconds). | Integer | Optional | If not specified, the text displays indefinitely. |
persistent | Whether the text continues to display when the screen content changes. | Boolean | Optional | Valid values include:
Default=”false” |
textContent | The text to be displayed on the device. | String | Required | |
textBg | The text background. | Boolean | Optional | Valid values:
|
textBgColor | The text background color. | String | Optional | Valid values:
|
textColor | The color of the text. | String | Optional | Valid values:
For example, use either of the following to set the text color to black: For more information, see HTML Color Names. Default= “black” |
textFont | The font of the text. | String | Optional | Valid values include:
Default= “inter” |
textPosition | Where the text should be displayed on the screen. | String | Optional | Valid values include:
Default= “bottom” |
textScroll | Whether text scroll is enabled. | Boolean | Optional | Valid values include:
Default=”true” |
textScrollSpeed | The speed at which the text scrolls. | String | Optional | Valid values include (in increasing speed)
Default= “1” |
textSize | The size of the text. | String or Integer | Optional | Valid string values include:
Valid integer values: 50 - 300 Default=”large” (in v5.6 and earlier) Default=”small” (in v5.7 and later) |
Sample Request
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: hmac <user>:<nonce>:<digest>" \
-d '{
"textContent": "Emergency Notice: Stand by for instructions",
"textColor": "#FFFFFF",
"textFont": "Roboto",
"textSize": "large",
"textPosition": "bottom",
"textScroll": true,
"textScrollSpeed": 3,
"textBg": true,
"textBgColor": "#000000",
"duration": 10
}' \
https://10.12.123.12/api/controls/screen-text/startSample Response
None. The observable outcome is whether the text is displayed on the screen.
Stop displaying text on the device screen
Stop the text displaying on the device screen.
Applicable Products: 8410, 8420
Minimum Firmware Version: 5.7
URI
POST /api/controls/screen-text/stop
Sample Request
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: hmac <user>:<nonce>:<digest>" \
https://10.12.123.12/api/controls/screen-text/stopSample Response
None. The observable outcome is whether the text display stops.
.png)