81556367157 盛大在線 SDOA 技術(shù)白皮書 Version 10 5月 目

1、盛大在線 sdoa技術(shù)白皮書version 1.02009年5月目 錄第1章前言2第2章概述2第3章產(chǎn)品介紹2一、產(chǎn)品說明2二、產(chǎn)品功能4第4章產(chǎn)品接入4一、接入流程41.c/s架構(gòu)應(yīng)用接入開發(fā)概述51.b/s架構(gòu)應(yīng)用接入開發(fā)概述8二、配置說明9三、聯(lián)調(diào)測試10四、上線過程10第5章安全性評估10一、帳戶安全10二、文件安全10第 10 頁 共 12 頁文檔版權(quán)信息聲明本文中出現(xiàn)的任何文字?jǐn)⑹?、文檔格式、插圖、照片、方法、過程等內(nèi)容，除另有特別注明，版權(quán)均屬盛大在線所有，并受到有關(guān)產(chǎn)權(quán)及版權(quán)法保護(hù)。任何個人、機構(gòu)未經(jīng)盛大在線的書面授權(quán)許可，不得以任何方式復(fù)制或引用本文的任何片斷。 名詞解釋術(shù)語

2、解 釋sdo盛大在線（snda online）的縮寫。盛大通行證盛大通行證是指在盛大在線注冊的用戶帳號，該賬號可登錄任何一款接入盛大在線平臺的游戲、網(wǎng)站和應(yīng)用等，俗稱“一號通”盛大點券盛大點券是盛大在線推出的用于在盛大在線所支持的應(yīng)用中進(jìn)行消費的虛擬點券，通過購買盛大娛樂卡可充值得到盛大點券。1元人民幣相當(dāng)于100點盛大點券。用戶賬戶上的盛大點券可在盛大在線盛大在線所支持的應(yīng)用中通行使用。盛大圈圈盛大圈圈是sdoa產(chǎn)品的客戶端，通過相關(guān)接口（api）集成到sp的內(nèi)容產(chǎn)品中，盛大圈圈基于widget相關(guān)技術(shù)標(biāo)準(zhǔn)可非常快捷方便的將各種功能、服務(wù)和外部應(yīng)用發(fā)布到游戲中，為游戲提供豐富的功能、服務(wù)內(nèi)容

3、的擴(kuò)展能力。（點券劃賬點券劃賬是本產(chǎn)品支持的支付方式之一，指從盛大通行證賬戶中劃出一部分點券轉(zhuǎn)入合作應(yīng)用的賬戶中，從而使得用戶在該應(yīng)用中能進(jìn)行消費。道具扣費道具扣費是本產(chǎn)品支持的支付方式之一，指盛大通行證用戶在合作伙伴提供的應(yīng)用中進(jìn)行購買道具等消費操作時，直接通過調(diào)用盛大的計費接口進(jìn)行賬戶扣費，完成消費的功能。sdksdk，software development kit，軟件開發(fā)工具包，本產(chǎn)品的sdk為一個壓縮文件包，里面提供產(chǎn)品程序組件、接入示例、文檔、演示程序等內(nèi)容。spsp, service provider, 服務(wù)提供商。第1章 前言本文檔用作sdoa產(chǎn)品的技術(shù)介紹資料，旨在讓讀者了

4、解產(chǎn)品的框架、模塊、復(fù)雜度、對接入應(yīng)用的影響、成本、風(fēng)險。預(yù)期讀者是接入應(yīng)用的項目經(jīng)理、技術(shù)經(jīng)理等需要了解產(chǎn)品技術(shù)框架、功能模塊、影響、成本、風(fēng)險、開發(fā)過程等方面情況的讀者。第2章 概述sdoa全稱snda openapi，是盛大在線利用自身多年積累的用戶資源、運營技術(shù)、渠道優(yōu)勢和服務(wù)經(jīng)驗等，通過以開放技術(shù)架構(gòu)整合形成的用戶運營與服務(wù)產(chǎn)品，該產(chǎn)品針對所有互聯(lián)網(wǎng)娛樂內(nèi)容運營商（簡稱sp）提供開放、標(biāo)準(zhǔn)的接口，涵蓋登錄、支付、客戶服務(wù)、用戶推廣、積分等多項功能和服務(wù)，為sp提供全方位的用戶運營和服務(wù)解決方案。第3章 產(chǎn)品介紹一、 產(chǎn)品說明sdoa產(chǎn)品包含客戶端、服務(wù)端、sdk等相關(guān)模塊，以及相關(guān)產(chǎn)

