ioGame網絡游戲框架

????????讓網絡游戲服務器的編程變得輕松簡單！

架構簡圖

?

ioGame 支持 3 種類型的通訊方式，分別是單次請求處理、推送、邏輯服間的相互通信；下面分別對這 3 種類型的通訊方式的使用上舉幾個例子。

1.單次請求處理

????1.1 請求、無響應

????????當請求端發起請求后，邏輯服不會發送任何響應給請求端?？梢杂迷谠诰W絡通訊中，存在著不需要接收方回執確認的調用模型，如數據采集的場景: 打點采集、日志傳輸、metrics上報等。

????1.2 請求、響應

????????請求、響應是在游戲開發中常見的通訊模式，也就是通訊的一方發出請求，而遠程通訊的對方做出響應，也就是常說的請求/響應模式。

????????比如：裝備的升級、人物的升級、玩家的移動、抽獎、游戲前端到某一個場景時需要從游戲服務端獲取一些對應的場景配置等；

?

2.推送

????2.1 指定單個或多個用戶廣播（推送）

????????向一個或多個指定的用戶（玩家）主動發送一些數據。?比如：

????????????給指定的在線玩家發送一些獎勵。

????????????給在同一個房間內的玩家廣播一些數據，如某一個玩家射擊子彈，把這子彈的數據廣播給房間內的其他玩家。如幾個玩家在同一個房間內打牌，某個玩家出牌后，把這張牌的數據廣播給房間內的其他玩家。

2.2 全服廣播（推送）

????給全服的所有在線玩家廣播消息，如廣播公告、即將停服維護等。

3.邏輯服間的相互通信

????3.1 單個邏輯服與單個邏輯服通信請求（可跨進程）

????????邏輯服與邏輯服之間的相互請求通信

????????比如：我們有兩個游戲邏輯服，分別是：a.天氣預報邏輯服、b.戰斗邏輯服?，F在我們設想一個回合制游戲的戰斗場景，需要配合天氣，根據天氣來增強或者減弱某個英雄的能力。那么在戰斗開始前，戰斗邏輯服只需要向游戲網關發起一個獲取當前天氣的請求，就可以得到當前的天氣信息了，在根據當前的天氣數據來增強或減弱該英雄的能力。

????????又比如：a.大廳邏輯服、b.獎勵發放邏輯服。大廳記錄著一些數據（房間總數），獎勵發放邏輯服根據當前的房間數量，來生成不同獎品，隨機發放給在線用戶。

詳細示例可參考：邏輯服與邏輯服之間的交互示例

????3.2 單個邏輯服與同類型多個邏輯服通信請求（可跨進程）

????????比如：象棋邏輯服有 3 臺， 每臺邏輯服都有一個唯一的 邏輯服 id；我們可以在大廳邏輯服中向同類型的多個游戲邏輯服通信請求（可跨進程），意思是大廳發起一個向這 3 臺象棋邏輯服的請求，框架會聚合 3個結果集，（假設結果是：當前服務器房間數）當大廳得到這個結果集，我們可以選擇房間最少人的象棋邏輯服，假設 《象棋邏輯服-1》 是房間數最少的，我們就可以把邏輯服 id 給到玩家所在的對外服，讓玩家在對外服記錄下來，之后這個玩家發起的請求就會自動的到 《象棋邏輯服-1》 這臺服務器上，不會把請求分配到其他的象棋邏輯服上。

最后，發揮你的想象力，把這 3 類通訊方式用活，可以滿足很多業務。

網絡游戲框架簡介

????ioGame 是國內首個基于螞蟻金服 sofa-bolt 的網絡游戲框架，游戲框架由 [網絡通信框架] 和 [業務框架] 組成。

• 網絡通信框架：負責服務器之間的網絡通信
• 業務框架：負責業務邏輯的處理方式和編寫方式

通過 ioGame 可以快速的搭建一個穩定的、高性能的、分步式的網絡游戲服務器。

broker （游戲網關）可以集群的方式部署，集群無中心節點、自帶負載均衡。

