盛大在線 SDOA 技術(shù) 白皮書 Version 1.0 2009 年 5 月 第 I 頁 共 12 頁 目 錄 第 1 章 前言 . 2 第 2 章 概述 . 2 第 3 章 產(chǎn)品介紹 . 2 一、 產(chǎn)品說明 . 2 二、 產(chǎn)品功能 . 4 第 4 章 產(chǎn)品接入 . 4 一、 接入流程 . 4 1. C/S 架構(gòu)應(yīng)用接入開發(fā)概述 . 5 1. B/S 架構(gòu)應(yīng)用接入開發(fā)概述 . 9 二、 配置說明 . 10 三、 聯(lián)調(diào)測試 . 10 四、 上線過程 . 10 第 5 章 安全性評估 . 10 一、 帳戶安全 . 10 二、 文件安全 . 10 第 I 頁 共 12 頁 文檔版權(quán)信息聲明 名詞解釋 術(shù)語 解 釋 SDO 盛大在線（ SNDA Online）的縮寫。 盛大通行證 盛大通行證是指 在盛大在線注冊的 用戶帳號， 該賬號可 登錄任何一款 接入盛大在線平臺的游戲、網(wǎng)站和應(yīng)用等 ，俗稱“一號通” 盛大點券 盛大點券是盛大在線推出的用于 在盛大在線所支持的應(yīng)用中進行消費的虛擬點券 ， 通過購買盛大娛樂卡可充值得到盛大點券。 1 元人民幣相當于 100點盛大點券。 用戶賬戶上的盛大點券 可在盛大在線盛大在線所支持的應(yīng)用中通行使用 。 盛大圈圈 盛大圈圈是 SDOA 產(chǎn)品的客戶端，通過相關(guān)接口（ API）集成到 SP 的內(nèi)容產(chǎn)品中，盛大圈圈基于 Widget相關(guān)技術(shù)標準可非?？旖莘奖愕膶⒏鞣N功能、服務(wù)和外部應(yīng)用發(fā)布到游戲中，為游戲提供豐富的功能、服務(wù) 內(nèi)容的擴展能力。 （ /web/index.asp） 。 點券劃賬 點券劃賬是本產(chǎn)品支持的支付方式之一，指從盛大通行證賬戶中劃 出一部分點券轉(zhuǎn)入合作應(yīng)用的賬戶中，從而 使得 用戶在該應(yīng)用中 能進行 消費。 道具扣費 道具扣費是本產(chǎn)品支持的支付方式之一，指盛大通行證用戶在合作伙伴提供的應(yīng)用中進行購買道具等消費操作時，直接通過調(diào)用盛大的計費接口進行賬戶扣費，完成消費的功能。 SDK SDK， Software Development Kit，軟件開發(fā)工具包，本產(chǎn)品的 SDK 為一個壓縮文件包，里面提供產(chǎn)品程序組件 、 接入示例 、 文檔 、 演示程序等內(nèi)容。 SP SP, Service provider, 服務(wù)提供商。 本文中出現(xiàn)的任何文字敘述、文檔格式、插圖、照片、方法、過程等內(nèi)容，除另有特別注明，版權(quán)均屬盛 大在線所有，并受到有關(guān)產(chǎn)權(quán)及版權(quán)法保護。任何個人、機構(gòu)未經(jīng)盛大在線的書面授權(quán)許可，不得以任何方式復(fù)制或引用本文的任何片斷。 第 2 頁 共 12 頁 第 1章 前言 本文檔用作 SDOA 產(chǎn)品 的 技術(shù) 介紹資料 ，旨在讓讀者了解 產(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） 提供 開放 、 標準的接口 ， 涵蓋 登錄、支付 、客戶服務(wù)、用戶推廣、積分等多項功能和服務(wù) ， 為 SP 提供全方位的用 戶運營 和服務(wù) 解決方案 。 第 3章 產(chǎn)品 介紹 一、 產(chǎn)品說明 SDOA 產(chǎn)品包含客戶端、服務(wù)端、 SDK 等相關(guān)模塊， 以及相關(guān)產(chǎn)品文檔與技術(shù)手冊 幫助SP 進行使用 。其中 ： SDK 分為 For B/S 和 For C/S 兩種不同技術(shù)架構(gòu)下的版本，并針對不同的開發(fā)語言和操作系統(tǒng)平臺提供多個版本。 SDk 包含了 SDOA 產(chǎn)品 客戶端、服務(wù)端 與 SP 內(nèi)容產(chǎn)品集成所需要的接口 （ API） 及必要的程序組件。 產(chǎn)品客戶端 是帶 用戶 界面的一套程序組件， 通過相關(guān)接口 （ API）與 SP 內(nèi)容產(chǎn)品客戶端 進行集成 ，供終端用戶使用，終端用戶通過 產(chǎn)品 客戶端可獲得盛大在線提供的各種功 能和服務(wù) ，客戶端相關(guān)接口都通過 SDK 提供給 SP。 （ 注：產(chǎn)品客戶端在下文中我們會統(tǒng)稱為盛大圈圈或圈圈 ）。 產(chǎn)品服務(wù)端由盛大在線運維管理，通過相關(guān)接口與 SP 內(nèi)容產(chǎn)品的客戶端或服務(wù)端進行 集成 ， 從而提供為 SP 和終端用戶 相關(guān)功能與 服務(wù) ，相關(guān)接口都通過 SDK 提供給 SP。 產(chǎn)品 結(jié)構(gòu) 示意 圖如下（圖 1）： 第 3 頁 共 12 頁 圖 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)品終端用戶 展示 示意圖 第 4 頁 共 12 頁 二、 產(chǎn)品 功能 SDOA 產(chǎn)品 集成了盛大在線為用戶提供的一系列服務(wù)，同時為 SP 提供了一套完善的接口與流程來幫助 SP 集成這些服務(wù)，使得這些服務(wù)能幫助 SP 更好的服務(wù)終端用戶。 SDOA 產(chǎn)品 為用戶提供的 相關(guān)服務(wù)包括： 用戶登錄 服務(wù) 在盛大圈圈中提供了一個用戶登陸界面，通過該界面用戶可完成 基于用戶名 /口令的基礎(chǔ) 認證服務(wù) 和強化的 動態(tài)口令認證服務(wù)（動態(tài)口令認證服務(wù)必須使用 盛大密寶 、 盛大 安全卡 等安全產(chǎn)品），并通過盛大圈圈把登陸相關(guān) 狀態(tài)數(shù)據(jù)提交給 SP產(chǎn)品來完成終端用戶在 SP 產(chǎn)品的認證。 用戶 充值服務(wù) 盛大在線 為用戶 提供 了 豐富的充值方式：實物卡充值、手機固話充值、手機卡充值、銀行卡充值、短信充值、聲訊充值、網(wǎng)吧直充等 ， 通過充值用戶可獲得盛大點券，而用戶可利用盛大點券在 SP 內(nèi)容產(chǎn)品中進行消費或劃賬。充值服務(wù)通過widget 形式在 盛大圈圈 中為用戶 提供 。 用戶 支付 服務(wù) 盛大在線用戶可利用盛大點券在 SP 內(nèi)容產(chǎn)品中進行消費，盛大在線為用戶提供兩種消費方式：道具計費方式和點券劃賬方式，前者用戶直接可以利用盛大點券在 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)品中進行虛擬物品的支付消費。 動態(tài)口令認證服務(wù) （或稱密寶認證服務(wù)） 為了加強對用戶虛擬財產(chǎn)的保護，盛大 在線 推出了安全卡 、 密寶等 多種動態(tài)口令 安全認證產(chǎn)品 （密寶、安全卡的介紹參見以下地址：/ekey/index.asp）。 SP 內(nèi)容產(chǎn)品接入 SDOA 產(chǎn)品后 ， 盛大在線 用戶登錄 該內(nèi)容產(chǎn)品 時 就 可以使用到這些 強化的 安全認證 服務(wù) （用戶必須購買這些安全認證產(chǎn)品之后才能使用該項服務(wù)） 。 統(tǒng)一幫助服務(wù) 盛大在線基于圈圈提供統(tǒng)一的幫助服務(wù)，將業(yè)界領(lǐng)先的幫助服務(wù)提供給應(yīng)用的用戶 ，為 您打開全方位服務(wù)通路、 7x24 小時千人呼叫坐席的專業(yè)客戶服務(wù) 。 積分服務(wù) 接入本產(chǎn)品的應(yīng)用可以使用積分服務(wù)， 為您用戶的消耗提供多行業(yè)互通合作的積分體系支持，專享積分兌換、活動定制！ 分紅 服務(wù) 接入本產(chǎn)品后，可以選擇接入分紅服務(wù)，這樣將獲得 全國 110 萬位推廣員為您帶來個性化的、面向身邊用戶的銷售推廣服務(wù)！ 第 4章 產(chǎn)品 接入 一、 接入流程 在完成 了 對本 產(chǎn)品的了解 后 ， 您可以 在 SDOA 官方網(wǎng)站 ()上 根據(jù)您的 第 5 頁 共 12 頁 應(yīng)用是 B/S 架構(gòu) 還是 C/S 架構(gòu) 下載 相應(yīng)的 SDK，開始接入開發(fā)。 下載到的 SDK 包含接入開發(fā)所需的程序組件，演示程序，示例代碼，測試小工具等內(nèi)容。您將在 Client 目錄獲得 盛大 圈圈 相關(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ā)過程進行簡單的描述 ： 1. C/S 架構(gòu)應(yīng)用接入開發(fā)概述 1) 盛大圈圈接入 簡單來說， 盛大圈圈 接入的過程如下： 加載并初始化 IGW 組件 傳遞用戶角色、區(qū)組信息 顯示 IGW 界面 調(diào)用應(yīng)用接口 參見 LoadIGW(D3D9)、 LoadIGW(D3D8)、LoadIGW(DDraw)、 LoadIGW(OpenGL)。 參見 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è)置邊欄位置，打開某 個頁面等功能，參見 ISDOAApp，完整的 IGW 接口參見 C/S 架構(gòu)應(yīng)用接入 。 第 6 頁 共 12 頁 2) 用戶登錄 圖 4.用戶登錄流程示意圖 上圖中首先 由應(yīng)用客戶端 調(diào)用 IGW 的 ShowLoginDialog 函數(shù)啟動登錄界面 （第 1 步） ， IGW收到認證結(jié)果 （第 3 步） ，傳回給客戶端，此時，客戶端需要將 認證結(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ù)端組件使用說明 參見 ISDOAApp:ShowLoginDialog 1. Initialize 函數(shù)初始化登錄功能（包括下載配置文件 sdoa4server.ini）。 2. 如果使用異步方式 在服務(wù)端獲取驗證結(jié)果 ，則需要實現(xiàn)一個回調(diào)函數(shù)UserInfoCallback ，然后在認證時使用AsyncGetUserInfo 函數(shù)與盛大在線平 臺通信驗證登錄結(jié)果 ; 3. 如果使用同步方式 在服務(wù)端獲取驗證結(jié)果 ，則使用 SyncGetUserInfo 函數(shù)獲得登錄結(jié)果。 第 7 頁 共 12 頁 3) 充值功能接入 用戶帳戶充值功能由圈圈提代，并且不需要接入應(yīng)用參與。 4) 支付功能 應(yīng)用可以選用道具計費或點券劃帳方式提供支付功能。 a) 道具計費 圖 5.道具計費流程示意圖 如上圖所示，應(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。 參見 ISDOAOrderHandler 類的 Initialize 函數(shù) 1. GetUniqueId 生成訂單號 ; 2. 使用 CreateOrderInfo ，SetOrderInfoValue 將訂單信息包裝成ORDERINFO 對象； 3. 調(diào)用 BuildOrderUrl 函數(shù)，獲得包含訂單信息的一個計費請求 URL 地址字符串 第 8 頁 共 12 頁 將生成的 URL 發(fā)送到客戶端 。 客戶端通過 IGW 發(fā)出請求。 應(yīng)用服務(wù)端接收發(fā)貨通知，發(fā)送道具 參見 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)用管理，在用戶消費時應(yīng)用自行扣除相應(yīng)余額即可。 此流程應(yīng)用只需實現(xiàn)一個接口 ： 劃帳接收接口 參見 訂單反饋接口 ，也可以提供 回調(diào)函數(shù)給本產(chǎn)品服務(wù)端組件調(diào)用，由服務(wù)端組件程序自動與盛大在線建立 Socket 連接來接收消息。 至此，完成主要業(yè)務(wù)功能的開發(fā)。 第 9 頁 共 12 頁 1. B/S 架構(gòu)應(yīng)用接入開發(fā)概述 B/S（ Browser/Server） 架 構(gòu)即瀏覽器和服務(wù)器架構(gòu)，由瀏覽器作為客戶端與用戶交互，并與遠端的服務(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 接入非常簡單，只需在頁面中加入幾行腳本即可，參見 IBW 接入 。 接入后，圈圈在頁面中顯示效果類似 下 圖： 圖 2.IBW 接入效果示意圖 圈圈接入后，應(yīng)用需要將一些重要數(shù)據(jù)通知給 IBW，參見 設(shè)置 屬性 。 2) 用戶登錄功能接入 BS 架構(gòu)應(yīng)用需基于 CAS（ Central Authentication Service,是盛大通行證在 Web 應(yīng)用中的統(tǒng)一認證系統(tǒng)）系統(tǒng)完成盛大通行證登錄功能的接入。 此步驟參見 CAS 登錄 。 用戶登錄分為 CAS 認證過程，和 Token 驗證兩個步驟，就是說頁面先跳轉(zhuǎn)到 CAS 的登錄界面（如果使用 IBW 的 ibw_public.openLoginWindow()函數(shù)打開登錄界面，則開始不用跳轉(zhuǎn)用戶使用的頁面 ） 完成用戶認證，然后 CAS 會將頁面跳轉(zhuǎn)回應(yīng)用界面，并在 URL 參數(shù)中加上 Token，然后應(yīng)用服務(wù)端用此 Token 和 CAS 服務(wù)器通信取得用戶登錄結(jié)果。 用戶登錄成功后，需要設(shè)置記錄用戶的一些屬性，參見 設(shè)置 屬性 。 3) 充值功能接入 參見 充值功能接入 。 第 10 頁 共 12 頁 4) 支付功能接入 參見 支付功能 。 二、 配置說明 使用本產(chǎn)品 SDK 時，需要做以下環(huán)境配置： 使用服務(wù)端組件服務(wù)器需有訪問以下 ip 的權(quán)限： 聯(lián)調(diào)測試環(huán)境： 4 9061 端口 正式運營環(huán)境： 37 9061 端口 調(diào)用 服務(wù)端組件的程序啟動后，會下載 sdoaconfig.dat 文件，其中 “