訊息推送
# 訊息推送
DashBoard支援API方式發送資訊修改大屏報表顯示內容。目前支援的工具為 文字plus
、圖片plus
、表格plus
、提示框
、文字plus2
與 滾動文字plus
。
DashBoard中提供了兩個RestAPI,分別用於查詢連線的客戶端、向指定客戶端推送資訊。
# 1. RestAPI
獲取所有大螢幕的連線列表:
http://192.168.0.195:9095/socketC/getIPList
1
返回的示例如下:
{"code":"200","message":"操作成功","args":null,"data":["192.168.0.3","192.168.0.11"]}
1
返回的示例中 data
為連線的客戶端的IP地址。不同的客戶端連線的IP地址不同。客戶端是以IP區分的。
接下來可使用post方式提交:
http://192.168.0.195:9095/socketC/pushToWeb
1
其中Body部分的內容示例如下:
{
"ip":"192.168.0.194", //推送的目標客戶端的IP地址
"data":{
"marquee-plus":"歡迎使用分診叫號系統", //鍵名為滾動文字plus的欄位名稱,鍵值為顯示的文字內容。
"toast":{ //鍵值為提示框的欄位名稱
"isShow":true, //是否顯示
"text":"請T001號王小鴨虎到1號診室就診!" //顯示的文字內容
}
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
由上述示例可知,Body部分的json格式如下:
{
"ip":"xxx.xxx.xxx.xxx" //推送的目標客戶端的IP地址
"data":{ //推送的數據,不同的工具欄可推送的內容不同
...
}
}
1
2
3
4
5
6
2
3
4
5
6
支援推送的元件的各示例如下:
# 2. 元件推送示例
# 2.1. 文字plus
假設有一個欄位名稱為 text-plus
的文字plus 工具。推送的格式如下:
{
"ip":"192.168.0.194", //推送的目標客戶端的IP地址
"data":{
"text-plus":"歡迎使用分診叫號系統", //鍵名為文字plus的欄位名稱,鍵值為顯示的文字內容。
}
}
1
2
3
4
5
6
2
3
4
5
6
# 2.2. 圖片plus
假設有一個欄位名稱為 image-plus
的圖片plus 工具。推送的格式如下:
{
"ip":"192.168.0.194", //推送的目標客戶端的IP地址
"data":{
"image-plus":"http://xxx.xxx/image.jpg", //鍵名為圖片plus的欄位名稱,鍵值為顯示的圖片URL地址。
}
}
1
2
3
4
5
6
2
3
4
5
6
# 2.3. 表格plus
假設有一個欄位名稱為 table-plus
的表格plus 工具。表格列的欄位包含 code
、name
推送的格式如下:
{
"ip":"192.168.0.194", //推送的目標客戶端的IP地址
"data":{
"table-plus":[ //鍵名為表格plus的欄位名稱,鍵值為顯示的表格json序列。
{
"code":"111", //code name 為表格中自定義的欄位名稱
"name":"222"
},
{
"code":"333",
"name":"444"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 2.4. 提示框
假設有一個欄位名稱為 toast
的提示框工具。推送的格式如下:
{
"ip":"192.168.0.194", //推送的目標客戶端的IP地址
"data":{
"toast":{ //鍵值為提示框的欄位名稱
"isShow":true, //是否顯示
"text":"請T001號王小鴨虎到1號診室就診!" //顯示的文字內容
}
}
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 2.5. 文字plus2
推送格式與 文字plus 相同。
# 2.6. 滾動文字plus
推送格式與 文字plus 相同。