游戲框架借助于螞蟻金服 sofa-bolt 通信框架來提供穩定、高性能。

即使之前沒有游戲編程的經驗，也能參與到游戲編程中。如果你之前具備一些游戲開發或者 web MVC 相關的知識，則會更容易上手游戲服務器的開發。

網絡通信框架 - SOFABolt

SOFABolt 是螞蟻金融服務集團開發的一套基于 Netty 實現的網絡通信框架。

• 為了讓 Java 程序員能將更多的精力放在基于網絡通信的業務邏輯實現上，而不是過多的糾結于網絡底層 NIO 的實現以及處理難以調試的網絡問題，Netty 應運而生。
• 為了讓中間件開發者能將更多的精力放在產品功能特性實現上，而不是重復地一遍遍制造通信框架的輪子，SOFABolt 應運而生。

Bolt 名字取自迪士尼動畫-閃電狗，是一個基于 Netty 最佳實踐的輕量、易用、高性能、易擴展的通信框架。

業務框架

如果說 sofa-bolt 為了讓 Java 程序員能將更多的精力放在基于網絡通信的業務邏輯實現上。而業務框架正是解決業務邏輯如何方便的實現這一問題上。

業務框架是游戲框架的一部份，職責是簡化程序員的業務邏輯實現。業務框架使程序員能夠快速的開始編寫游戲業務。

內置多種可選模塊，可按需選擇，以方便應用開發：

• 領域事件 （disruptor 實現類似Spring事件驅動模型 ApplicationEvent）
• 任務延時器 （將來某個時間可對任務進行執行、暫停、取消等操作，并不是類似 Quartz 的任務調度）
• 多環境切換 （不同運行環境下的配置支持）
• light-jprotobuf （補足 jprotobuf 不能讓多個對象在單個 .proto 源文件中生成的需求，并簡化jprotobuf對源文件的注釋）

• 分步式鎖 (基于Redisson的簡單實現)

內置的其他功能：

• 心跳相關
• 用戶上線、離線相關的鉤子方法
• UserSessions （對所有用戶UserSession的管理，統計在線用戶等）
• UserSession (與 channel 是 1:1 的關系，可取到對應的 userId、channel 等信息。)
• 登錄相關

集成相關：

• spring 集成 （業務框架可以方便的與 spring 進行集成，5 行代碼）

后續計劃：

• 抽象通用的游戲邏輯 （進一步減少開發實踐過程中的工作量）
• 步驟表
• 幀同步
• 狀態同步

抽象的說，游戲前端與游戲服務端的的交互由上圖組成。游戲前端與游戲服務端可以自由的雙向交互，交互的業務數據由 .proto 作為載體。

協議文件

協議文件是對業務數據的描述載體，用于游戲前端與游戲服務端的數據交互。Protocol Buffers (ProtocolBuffer/ protobuf )是Google公司開發的一種數據描述語言，也簡稱 PB。當然協議文件描述還可以是 json、xml或者任意自定義的，因為最后傳輸時會轉換為二進制，但游戲開發中 PB 是目前的最佳。

游戲前端可以是 Unity、 UE(虛幻)、 Cocos或者其他的游戲引擎。

/** 請求 */
@ProtobufClass
@FieldDefaults(level = AccessLevel.PUBLIC)
public class HelloReq {
    String name;
}

@ActionController(1)
public class DemoAction {
    @ActionMethod(0)
    public HelloReq here(HelloReq helloReq) {
        HelloReq newHelloReq = new HelloReq();
        newHelloReq.name = helloReq.name + ", I'm here ";
        return newHelloReq;
    }
}

┏━━━━━ Debug. [(DemoAction.java:4).here] ━━━ [cmd:1 - subCmd:0 - cmdMerge:65536]
┣ userId : 888
┣ 參數: helloReq : HelloReq(name=塔姆)
┣ 響應: HelloReq(name=塔姆, I'm here )
┣ 時間: 0 ms (業務方法總耗時)
┗━━━━━ Debug [DemoAction.java] ━━━