華數(shù)機頂盒二維碼技術(shù)規(guī)范v12

1、華數(shù)機頂盒二維碼技術(shù)規(guī)范研究院密級一級華數(shù)機頂盒二維碼技術(shù)規(guī)范(Version 1.2)華數(shù)數(shù)字電視傳媒集團有限公司2012年11月07日主送： 抄送： 關(guān)鍵字：二維碼 省網(wǎng) 技術(shù)規(guī)范基本信息文檔名稱主標題華數(shù)機頂盒二維碼技術(shù)規(guī)范副標題文檔編號當前版本1.2發(fā)布版本起草時間2012年07月03日定稿時間起草人姓名部門電話電子郵件包曉曉系統(tǒng)技術(shù)部baoxx李兵偉系統(tǒng)技術(shù)部libw備注方案論證參與人：研究院：周明峰、陳民審核人簽發(fā)人修訂記錄序號修改時間修改人主要修改存檔版本12012-07-03李兵偉新建文檔0.122012-07-04包曉曉增加流程、調(diào)整數(shù)據(jù)格式0.232012-08-02包曉曉

2、修改了前端下發(fā)數(shù)據(jù)生成二維碼流程；修改了二維碼數(shù)據(jù)最大長度；增加了生產(chǎn)數(shù)據(jù)異常場景；增加了系統(tǒng)接口；增加了業(yè)務(wù)ID大類規(guī)劃0.342012-08-10李兵偉修改章節(jié)6.1時序圖增加章節(jié)7.2二維碼數(shù)據(jù)下發(fā)接口增加章節(jié)7.5數(shù)據(jù)存儲0.452012-8-14包曉曉調(diào)整文檔格式；增加章節(jié)1.概述修改章節(jié)2.目標為目的增加章節(jié)3.適用范圍；刪除章節(jié)4.背景增加附錄B 二維碼操作指令格式；1.062012-9-26包曉曉調(diào)整附錄B 二維碼操作指令格表；明確8.4章節(jié) 數(shù)據(jù)存儲方式；增加了8.5章節(jié)數(shù)據(jù)顯示；調(diào)整了二維碼操作接口；增加8.3章節(jié)中數(shù)據(jù)格式中數(shù)字電視號標簽；修改8.2.1二維碼下發(fā)保存接口

3、，去除保存到內(nèi)存；修改8.2.3二維碼顯示接口，接口中攜帶立即顯示字段。1.172012-10-26包曉曉增加讀取指令通道下發(fā)指令實例代碼8.5章節(jié)數(shù)據(jù)顯示，增加二維碼顯示方式描述1.2版權(quán)申明本文檔包含了來自華數(shù)集團的機密的技術(shù)和商業(yè)信息，提供給華數(shù)集團的客戶或合作伙伴使用。接受本文檔表示同意對其內(nèi)容保密并且未經(jīng)華數(shù)集團書面認可，不得復(fù)制、泄露或散布本文檔的全部或部分內(nèi)容。本文文件及其描述的產(chǎn)品受有關(guān)法律的版權(quán)保護，對本文檔內(nèi)容的任何形式的非法復(fù)制，泄露或散布，將導(dǎo)致相應(yīng)的法律責(zé)任。華數(shù)集團保留在不另行通知的情況下修改本文檔的權(quán)利，并保留對本文檔內(nèi)容的解釋權(quán)。目 錄1概述52目的53適用范圍

