伺服器校驗(必接)
作用
- 在玩家登錄成功,玩家選擇完伺服器之後,點擊“開始遊戲”按鈕時,調用該接口,檢測選擇的伺服器狀態是否正常,後臺記錄玩家登錄的伺服器信息。在捕獲到伺服器狀態正常的情況下才可進入遊戲。如果當前伺服器是在關服維護狀態,SDK會彈出維護提示並返回error,此時遊戲應繼續停留在此界面停止進入遊戲的後續邏輯,以讓玩家可以選擇其他伺服器或等待伺服器開啟。
- 此接口傳入的伺服器信息應為玩家最後登錄的伺服器信息,當遊戲使用遊戲的選服頁界面的時候,務必傳入正確的serverid,SDK會根據傳入的serverid值去SDK服務器後臺檢查這個伺服器狀態。
圖示

- 如圖,在玩家點擊“開始遊戲”按鈕時,調用該接口,檢驗玩家選擇的伺服器狀態。
函數
objective-c
- (void)gamedreamerCheckServerWithServerId:(NSString *)serverid
andCompletion:(void (^)(NSDictionary *userInfo, NSError *error))detectInfoCallback;參數
| 參數名 | 是否可空(是/否) | 說明 |
|---|---|---|
| serverid | 否 | 當前玩家使用的serverid,請務必傳入此參數 |
回調
serverInfo參數:
| 字段 | 說明 |
|---|---|
| address | 伺服器地址 |
| gamecode | 遊戲的標識Code |
| port | 端口號 |
| serverName | 伺服器名稱 |
| servercode | 伺服器id |
| repairNoticeContext | 伺服器維護公告內容,可空 |
error參數(當其參數不為空的時候,就表示校驗失敗。此時SDK會彈出失敗的提示。)
示例代碼
objective-c
[[GamedreamerManager shareInstance] gamedreamerCheckServerWithServerId:@"伺服器id" andCompletion:^(NSDictionary *serverInfo, NSError *error){
if(error){
//伺服器維護中,停止進入遊戲的邏輯,停留在本頁面
}else{
//進入遊戲處理
}
}];