網點排隊設備組件技術規范目錄TOC\o"1-3"1概述52設備組件規格62.1.1排隊設備COM組件62.1.2排隊設備Dll文件63驅動接口83.1公共接口說明83.1.1方法83.2刷卡器83.2.1接受用戶刷卡83.2.2讀取銀行卡信息83.2.3取消用戶刷卡93.3IC卡讀卡器93.3.1接受用戶刷卡93.3.2讀取銀行卡信息93.3.3取消用戶刷卡103.4二代身份證讀卡器103.4.1接受用戶刷卡103.4.2讀取身份證信息103.4.3取消用戶刷卡113.5憑條打印機113.5.1打印一行(不自動換行) 113.5.2進紙一行113.5.3切紙113.5.4獲取打印機狀態123.5.5設置左邊界123.5.6設置打印字體大小123.5.7設置粗體或者取消粗體打印133.5.8打印準備133.5.9下載NV位圖133.5.10打印NV位圖133.6播音設備143.6.1方法143.6.2事件143.6.3屬性143.7窗口屏153.7.1方法153.7.2事件163.7.3屬性163.8呼叫器163.8.1方法163.8.2事件173.8.3屬性173.9評價器183.9.1方法183.9.2事件203.9.3屬性213.10綜合屏213.10.1方法213.10.2事件223.10.3屬性224播音及顯屏格式配置文件234.1說明234.1.1播音及顯屏格式配置文件樣例234.2格式定義說明244.2.1Form 244.2.2Field 244.2.3Text 244.2.4Space 244.2.5Variable 244.2.6Play 244.2.7OutputMode 244.2.8Sound 25概述設備產商需要按本系統的接口規范提供相關的硬件驅動。呼叫器、窗口屏、綜合屏、播音設備、評價器的設備驅動需編譯為COM組件；刷卡器、二代證、憑條打印機的設備驅動需編譯為Win32DLL文件；設備組件規格排隊設備COM組件播音設備、窗口屏、呼叫器、評價器、綜合屏需要按照以下所規定的規格生成COM組件。設備類別設備組件文件名接口名ProgIDCLSIDTypeLibGUID呼叫器Caller.dllCallerDevCaller.CallerDev30692A8D-3093-4420-97C1-D7EB30795F067D458696-92BC-44F8-A860-8AC3FEF95840詳見附件內Caller.idl與CallerDev.rgs文件評價器Opinion.dllOpinioerOpinion.OpinioerDC5F9077-C7BF-4437-A65E-766E5FD1F7E040623E1B-86BF-4CC2-9637-D39C3910C詳見附件內Opinion.idl與Opinioer.rgs文件窗口屏WindowDisp.dllWinDispWindowDisp.WinDisp8A240BD4-3109-4275-A68B-1B5C7B0DEBEB73A601FC-B5A6-4037-A9DD-E763F42A詳見附件內WindowDisp.idl與WinDisp.rgs文件綜合屏SyntheDisp.dllSynDispSyntheDisp.SynDispF7B26E50-6EF5-464E-9C75-835924EF18EF25ADD009-FB81-4D8A-B0BA-D39CE4738F80詳見附件內SyntheDisp.idl與SynDisp.rgs文件播音BroadCast.dllSoundBroadCast.Sound5CB2F7D6-AA8D-416E-8CE0-DF7A05BD227EBBD17A67-966B-4D99-9D97-E3186A04B6E3詳見附件內BroadCast.idl與Sound.rgs文件排隊設備Dll文件刷卡器、二代證、憑條打印機的設備驅動需編譯為Win32DLL文件；設備類別設備驅動DLL文件名文件部署位置刷卡器SP_SwipeCarder.dll系統盤的WINDOWS\system32\ＩＣ卡讀卡器SP_ICCarder.dll系統盤的WINDOWS\system32\二代證SP_IDCarder.dll系統盤的WINDOWS\system32\憑條打印機SP_ReceiptPrinter.dll系統盤的WINDOWS\system32\驅動接口公共接口說明公共接口定義的方法事件為本章節設備驅動均須實現的；方法SPConnect需在初始啟動時調用本方法來啟動設備，該方法可能分配資源并初始化硬件，需要一點時間。此方法為同步方法。原型shortSPConnect()返回值0：成功SPDisconnect關閉與設備的連接，釋放資源。關閉設備可能需要一點時間（取決于SP）。設備關閉后不能再使用，直到調用方法SPConnect來重新打開設備。此方法為同步方法。原型voidSPDisconnect()參數表無刷卡器接受用戶刷卡int__stdcallAcceptCard()功能：清空緩沖區、使設備處于可以接受刷卡的狀態;返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)讀取銀行卡信息int__stdcallCardReadTrack(char*CardNo,char*Track1,char*Track2,char*Track3)功能：讀取當前刷卡器緩沖區的有效卡數據。如讀到有效卡數據返回成功，給相應出參賦值；如沒有刷卡數據則返回成功，無需給相應出參賦值；如果讀取到無效卡數據或其他故障則返回失敗；無需給相應出參賦值無需等待用戶刷卡，由上層應用循環調用。入參數：出參數：CardNo：銀行卡號，字節數31；Track1：磁道1數據，字節數31；Track2：磁道2數據，字節數51；Track3：磁道3數據，字節數121；返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)取消用戶刷卡int__stdcallCancelAcceptCard()功能：廠商根據自己的設備情況決定是否需要實現該函數，如果不需要則直接返回成功；返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)IC卡讀卡器接受用戶刷卡int__stdcallAcceptCard()功能：清空緩沖區、使設備處于可以接受刷卡的狀態;返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)讀取銀行卡信息int__stdcallCardReadTrack(char*CardNo,char*Track1,char*Track2,char*Track3)功能：讀取當前讀卡器中的有效卡數據。如讀到有效卡數據返回成功，給相應出參賦值；如沒有刷卡數據則返回成功，無需給相應出參賦值；如果讀取到無效卡數據或其他故障則返回失敗；無需給相應出參賦值無需等待用戶刷卡，由上層應用循環調用。入參數：出參數：CardNo：銀行卡號，字節數31；Track1：磁道1數據，字節數31；Track2：磁道2數據，字節數51；Track3：磁道3數據，字節數121；返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)取消用戶刷卡int__stdcallCancelAcceptCard()功能：廠商根據自己的設備情況決定是否需要實現該函數，如果不需要則直接返回成功；返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)二代身份證讀卡器接受用戶刷卡int__stdcallAcceptCard()功能：清空緩沖區、使設備處于可以接受刷卡的狀態;返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)讀取身份證信息int__stdcallReadBaseInfos(char*Name,char*Gender,char*Folk,char*BirthDay,char*Code,char*Address,char*Agency,char*ExpireStart,char*ExpireEnd,char*Photo1,char*Photo2)功能：本函數用于讀取當前卡中基本信息，包括文字信息與圖像信息。文字信息以字符串格式輸出。如果有身份證正面圖片和反面圖片則以圖片文件保存(jpg或bmp)。如讀到有效卡數據返回成功，給相應出參賦值；如沒有放卡則返回成功，無需給相應出參賦值；如果讀取到無效卡數據或其他故障則返回失敗；無需給相應出參賦值無需等待用戶刷卡，由上層應用循環調用。出參數：Name姓名信息。字節數31。Gender性別信息（男或者女），字節數3。Folk民族信息，字節數10。BirthDay生日期信息，字節數9，格式為：YYYYMMDD。Code身份證號碼信息，字節數19。Address地址信息，字節數71。Agency簽證機關信息，字節數31。ExpireStart有效期起始日期信息，字節數9,格式為：CCYYMMDD。ExpireEnd有效期截至日期信息，字節數9，格式為：CCYYMMDD，有效期為長期的表示為漢字“長期”。Photo1：如果有身份證正面圖片，則賦值為正面圖片文件的絕對路徑；字節數51;Photo2：如果有身份證反面圖片，則賦值為反面圖片文件的絕對路徑；字節數51;返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)取消用戶刷卡int__stdcallCancelAcceptCard()功能：廠商根據自己的設備情況決定是否需要實現該函數，如果不需要則直接返回成功；返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)憑條打印機打印一行(不自動換行)int__stdcallPrtPrintLine(constchar*pcData)功能：打印一行(不自動換行)入參數：constchar*pcData打印的數據出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)進紙一行int__stdcallPrtFeed()功能：進紙一行入參數：無出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)切紙Int__stdcallPrtCut()功能：切紙入參數：無出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)獲取打印機狀態int__stdcallPrtState(int*piStatus)功能：打印機狀態入參數:無出參數: piStatus：1缺紙，2紙將盡，3正常，11打印頭抬起，12打印頭異常，13切刀異常，19其他錯誤返回值:函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)設置左邊界int__stdcallPrtSetLeft(intiLeft)功能：設置左邊界入參數：intiLeft取值為0～65535，表示打印機水平移動單位的倍數；如傳入值為15，實際效果=15*打印機水平移動單位；出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)設置打印字體大小int__stdcallPrtSetFontSize(intiHeng,intiZong)功能：設置打印的字體的大小入參數：intiHeng橫向放大倍數1~6intiZong縱向放大倍數1~6出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)設置粗體或者取消粗體打印int__stdcallPrtSetBold(inttag)功能：設置粗體或者取消粗體打印入參數：inttag1：設置粗體0.取消粗體出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)打印準備int__stdcallPrtInit()功能：打印前調用一次該方法、驅動準備打印；入參數：無出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)下載NV位圖int__stdcallPrtLoadNvBmp(char*FilePath)功能：把位圖文件下載到打印機的NV存儲區（掉電不丟失）；入參數：FilePath：位圖路徑，位圖大小必須是8的倍數出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)打印NV位圖int__stdcallPrtPrintNvBmp(intMode)功能：把位圖文件下載到打印機的NV存儲區（掉電不丟失）；入參數：Mode：打印模式0:正常1:倍寬2:倍高3:倍寬倍高出參數：無返回值：函數執行成功或失敗。CODE_SUCCESS(0),CODE_FAIL(-1)播音設備方法Play該方法用于播放叫號信息；播音內容格式及語種由驅動產商提供可配置。異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條信息已播音完成。原型voidPlay(BSTRdevId,BSTRInfo,BSTRformName)參數表devId 播音設備標識；有多路播音設備，可以選使用哪路。Info 要播放的內容，對應于播放格式配置中各項域的值；域的分割符定為##。formName 顯示格式的標識，該播音格式和語種可配置，如果要新增或修改格式時不需要改程序；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：BroadcastCall 窗口號##辦理號碼如2##A001CallManager 窗口號 如2事件屬性窗口屏方法Display該方法用于立即更新窗口屏臨時顯示的信息；屏重新上電或顯示超時該信息被丟棄，當顯示超時屏幕卻換回宣傳信息；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給屏顯示了。原型voidDisplay(BSTRdevId,BSTRInfo,BSTRformName)參數表devId 顯屏的設備標識Info 要評價器顯示的內容，對應于顯示格式配置中各項域的值；域的分割符為##。formName顯示格式的標識，該標識對應于設備驅動中的一個顯示格式配置信息，包括顯示方式、停留時間等可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：ScreenDisplayCall 窗口號##排隊號如①##A001ScreenDisplayDefault 要顯示的內容如①##暫停服務InitialDisplay該方法用于更新窗口屏空閑顯示的宣傳信息；該信息被永久存儲在顯屏中；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給屏顯示成功了。原型voidInitialDisplay(BSTRdevId,BSTRInfo,BSTRformName)參數表devId 顯屏的設備標識Info 要顯示的內容formName 顯示格式的標識，該顯示格式要可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；formName取值：Info取值：ScreenDisplayIni 要顯示的內容事件屬性呼叫器方法Display該方法用于更新呼叫器的顯示信息；按指定的格式模板顯示；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給呼叫器顯示成功了。原型voidDisplay(BSTRdevId,BSTRinfo,BSTRformName)參數表devId 呼叫器設備標識info 要呼叫器顯示的內容，對應于顯示格式配置中各項域的值；域的分割符定為##。formName 顯示格式的標識，該顯示格式要可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：CallerDisplayCall 辦理號碼##等待人數如A001##13CallerDisplayDefault 提示信息 如操作成功Beep該方法用于讓呼叫器發出翁鳴聲；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給呼叫器執行完成了。原型voidBeep(BSTRdevId,inttimes)參數表devId呼叫器設備標識times要翁鳴的次數事件ActionReceived柜員在呼叫器觸發的功能事件；原型voidActionReceived(BSTRdevId,BSTRaction,BSTRparameters)參數表devId呼叫器設備標識action功能標識，取值范圍（大小寫敏感）： Login：簽到；parameters中參數1的值為柜員號，參數2的值為密碼Logout：簽退Call：呼叫ReCall：重呼SelectCall：選呼；parameters中參數1的值為要選呼的號碼；Pause：暫停服務Transfer：轉移；parameters中參數1的值為要轉移的窗口號；Welcome：你好Appraise：請評價parameters功能標識所對應的參數，充許為空；如果有多個參數之間以“##”作為分隔符；屬性評價器方法Login該方法更新評價器當前簽到柜員的工號、星級；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給評價器執行完成了。原型voidLogin(BSTRdevId,BSTRuserId,intstars)參數表devId評價器設備標識。userId簽到柜員的工號。starts簽到柜員的星級；取值范圍：0：表示無星級1：表示一星級2：表示二星級3：表示三星級4：表示四星級5：表示五星級Logout該方法更新評價器為柜員簽退狀態；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給評價器執行完成了。原型voidLogout(BSTRdevId,BSTRuserId)參數表userId簽到柜員的工號。PlayWelcome該方法實現評價器播放對客戶的歡迎信息（語音）；該語音信息已存儲在評價器中。異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給評價器執行完成了。原型voidPlayWelcome(BSTRdevId)參數表devId評價器設備標識。Appraise該方法實現評價器播放請客戶評價的提示信息（語音）；該語音信息已存儲在評價器中。異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給評價器執行完成了。原型voidAppraise(BSTRdevId)參數表devId評價器設備標識。Display該方法用于立即更新評價器臨時顯示的信息；評價器重新上電或顯示超時該信息被丟棄，當顯示超時屏幕卻換回宣傳信息；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給評價器執行完成了。原型voidDisplay(BSTRdevId,BSTRinfo,BSTRformName)參數表devId 評價器的設備標識info 要評價器顯示的內容，對應于顯示格式配置中各項域的值；域的分割符為##。formName 顯示格式的標識，該顯示格式要可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：AppraiseDisplayDefault 要顯示的內容InitialDisplay該方法用于更新評價器空閑顯示的宣傳信息；該信息被永久存儲在評價器中；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給評價器執行完成了。原型voidInitialDisplay(BSTRdevId,BSTRinfo,BSTRformName)參數表devId 評價器的設備標識info 要評價器顯示的內容，對應于顯示格式配置中各項域的值；域的分割符為##。formName 顯示格式的標識，該顯示格式要可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：AppraiseDisplayIni 要顯示的內容事件Appraised(BSTRdevId,BSTRresul,intserviceTime)當客戶對柜員作出評價后；評價器觸發該事件。原型voidAppraised(BSTRdevId,BSTRInfo,BSTRformName)參數表devId 評價器設備標識。resul 客戶的評價結果。取值范圍： 空：表示客戶在指定的時間范圍內沒有作出評價；1：表示很滿意 2：表示滿意 3：表示一般 4：不滿意 5：很不滿意serviceTime 表示本次為客戶服務的時間長度、從播放歡迎信息開始計時到請客戶評價作為結止的時長，單位為秒；如果該值為-1，系統則采用調用PlayWelcome到StartedAppraise的時差作為服務時長；屬性綜合屏方法Display該方法用于綜合屏顯示叫號信息，最近一條信息顯示在綜合屏的第一行；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給綜合屏執行完成了。原型voidDisplay(BSTRdevId,BSTRinfo,BSTRformName)參數表devId 綜合屏的設備標識info 要評價器顯示的內容，對應于顯示格式配置中各項域的值；域的分割符為##。formName 顯示格式的標識，該標識對應于設備驅動中的一個顯示格式配置信息，包括顯示方式、停留時間等可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：BigScreenDisplayCall 窗口號##排隊號如①##A001InitialDisplay該方法用于更新綜合屏空閑顯示的宣傳信息；該信息被永久存儲在顯屏中；異步方法，該方法的返回只說明已添加到驅動的隊列中，不代表本條指令已發送給綜合屏執行完成了。原型voidInitialDisplay(BSTRdevId,BSTRinfo,BSTRformName)參數表devId 綜合屏的設備標識info 要顯示的內容formName 顯示格式的標識，該顯示格式要可配置，如果要新增或修改格式時不需要改程序；如該值為空，則按默認格式顯示；HYPERLINK參見播音及顯屏格式配置文件formName取值：Info取值：BigScreenDisplayIni 要顯示的內容事件屬性播音及顯屏格式配置文件說明因目前各排隊廠商的硬件存在較大差異，沒有統一行業標準規格；因此把信息顯示及播音的相關格式配置由設備驅動層來實現，更有利于廠商設備功能的展示和擴展。本文中提供的配置格式定義可供各廠商參考，但不作為硬性要求。播音及顯屏格式配置文件樣例<?xmlversion="1.0"encoding="GB2312"?><root> <Formname="ScreenCall"> <Fields> <Fieldalignment="left"> <Textfont="宋體"size="10"color="red"value="當前辦理"/> <Spacelength="2"/> <Variablevalue="{0}"/> </Field> <F