4、54引用標準與規(guī)范性文件55術(shù)語與縮略語65.1名詞解釋65.2縮略語66業(yè)務(wù)場景76.1前端數(shù)據(jù)生成二維碼76.2終端數(shù)據(jù)生成二維碼77業(yè)務(wù)時序圖87.1前端數(shù)據(jù)生成二維碼時序圖87.2終端數(shù)據(jù)生成二維碼時序圖98技術(shù)規(guī)范108.1編碼算法108.2二維碼操作接口108.2.1二維碼下發(fā)保存接口108.2.2二維碼讀取接口118.2.3二維碼顯示接口118.3數(shù)據(jù)格式138.4數(shù)據(jù)存儲148.5數(shù)據(jù)顯示148.6異常處理15附錄A 業(yè)務(wù)ID規(guī)則16附錄B 二維碼操作指令格式161 概述隨著二維碼技術(shù)的發(fā)展，現(xiàn)在人們生活中已經(jīng)隨處可以見到它的應(yīng)用。比如，火車票上的二維碼乘客信息識別，互聯(lián)網(wǎng)上二

5、維碼應(yīng)用（下載地址或者社交中友人的信息）等等。二維碼引入到數(shù)字電視中，更大的方便電視用戶操作，不用面對各種繁雜的數(shù)據(jù)，通過二維碼可以做到移動終端的驗證，下載應(yīng)用等功能。 常見二維碼標準有PDF417二維條碼， Datamatrix二維條碼，Maxicode二維條碼， QR Code，Code 49， Code 16K，Code one等10多種；應(yīng)用最普遍的是QR，DM，PDF417。中國目前的國家標準是QR碼和PDF417碼。手機二維碼普遍使用QR和DM標準。2 目的為了簡化用戶輸入，增強了用戶體驗度，華數(shù)終端采用二維碼技術(shù)。本規(guī)范對終端二維碼技術(shù)相關(guān)規(guī)范進行了闡述與定義。3 適用范圍本規(guī)范

6、適用于所有集成了云終端軟件的終端，要求所有需要二維碼功能的終端照此規(guī)范開發(fā)集成。國家實驗室對需要進行二維碼功能驗證測試的終端嚴格按照此規(guī)范進行測試驗證。4 引用標準與規(guī)范性文件下列標準文件所包含的條文，通過在本規(guī)范中引用而構(gòu)成為本規(guī)范的條文。對于注明日期的引用標準，以為進行的補充和修改并不適用，然而，鼓勵基于國際標準的協(xié)議各方對應(yīng)用以下標準文件最新版本的可能性進行調(diào)研，無注明日期的引用標準適用于提交應(yīng)用的最近的版本。ISO和IEC的成員仍然是當前有效標準的注冊機構(gòu)。 1 Information technology - Automatic identification and data cap

7、ture techniques - QR Code 2005 bar code symbology specification2 GBT 18284-2000 快速響應(yīng)矩陣碼5 術(shù)語與縮略語5.1 名詞解釋二維條碼/二維碼：是用某種特定的幾何圖形按一定規(guī)律在平面（二維方向上）分布的黑白相間的圖形記錄數(shù)據(jù)符號信息的；在代碼編制上巧妙地利用構(gòu)成計算機內(nèi)部邏輯基礎(chǔ)的“0”、“1”比特流的概念，使用若干個與二進制相對應(yīng)的幾何形體來表示文字數(shù)值信息，通過圖象輸入設(shè)備或光電掃描設(shè)備自動識讀以實現(xiàn)信息自動處理。云終端軟件：集成在機頂盒，提供云服務(wù)接入能力的客戶端。前端：應(yīng)用系統(tǒng)的后臺服務(wù)。5.2 縮略語QR

8、 Quick Response 快速響應(yīng)矩陣碼STBID Set Top Box Identification終端編號CA Conditional Access條件訪問CAIDConditional Access Identification智能卡號DTVID Digital Television Identification數(shù)字電視號6 業(yè)務(wù)場景6.1 前端數(shù)據(jù)生成二維碼圖6-1 前端數(shù)據(jù)生成二維碼場景圖 該場景主要描述了終端的二維碼模塊接收到前端下發(fā)的數(shù)據(jù)生成二維碼圖，并展示到電視機的過程。6.2 終端數(shù)據(jù)生成二維碼圖6-2 終端數(shù)據(jù)生成二維碼場景圖 該場景主要描述了終端的二維碼模塊使用存