5、品文檔與技術(shù)手冊幫助sp進(jìn)行使用。其中：l sdk分為for b/s和for c/s兩種不同技術(shù)架構(gòu)下的版本，并針對不同的開發(fā)語言和操作系統(tǒng)平臺提供多個版本。sdk包含了sdoa產(chǎn)品客戶端、服務(wù)端與sp內(nèi)容產(chǎn)品集成所需要的接口（api）及必要的程序組件。l 產(chǎn)品客戶端是帶用戶界面的一套程序組件，通過相關(guān)接口（api）與sp內(nèi)容產(chǎn)品客戶端進(jìn)行集成，供終端用戶使用，終端用戶通過產(chǎn)品客戶端可獲得盛大在線提供的各種功能和服務(wù)，客戶端相關(guān)接口都通過sdk提供給sp。（注：產(chǎn)品客戶端在下文中我們會統(tǒng)稱為盛大圈圈或圈圈）。l 產(chǎn)品服務(wù)端由盛大在線運維管理，通過相關(guān)接口與sp內(nèi)容產(chǎn)品的客戶端或服務(wù)端進(jìn)行集成，

6、從而提供為sp和終端用戶相關(guān)功能與服務(wù)，相關(guān)接口都通過sdk提供給sp。產(chǎn)品結(jié)構(gòu)示意圖如下（圖1）： 圖1.產(chǎn)品結(jié)構(gòu)圖（綠顏色部分為sdoa產(chǎn)品模塊）sdoa產(chǎn)品整合盛大在線的用戶資源，通過相關(guān)服務(wù)產(chǎn)品和功能模塊為用戶提供盛大在線的服務(wù)，這些服務(wù)產(chǎn)品和功能都整合在盛大圈圈中，通過嵌入到sp的內(nèi)容產(chǎn)品中來展現(xiàn)給終端用戶。sdoa產(chǎn)品對終端用戶的展現(xiàn)形式如（圖2）所示： 圖2.sdoa產(chǎn)品終端用戶展示示意圖二、 產(chǎn)品功能sdoa產(chǎn)品集成了盛大在線為用戶提供的一系列服務(wù)，同時為sp提供了一套完善的接口與流程來幫助sp集成這些服務(wù)，使得這些服務(wù)能幫助sp更好的服務(wù)終端用戶。sdoa產(chǎn)品為用戶提供的相關(guān)

7、服務(wù)包括：l 用戶登錄服務(wù)在盛大圈圈中提供了一個用戶登陸界面，通過該界面用戶可完成基于用戶名/口令的基礎(chǔ)認(rèn)證服務(wù)和強化的動態(tài)口令認(rèn)證服務(wù)（動態(tài)口令認(rèn)證服務(wù)必須使用盛大密寶、盛大安全卡等安全產(chǎn)品），并通過盛大圈圈把登陸相關(guān)狀態(tài)數(shù)據(jù)提交給sp產(chǎn)品來完成終端用戶在sp產(chǎn)品的認(rèn)證。l 用戶充值服務(wù)盛大在線為用戶提供了豐富的充值方式：實物卡充值、手機固話充值、手機卡充值、銀行卡充值、短信充值、聲訊充值、網(wǎng)吧直充等，通過充值用戶可獲得盛大點券，而用戶可利用盛大點券在sp內(nèi)容產(chǎn)品中進(jìn)行消費或劃賬。充值服務(wù)通過widget形式在盛大圈圈中為用戶提供。l 用戶支付服務(wù)盛大在線用戶可利用盛大點券在sp內(nèi)容產(chǎn)品中進(jìn)

8、行消費，盛大在線為用戶提供兩種消費方式：道具計費方式和點券劃賬方式，前者用戶直接可以利用盛大點券在sp內(nèi)容產(chǎn)品中購買各種虛擬物品，后者用戶可將盛大點券劃賬轉(zhuǎn)換為sp內(nèi)容產(chǎn)品中的虛擬點券，最終利用這些虛擬點券來購買各種虛擬物品。該項服務(wù)通過以api的方式提供給sp，sp可在sdk中獲得這些api，sp將這些api集成到內(nèi)容產(chǎn)品中后，終端用戶即可利用該項服務(wù)在sp的內(nèi)容產(chǎn)品中進(jìn)行虛擬物品的支付消費。l 動態(tài)口令認(rèn)證服務(wù)（或稱密寶認(rèn)證服務(wù)）為了加強對用戶虛擬財產(chǎn)的保護(hù)，盛大在線推出了安全卡、密寶等多種動態(tài)口令安全認(rèn)證產(chǎn)品（密寶、安全卡的介紹參見以下地址：l 統(tǒng)一幫助服務(wù)盛大在線基于圈圈提供統(tǒng)一的幫助

