UniPRT SDK  v1.0.0.0
PrinterMonitor 類別 參考文件

用於協助監聽/檢索打印機非請求讯息或檢索打印機狀態/资讯的模塊。 更多...

類別PrinterMonitor的繼承圖:
IPrinterMonitor

公開方法(Public Methods)

 PrinterMonitor (JsonComm mgmtComm)
 
 PrinterMonitor (String commDescriptor)
 
 PrinterMonitor (TcpConnection connection)
 
void close () throws Exception
 
void Dispose ()
 
AlertStatusNotice GetAlertStatusCallback ()
 
boolean GetAlertStatusListening ()
 繼承自 IPrinterMonitor.AlertStatusListening
 
DisplayStatusNotice GetDisplayStatusCallback ()
 
boolean GetDisplayStatusListening ()
 繼承自 IPrinterMonitor.DisplayStatusListening
 
String GetEngineStatus ()
 繼承自 IPrinterMonitor.GetEngineStatus

 
EngineStatusNotice GetEngineStatusCallback ()
 
boolean GetEngineStatusListening ()
 繼承自 IPrinterMonitor.EngineStatusListening
 
String[] GetFaultStatus ()
 繼承自 IPrinterMonitor.GetFaultStatus

 
PrinterInfo GetPrinterInfo ()
 繼承自 IPrinterMonitor.GetPrinterInfo

 
void SetAlertStatusCallback (AlertStatusNotice callback)
 保存當接收到來自打印機的故障/警報訊息時需要調用的函數。函數必須符合 AlertStatusNotice 的簽名。
 
void SetAlertStatusListening (boolean listening)
 啟用/停用監聽/解析來自打印機的未經請求的故障狀態警報。 更多...
 
void SetDisplayStatusCallback (DisplayStatusNotice callback)
 保存當接收到來自打印機的顯示文字訊息時需要調用的函數。函數必須符合 DisplayStatusNotice 的簽名。
 
void SetDisplayStatusListening (boolean listening)
 啟用/停用監聽/解析來自打印機的前面板顯示文字。 更多...
 
void SetEngineStatusCallback (EngineStatusNotice callback)
 保存當接收到來自打印機的引擎狀態時需要調用的函數。函數必須符合 EngineStatusNotice 的簽名。
 
void SetEngineStatusListening (boolean listening)
 啟用/停用監聽/解析來自打印機的未經請求的引擎狀態。 更多...
 

保護方法(Protected Methods)

void Dispose (boolean disposing)
 
void finalize () throws Throwable
 

詳細描述

用於協助監聽/檢索打印機非請求讯息或檢索打印機狀態/资讯的模塊。

如果在打印機上啟用了非請求讯息,這些讯息可以隨時發送。 此模塊需要與打印機的管理端口保持恆定連接,以便監聽打印機發出的任何讯息。

範例

package com.test.UniPRTSdk;
import java.util.Arrays;
import com.UniPRT.Sdk.Json.PrinterMonitor;
public class PrinterMonitorSnippet {
// setup a comm and xml parser for listening to xml msgs from printer
private static PrinterMonitor _PrinterMntr = null;
public static void main(String[] args) {
System.out.println("Monitoring Printer.");
try {
_PrinterMntr = new PrinterMonitor("192.168.1.57");
// setup for listening for alerts
_PrinterMntr.SetAlertStatusListening(true); // enable unsolicited alert status msgs from printer
_PrinterMntr.SetAlertStatusCallback(PrinterMonitorSnippet::PtrAlertNoticeListener);
// setup for listening for Engine Status
_PrinterMntr.SetEngineStatusListening(true); // enable unsolicited engine status msgs from printer
_PrinterMntr.SetEngineStatusCallback(PrinterMonitorSnippet::PtrEngineStatusNoticeListener);
// setup for listening for display text msgs
_PrinterMntr.SetDisplayStatusListening(true); // enable unsolicited display text msgs from printer
_PrinterMntr.SetDisplayStatusCallback(PrinterMonitorSnippet::PtrDisplayStatusNoticeListener);
while (true) { // wait for something to happen
// pretend to be busy doing some other work here...
Thread.sleep(1000); // simulate work
}
} catch (Exception e) {
System.out.printf("Exception Msg: %s%n", e.getMessage());
} finally {
if (_PrinterMntr != null) {
_PrinterMntr.Dispose();
}
}
}
private static void PtrAlertNoticeListener(String[] newAlertText) {
// Print out alerts: e.g. "2418" ("Print Head Open" fault/alert)
System.out.printf("Printer Alert #: %n %s - %s%n", newAlertText[0], newAlertText[1]);
}
private static void PtrEngineStatusNoticeListener(String newEngineStatus) {
// Print out engine status: e.g. "idle", "offline", "online", "printing"...
System.out.printf("Engine Status: %n %s%n", newEngineStatus);
}
private static void PtrDisplayStatusNoticeListener(String[] newDisplayText) {
// Print display msgs: e.g. "ONLINE" "ETHERNET/PGL/LP+" or "PRINT HEAD UP" "Close Print Head"
System.out.println("Printer Display: ");
Arrays.stream(newDisplayText).forEach(txtLine -> System.out.printf(" %s%n", txtLine));
}
}

輸出

當開啟/關閉打印頭並按下打印機上的暫停按鈕,使打印機進入「離線」/「在線」狀態後的結果。

輸出


函式成員說明文件

◆ SetAlertStatusListening()

void SetAlertStatusListening ( boolean  listening)

啟用/停用監聽/解析來自打印機的未經請求的故障狀態警報。

請注意,必須啟用此選項才能接收來自打印機的任何通知,AlertStatusCallback。

實作 IPrinterMonitor.

◆ SetDisplayStatusListening()

void SetDisplayStatusListening ( boolean  listening)

啟用/停用監聽/解析來自打印機的前面板顯示文字。

請注意,必須啟用此選項才能接收來自打印機的任何通知,DisplayStatusCallback。

實作 IPrinterMonitor.

◆ SetEngineStatusListening()

void SetEngineStatusListening ( boolean  listening)

啟用/停用監聽/解析來自打印機的未經請求的引擎狀態。

請注意,必須啟用此選項才能接收來自打印機的任何通知,EngineStatusCallback。

實作 IPrinterMonitor.