9、儲在本地的數(shù)據(jù)生成二維碼圖，并展示在電視機的過程。7 業(yè)務(wù)時序圖7.1 前端數(shù)據(jù)生成二維碼時序圖圖7-1 前端數(shù)據(jù)生成二維碼時序圖1） 前端服務(wù)器把業(yè)務(wù)中使用到的數(shù)據(jù)下發(fā)到終端上的云終端軟件；2） 云終端軟件解析數(shù)據(jù)標志位，把類型為二維碼的數(shù)據(jù)轉(zhuǎn)發(fā)給二維碼模塊；3） 二維碼模塊根據(jù)標識決定存儲數(shù)據(jù)還是立即顯示二維碼圖；4） 如果存儲數(shù)據(jù)，則當二維碼模塊接收到終端應(yīng)用發(fā)送的顯示指令時，二維碼模塊根據(jù)業(yè)務(wù)ID獲取存儲在本地數(shù)據(jù)（Flash中）合并必須生成的數(shù)據(jù)（STBID、CAID、REGID、DTVID），生成二維碼圖；5） 如果立即顯示二維碼圖，則二維碼模塊合并前端下發(fā)的數(shù)據(jù)（包括存儲在本地的

10、數(shù)據(jù)）與必須生成的數(shù)據(jù)（STBID、CAID、REGID、DTVID），生成二維碼圖。7.2 終端數(shù)據(jù)生成二維碼時序圖圖7-2 終端數(shù)據(jù)生成二維碼時序圖1） 終端應(yīng)用通知二維碼模塊生成二維碼；2） 二維碼模塊從終端獲取指定數(shù)據(jù)生成二維碼圖，并展示到電視機上；8 技術(shù)規(guī)范8.1 編碼算法結(jié)合標準的普適性、國家和行業(yè)現(xiàn)狀，本規(guī)范使用QR標準做為華數(shù)機頂盒二維碼技術(shù)規(guī)范。QR標準參見國際標準（ISO/IEC 18004-2006信息技術(shù)-自動識別和數(shù)據(jù)采集技術(shù)-QR代碼2005條形碼符號體系規(guī)范）、國家標準（GBT18284-2000快速響應(yīng)矩陣碼）。8.2 二維碼操作接口前端通過云終端軟件下發(fā)二維

11、碼操作命令給終端，終端通過接口獲取到TS指令后，根據(jù)指令格式執(zhí)行下列接口（具體指令格式見附錄B）。8.2.1 二維碼下發(fā)保存接口static int stb_2dimensional_barcode_set_property(int property_id, void *property, int size)；描述: 前端指令系統(tǒng)通過TS下發(fā)二維碼數(shù)據(jù)，保存二維碼信息到flash。參數(shù):property_id: 保存接口操作方式，事件枚舉如下：typedef enum _2dimensional_barcode_ops_type_EE_EDIT_FIELD_FLASH, /編輯flash已經(jīng)存

12、在的二維碼字段，如果該字段不存在，則添加；當XML存儲空間達到上限時，添加失?。籈_DEL_FIELD_FLASH, /刪除flash指定二維碼數(shù)據(jù)ID對應(yīng)數(shù)據(jù)內(nèi)容；E_2dimensional_barcode_ops_type;Property：二維碼數(shù)據(jù)參數(shù)，數(shù)據(jù)格式如下:typedef struct _2dimensional_barcode_data_STunsigned charm_chBsTypeId; /業(yè)務(wù)ID類型編號unsigned charm_chAId; /業(yè)務(wù)ID序號charm_chData100; /二維碼數(shù)據(jù)，字符串ST_2dimensional_barcode_d