9、服務(wù)，將業(yè)界領(lǐng)先的幫助服務(wù)提供給應(yīng)用的用戶，為您打開全方位服務(wù)通路、7x24小時千人呼叫坐席的專業(yè)客戶服務(wù)。l 積分服務(wù)接入本產(chǎn)品的應(yīng)用可以使用積分服務(wù)，為您用戶的消耗提供多行業(yè)互通合作的積分體系支持，專享積分兌換、活動定制！l 分紅服務(wù)接入本產(chǎn)品后，可以選擇接入分紅服務(wù)，這樣將獲得全國110萬位推廣員為您帶來個性化的、面向身邊用戶的銷售推廣服務(wù)！第4章 產(chǎn)品接入一、 接入流程在完成了對本產(chǎn)品的了解后，您可以在sdoa官方網(wǎng)站()上根據(jù)您的應(yīng)用是b/s架構(gòu)還是c/s架構(gòu)下載相應(yīng)的sdk，開始接入開發(fā)。下載到的sdk包含接入開發(fā)所需的程序組件，演示程序，示例代碼，測試小工具等內(nèi)容。您將在clie

10、nt目錄獲得盛大圈圈相關(guān)的客戶端接入所需的內(nèi)容，在server目錄獲得服務(wù)端需要接入的組件的內(nèi)容。如果需要聯(lián)調(diào)、測試，則您需要在官方網(wǎng)站上注冊產(chǎn)品，登記了服務(wù)器地址，獲得產(chǎn)品編號，整體來說，技術(shù)接入過程如下圖所示：圖3.sdoa產(chǎn)品接入流程示意圖下面分別對c/s架構(gòu)的內(nèi)容產(chǎn)品和b/s架構(gòu)的內(nèi)容產(chǎn)品接入開發(fā)過程進(jìn)行簡單的描述：1. c/s架構(gòu)應(yīng)用接入開發(fā)概述1) 盛大圈圈接入簡單來說，盛大圈圈接入的過程如下： 加載并初始化igw組件 傳遞用戶角色、區(qū)組信息 顯示igw界面 調(diào)用應(yīng)用接口參見loadigw(d3d9)、loadigw(d3d8)、loadigw(ddraw)、loadigw(ope

11、ngl)。參見setroleinfo、modifyappinfo參見showigw(d3d9)、showigw(d3d8)、showigw(ddraw)、showigw(opengl)。如打開用戶登錄界面，參見showlogindialog(d3d9)、showlogindialog(d3d8)、showlogindialog(ddraw)、showlogindialog(opengl)，或查詢余額，參見balance(d3d9)。注：以上環(huán)節(jié)完整代碼均在sdkclientsample目錄中。至此，輕松完成了基于igw的圈圈接入, 更多igw接口，如設(shè)置邊欄位置，打開某個頁面等功能，參見isd

12、oaapp，完整的igw接口參見 c/s架構(gòu)應(yīng)用接入。2) 用戶登錄圖4.用戶登錄流程示意圖上圖中首先由應(yīng)用客戶端調(diào)用igw的showlogindialog函數(shù)啟動登錄界面（第1步），igw收到認(rèn)證結(jié)果（第3步），傳回給客戶端，此時，客戶端需要將認(rèn)證結(jié)果傳給應(yīng)用服務(wù)端（第4步），應(yīng)用服務(wù)端使用sdoa服務(wù)端組件獲取驗證結(jié)果（第5步）。接入開發(fā)需要完成： 從sdkserver目錄下根據(jù)自己應(yīng)用服務(wù)器環(huán)境類型選擇對應(yīng)版本服務(wù)端組件版本，加入自己的工程文件中。 客戶端調(diào)用igw登錄界面的ui。 使用組件中的 isdoauserinfoauthen 類獲得用戶登錄結(jié)果 參見服務(wù)端組件使用說明參見isd

13、oaapp:showlogindialog1. initialize函數(shù)初始化登錄功能（包括下載配置文件sdoa4server.ini）。2. 如果使用異步方式在服務(wù)端獲取驗證結(jié)果，則需要實現(xiàn)一個回調(diào)函數(shù)userinfocallback ，然后在認(rèn)證時使用asyncgetuserinfo 函數(shù)與盛大在線平臺通信驗證登錄結(jié)果;3. 如果使用同步方式在服務(wù)端獲取驗證結(jié)果，則使用syncgetuserinfo函數(shù)獲得登錄結(jié)果。3) 充值功能接入用戶帳戶充值功能由圈圈提代，并且不需要接入應(yīng)用參與。4) 支付功能應(yīng)用可以選用道具計費或點券劃帳方式提供支付功能。a) 道具計費圖5.道具計費流程示意圖如上圖

