LDWS Display Control Endpoints

these display control apis can only be used on moka displays that have built in brightsign players and are only available in bos 9 0 189 and above get /v1/display control/ returns all control settings for a display that is connected to a brightsign player request example get /api/v1/display control/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the display control settings, as shown in the example below response example { "data" { "result" { "tvinfo" { "macaddress" "ff\ ff\ ff\ ff\ ff\ ff", "wifimacaddress" "ff\ ff\ ff\ ff\ ff\ ff", "serialno" "1234567890", "osversion" "v8 am963bs 0020015", "hwrevision" 1 }, "whitebalance" { "redbalance" 120, "greenbalance" 120, "bluebalance" 120 }, "volume" 50, "brightness" 50, "contrast" 50, "idlestandbytimeout" 50, "powersetting" "on", "videooutput" "hdmi1", "sdconnection" "brightsign", "alwaysconnectedenabled" true } } } get /v1/display control/brightness/ returns the brightness settings for a display that is connected to a brightsign player request example get /api/v1/display control/brightness/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the brightness setting for the display, as shown in the example below response example { "data" { "result" { "brightness" 100 } } } put /v1/display control/brightness/ changes the brightness setting of a display connected to a brightsign player request example put /api/v1/display control/brightness/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 18 this is the example request body { "brightness" 100 } response body 200 200 this returns the updated brightness setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "brightness" 100 } } } get /v1/display control/contrast/ returns the contrast settings for a display that is connected to a brightsign player request example get /api/v1/display control/contrast/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the contrast setting for the display, as shown in the example below response example { "data" { "result" { "contrast" 45 } } } put /v1/display control/contrast/ changes the contrast of a display connected to a brightsign player request example put /api/v1/display control/contrast/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 22 this is the example request body { "contrast" 45 } response body 200 200 this returns the updated contrast setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "contrast" 45 } } } get /v1/display control/always connected/ returns the connection settings for a display that is connected to a brightsign player request example get /api/v1/display control/always connected/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the connection setting for the display, as shown in the example below response example { "data" { "result" { "enabled" true } } } put /v1/display control/always connected/ changes the connection setting of a display connected to a brightsign player request example put /api/v1/display control/always connected/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 23 this is the example request body { "enable" true } response body 200 200 returns the connection setting for the display as true , as shown in the example below response example { "data" { "result" { "success" true, "enable" true } } } get /v1/display control/always on/ returns a connection setting (whether or not it is always on) for a player connected display see docid\ h7htro 84lyougqrax nv for an explanation of this setting request example get /api/v1/display control/always on/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the connection setting for the display, as shown in the example below response example { "data" { "result" { "enabled" true } } } put /v1/display control/always on/ enables you to set the display connection so that it is always on see docid\ h7htro 84lyougqrax nv for an explanation of this setting request example put /api/v1/display control/always on/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 23 this is the example request body { "enable" true } response body 200 200 returns the connection setting for the display as true , as shown in the example below response example { "data" { "result" { "success" true, "enable" true } } } put /v1/display control/firmware/ changes the firmware setting for a display connected to a brightsign player request example put /api/v1/display control/firmware/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 105 the example request body can be filepath or url { "filepath" "path/to/firmware/relative/to/sd", } { "url" "https //example com/tv firmware zip" } response body 202 202 this updates the firmware and reboots the player, as shown in the example below response example { "data" { "result" { "success" true, "reboot" true } } } get /v1/display control/info/ returns the settings about the brightsign player that is connected to a display request example get /api/v1/display control/info/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the information about the display that is connected to a brightsign player, as shown in the example below response example { "data" { "result" { "macaddress" "ff\ ff\ ff\ ff\ ff\ ff", "serialno" "1234567890", "osversion" "v8 am963bs 0020015", "hwrevision" 2, "wifimacaddress" "ff\ ff\ ff\ ff\ ff\ ff" } } } get /v1/display control/power settings/ returns the power settings for a display that is connected to a brightsign player request example get /api/v1/display control/power settings/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the power setting for the display, as shown in the example below response example { "data" { "result" { "setting" "on" } } } put /v1/display control/power settings/ changes the power setting for a display connected to a brightsign player request example put /api/v1/display control/power settings/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 38 this is the example request body { "setting" "standby" } response body 200 200 this returns the updated power setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "setting" "standby" } } } get /v1/display control/standby timeout/ returns the standby/timeout settings for a display that is connected to a brightsign player request example get /api/v1/display control/standby timeout/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the standby/timeout setting for the display, as shown in the example below response example { "data" { "result" { "seconds" 60 } } } put /v1/display control/standby timeout/ changes the standby/timeout setting of a display connected to a brightsign player request example put /api/v1/display control/standby timeout/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 19 this is the example request body { "seconds" 60 } response body 200 200 this returns the updated standby/timeout setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "seconds" 60 } } } get /v1/display control/sd connection/ returns the sd connection settings for a display that is connected to a brightsign player request example get /api/v1/display control/sd connection/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the sd connection setting for the display, as shown in the example below response example { "data" { "result" { "connection" "brightsign" } } } put /v1/display control/sd connection/ changes the sd connection setting of a display connected to a brightsign player the sd card control is passed either to the display ( display ) or the brightsign player ( brightsign ) request example put /api/v1/display control/usb connection/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 19 this is the example request body { "connection" "display" } response body 200 200 this returns the updated sd connection setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "connection" "display" } } } get /v1/display control/video output/ returns the video output settings for a display that is connected to a brightsign player request example get /api/v1/display control/video output/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the video output setting for the display, as shown in the example below response example { "data" { "result" { "output" "hdmi1" } } } put /v1/display control/video output/ changes the video output setting of a display connected to a brightsign player request example put /api/v1/display control/video output/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 18 this is the example request body { "output" "hdmi2" } response body 200 200 this returns the updated video output connection setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "output" "hdmi2" } } } get /v1/display control/volume/ returns the volume settings for a display that is connected to a brightsign player request example get /api/v1/display control/volume/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the volume setting for the display, as shown in the example below response example { "data" { "result" { "volume" 50 } } } put /v1/display control/volume/ changes the volume of a display connected to a brightsign player request example put /api/v1/display control/volume/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 16 this is the example request body { "volume" 100 } response body 200 200 this returns the updated volume setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "volume" 100 } } } get /v1/display control/white balance/ returns the white balance settings for a display that is connected to a brightsign player request example get /api/v1/display control/white balance/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json response body 200 200 this returns the white balance setting for the display, as shown in the example below response example { "data" { "result" { "redbalance" 120, "greenbalance" 120, "bluebalance" 120 } } } put /v1/display control/white balance/ changes the white balance of a display connected to a brightsign player request example put /api/v1/display control/white balance/ http/1 1 host {{playerip}} authorization {{digestauth}} accept application/json content type application/json content length 48 this is the example request body { "redbalance" 120, "greenbalance" 120, "bluebalance" 120 } response body 200 200 this returns the updated white balance setting for the display, as shown in the example below response example { "data" { "result" { "success" true, "redbalance" 120, "greenbalance" 120, "bluebalance" 120 } } }