13、ata; int size：為property數(shù)據(jù)長度；返回值:0成功；其他值失?。?.2.2 二維碼讀取接口static int stb_2dimensional_barcode_get_property(int property_id, void *property, int size)；描述:本接口用來讀取底層flash（或機器自帶信息如STBID）中保存的二維碼。參數(shù):property_id: 業(yè)務(wù)ID類型編號；void *property：讀取數(shù)據(jù)保存緩存,數(shù)據(jù)格式如下：typedef struct _2dimensional_barcode_read_STchar*m_pchDat

14、a;/當前xml內(nèi)容，由二維碼模塊申請內(nèi)存空間，應(yīng)用釋放；intm_iDataSize;/指針m_pchData實際空間長度；ST_2dimensional_barcode_ read;int size：為property數(shù)據(jù)長度；返回值:0成功；其他值失?。?.2.3 二維碼顯示接口static int stb_2dimensional_barcode_display (int property_id, void *property, int size)；描述:本接口用來在終端即時顯示二維碼。二維碼顯示格式說明：本接口提供二維碼顯示數(shù)據(jù)尋址，即可通過接口將二維碼顯示的數(shù)據(jù)和顯示的位置確定；參

15、數(shù):property_id:顯示二維碼數(shù)據(jù)來源，數(shù)據(jù)定義如下：typedef enum _2dimensional_barcode_display_eE_FLASH_INFO，/顯示flash中二維碼，根據(jù)property攜帶的數(shù)據(jù)ID讀取二維碼數(shù)據(jù)，然后編碼顯示E_CMD_INFO,/根據(jù)指令中property字符串編碼（顯示指令）顯示二維碼e_2dimensional_barcode_display;二維碼顯示位置和時長數(shù)據(jù)結(jié)構(gòu)：typedef struct osd_display_2code_st unsigned short x; unsigned short y; unsigned

16、short width; unsigned short height; unsigned short second; /顯示時長（秒）st_osd_display_2code;property數(shù)據(jù)格式為：typedef struct _display_flash_info_stst_osd_display_2code m_stSeat; /二維碼顯示位置與時長unsigned char m_chBsTypeId; /業(yè)務(wù)ID類型編號unsigned char m_chAId; /業(yè)務(wù)ID序號char m_chString80;/業(yè)務(wù)ID m_chID對應(yīng)的值；st_display_flash_

17、info;當property_id 為 E_FLASH_INFO時：顯示業(yè)務(wù)ID類型編號的XML；當property_id為E_CMD_INFO時,將m_chAId中轉(zhuǎn)換成xml的a id,m_chString為當前a id的值，然后與m_chBsTypeId對應(yīng)的flash中xml拼接，顯示出來；拼接后的xml不保存更新到flash中。當調(diào)用顯示內(nèi)存中數(shù)據(jù)時，int size：為property數(shù)據(jù)長度；返回值:0成功；其他值失敗;8.3 數(shù)據(jù)格式數(shù)據(jù)按XML標記語言格式封裝，如下所示： <?xml version="1.0" encoding="utf-

18、8"?><wasu><stbid>1111000000000000300004C7E7</stbid><caid>8657110122223333</caid><regid>0x601</regid><dtvid>90001234567</ dtvid ><need1></need1><need2></need2><need3></need3><need4></need4>&l

19、t;a id=""></a></wasu>數(shù)據(jù)格式說明：xml數(shù)據(jù)格式分成兩部分，一是每次生成時，必須存在的部分，標簽包括wasu、stbid、caid、regid、dtvid、need14；二是業(yè)務(wù)數(shù)據(jù)，即a標簽內(nèi)容，此標簽屬性ID為業(yè)務(wù)ID序號，具體規(guī)則見附錄A，標簽值由業(yè)務(wù)自身決定，客戶端（解析軟件）根據(jù)相應(yīng)規(guī)則解析。xml字段說明如表8-3：標簽定義長度是否可選wasu華數(shù)標識，判斷二維碼是否合法-必選stbid終端識別號26字節(jié)必選caidCA卡號16字節(jié)必選regid區(qū)域號8字節(jié)必選（獲取不到時為空）dtvid數(shù)字電視號11字節(jié)必須