14、所示，應(yīng)用商城收到用戶消費請求后（第1步），將消費信息用sdoa服務(wù)端組件的功能生成訂單扣費請求的url（第2步），服務(wù)端隨后將此url發(fā)送到客戶端交給igw發(fā)出支付請求（第3步），igw與盛大在線支付網(wǎng)關(guān)交互完成扣費（第4步），盛大在線支付網(wǎng)關(guān)再調(diào)用應(yīng)用的服務(wù)器的發(fā)貨接口，通知應(yīng)用發(fā)貨（第5步）。 初始化支付功能。 通過sdoa服務(wù)端組件生成扣費請求url。 將生成的url發(fā)送到客戶端。 客戶端通過igw發(fā)出請求。 應(yīng)用服務(wù)端接收發(fā)貨通知，發(fā)送道具參見isdoaorderhandler類的initialize函數(shù)1. getuniqueid生成訂單號;2. 使用createorderinfo

15、 ，setorderinfovalue 將訂單信息包裝成orderinfo對象；3. 調(diào)用buildorderurl 函數(shù)，獲得包含訂單信息的一個計費請求url地址字符串參見isdoaapp:showpaymentdialog回調(diào)接口可以是一個web接口，也可以提供回調(diào)函數(shù)給本產(chǎn)品服務(wù)端組件調(diào)用，由服務(wù)端組件程序自動與盛大在線建立socket連接來接收消息b) 點券劃帳圖6.點券劃帳流程示意圖如上圖所示，劃帳從圈圈開始，用戶在圈圈中完成整個劃帳的交互過程（第1步），此后，盛大在線支付網(wǎng)關(guān)完成余額扣除（第2步），再通知合作應(yīng)用的充值接口充值（第3步），用戶充到應(yīng)用中的余額，由應(yīng)用管理，在用戶消費

16、時應(yīng)用自行扣除相應(yīng)余額即可。此流程應(yīng)用只需實現(xiàn)一個接口： 劃帳接收接口參見訂單反饋接口 ，也可以提供回調(diào)函數(shù)給本產(chǎn)品服務(wù)端組件調(diào)用，由服務(wù)端組件程序自動與盛大在線建立socket連接來接收消息。至此，完成主要業(yè)務(wù)功能的開發(fā)。1. b/s架構(gòu)應(yīng)用接入開發(fā)概述b/s（browser/server）架構(gòu)即瀏覽器和服務(wù)器架構(gòu)，由瀏覽器作為客戶端與用戶交互，并與遠(yuǎn)端的服務(wù)器通信。web game和一般的網(wǎng)站都屬于b/s架構(gòu)。b/s架構(gòu)應(yīng)用接入開發(fā)分為三大步驟，分別是盛大圈圈接入、cas登錄、支付功能接入。1) 盛大圈圈（ibw）接入盛大圈圈在b/s架構(gòu)中基于ibw技術(shù)實現(xiàn)，ibw接入非常簡單，只需在頁面

17、中加入幾行腳本即可，參見ibw接入。接入后，圈圈在頁面中顯示效果類似下圖：圖2.ibw接入效果示意圖圈圈接入后，應(yīng)用需要將一些重要數(shù)據(jù)通知給ibw，參見設(shè)置屬性。2) 用戶登錄功能接入bs架構(gòu)應(yīng)用需基于cas（central authentication service,是盛大通行證在web應(yīng)用中的統(tǒng)一認(rèn)證系統(tǒng)）系統(tǒng)完成盛大通行證登錄功能的接入。此步驟參見cas登錄。用戶登錄分為cas認(rèn)證過程，和token驗證兩個步驟，就是說頁面先跳轉(zhuǎn)到cas的登錄界面（如果使用ibw的ibw_public.openloginwindow()函數(shù)打開登錄界面，則開始不用跳轉(zhuǎn)用戶使用的頁面）完成用戶認(rèn)證，然后c

18、as會將頁面跳轉(zhuǎn)回應(yīng)用界面，并在url參數(shù)中加上token，然后應(yīng)用服務(wù)端用此token和cas服務(wù)器通信取得用戶登錄結(jié)果。用戶登錄成功后，需要設(shè)置記錄用戶的一些屬性，參見設(shè)置屬性。3) 充值功能接入?yún)⒁姵渲倒δ芙尤搿?) 支付功能接入?yún)⒁娭Ц豆δ堋６?配置說明使用本產(chǎn)品sdk時，需要做以下環(huán)境配置： 使用服務(wù)端組件服務(wù)器需有訪問以下ip的權(quán)限：n 聯(lián)調(diào)測試環(huán)境：210.51.30.84 9061端口n 正式運營環(huán)境：61.172.252.237 9061端口 調(diào)用服務(wù)端組件的程序啟動后，會下載sdoaconfig.dat文件，其中“#本地偵聽端口” 沒有被其他應(yīng)用程序占用，服務(wù)端組件將占用該端口