20、（獲取不到時為空）need1need4必須生成的標簽，具體含義預(yù)留，默認值為空32字節(jié)必選a由前端下發(fā)的一段數(shù)據(jù) 110個字節(jié)可選表8-3 標簽說明表8.4 數(shù)據(jù)存儲前端下發(fā)的數(shù)據(jù)字符總長度不能超過110個字節(jié)，在終端存儲空間為4KB，如表8-4所示，表中業(yè)務(wù)ID規(guī)則，詳見附錄A。存儲空間索引二級索引值330字節(jié)（業(yè)務(wù)ID）類型編號（業(yè)務(wù)ID）序號key1：value1，key2：value2； 表8-4 數(shù)據(jù)存儲格式說明：一個業(yè)務(wù)在使用二維碼時，允許在終端存儲330字節(jié)數(shù)據(jù)，二維碼模塊能根據(jù)業(yè)務(wù)ID類型編號，獲取該業(yè)務(wù)下所有數(shù)據(jù)，并根據(jù)業(yè)務(wù)ID序號，獲取具體的數(shù)值。8.5 數(shù)據(jù)顯示在業(yè)務(wù)顯示

21、二維碼時，根據(jù)業(yè)務(wù)ID類型編號，獲取該業(yè)務(wù)下所有數(shù)據(jù)，并合并必須生成的數(shù)據(jù)（STBID、CAID、REGID、DTVID），組成XML，該業(yè)務(wù)下如有多條數(shù)據(jù)，則有多個<a>標簽，并且每個<a>標簽的ID不同。當前端有二維碼更新時，終端顯示最新二維碼圖；當用戶操作時，二維碼圖消失。二維碼圖顯示在屏幕的最上層，當前端有二維碼更新時，終端顯示最新二維碼圖；當用戶操作時，二維碼圖消失；二維碼背景底色為白色，大小超出二維碼圖（具體超出部分由終端自身決定）。8.6 異常處理圖8-6 二維碼異常場景圖二維碼模塊在獲取不到數(shù)據(jù)或者獲取到的數(shù)據(jù)長度過長時，終端將會提示“二維碼生成異?！毙?/p>

22、息。附錄A 業(yè)務(wù)ID規(guī)則AA BB類型編號序號例如： 01 02 格式： AA BB AA值定義01云服務(wù)注：AA、BB都為16進制數(shù)據(jù)，類型編號由華數(shù)定義（見上表），業(yè)務(wù)序號由業(yè)務(wù)本身決定。附錄B 二維碼操作指令格式二維碼操作TS指令格式如下：16B32B4B125B空置32字節(jié)終端ID操作方式具體數(shù)據(jù)1字節(jié)1字節(jié)1字節(jié)122字節(jié)函數(shù)接口類型（0：顯示接口；1：保存接口）接口操作事件類型數(shù)據(jù)長度數(shù)據(jù)結(jié)構(gòu)下面是對二維碼中125字節(jié)數(shù)據(jù)格式定義和組裝實例代碼：unsigned char gchOpsType = 0;unsigned char gchBsTypeId = 0;unsigned c

23、har gchAid = 0; /xml 中的a id =""unsigned char gchData100 = "" /xml <a id="">字符串</a>unsigned char x4 = "" unsigned char y4 = "" unsigned char width4 = "" unsigned char height4 = "" unsigned char second4 = "" /顯

24、示時長（秒）void SendMsg()char chData125 = ""char *pch = NULL;int iSenLen = 0;chData0 = gchOpsType;chData1 = '0'chData2 = 2+Str_Len(gchData);chData3 = gchAid;chData4 = gchBsTypeId;pch = chData+5;if(Str_Len(gchData) > 100)printf("send msg:string len >100 ,error!");return ;Str_N_Copy(pch,gchData,Str_Len(gchData);p