This document is about: QUANTUM 2
SWITCH TO

API-BackboneClient


Available in the Gaming Circle and Industries Circle
Circle

命名空間: Gimmebreak.Backbone.Core

繼承: 物件 → 骨幹客戶端

骨幹客戶端是與骨幹後端互動的方法的進入點。
它封裝了http API客戶端,並且提供非同步方法以獲得更方便的執行方式。

C#

public sealed class BackboneClient

屬性

Game

獲得遊戲全域資料。(比如遊戲ID、全域屬性)

C#

public GameData Game
{
    get;
}

IsInitialized

確定客戶端是否成功地被初始化。

C#

public bool IsInitialized
{
    get;
}

IsUserLoggedIn

確定使用者是否被登入,並且有一個有效的階段以執行API調用。

C#

public bool IsUserLoggedIn
{
    get;
}

Notifications

獲得使用者通知資料。(比如錦標賽陣營邀請)

C#

public NotificationData Notifications
{
    get;
}

Season

獲得目前的賽季資料。(比如開始日期、結束日期、使用者賽季統計資料)

C#

public SeasonData Season
{
    get;
}

Tournaments

獲得使用者錦標賽資料。(比如錦標賽的清單)

C#

public TournamentData Tournaments
{
    get;
}

User

獲得使用者資料。(比如暱稱、平台ID、使用者屬性)

C#

public UserData User
{
    get;
}

方法

AcceptPartyInvite(long, long)

接受錦標賽陣營邀請。
使用者必須先註冊錦標賽,才能接受任何錦標賽陣營邀請。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.TournamentAcceptPartyStatus> AcceptPartyInvite(long tournamentId, long partyInviteId)

參數

  • tournamentId:錦標賽ID。
  • partyInviteId:錦標賽陣營邀請ID。

傳回

接受陣營邀請狀態。

備註

以通知方式來發送陣營邀請(錦標賽陣營邀請通知),並且它們含有錦標賽ID以及陣營邀請ID。

AcceptPartyInvite(long, string)

透過提供共享陣營代碼,來接收錦標賽陣營邀請。
使用者必須先註冊錦標賽,才能接受任何陣營邀請。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.TournamentAcceptPartyStatus> AcceptPartyInvite(long tournamentId, string partyCode)

參數

  • tournamentId:錦標賽ID。
  • partyCode:錦標賽陣營代碼。

傳回

接收陣營邀請狀態。

備註

透過調用針對錦標賽建立陣營代碼方法,來按照需要建立陣營代碼。
當一個陣營代碼結束,它可以與其他使用者共享(比如聊天),這些使用者可以使用它來加入陣營。

ChangeNickname(string)

更改使用者暱稱。
將在獲勝時給予獨一無二的雜湊值。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> ChangeNickname(string nickName)

參數

  • nickName:新的暱稱(最大100個字元)。

傳回

如果操作成功,則傳回真。

備註

如果您希望強制特定的雜湊號碼(比如,為了匹配您自己的系統),請改為使用更改暱稱(string暱稱,int偏好的暱稱雜湊)。

ChangeNickname(string, int)

更改使用者暱稱。
可以提供希望的/偏好的雜湊號碼,但是如果已經進行組合,則在成功時將給予獨一無二的雜湊號碼。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> ChangeNickname(string nickName, int preferredNickHash)

參數

  • nickName:新的暱稱(最大100個字元)。
  • preferredNickHash:希望的/偏好的雜湊號碼。

傳回

如果操作成功,則為真。

ConnectTournamentHub(ITournamentHubCallbackHandler, Tournament)

針對特定錦標賽來連接及初始化錦標賽中心。
被傳送的錦標賽中心(ITournamentHubCallbackHandler)將開始接收回調,直到它被中斷連線。
這主要用於正在進行的錦標賽,以透過錦標賽中心來散佈錦標賽狀態更改。

C#

public void ConnectTournamentHub(Gimmebreak.Backbone.Tournaments.ITournamentHubCallbackHandler tournamentHub, Gimmebreak.Backbone.Tournaments.Tournament tournament)

參數

  • tournamentHub:錦標賽中心,其執行ITournamentHubCallbackHandler。
  • tournament:要初始化錦標賽中心的特定錦標賽。

備註

一次只能連接一個錦標賽到錦標賽中心。
即使傳送了連接到其他錦標賽的不同的錦標賽中心物件,它將在先前已連線的錦標賽中心上停止回調。

CreateGameSession(IEnumerable<TournamentMatch.User>, long, byte)

針對特定錦標賽對戰來建立遊戲階段。
被傳送的使用者必須是錦標賽對戰中指定的使用者的子集。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.GameSessions.GameSession> CreateGameSession(System.Collections.Generic.IEnumerable<Gimmebreak.Backbone.Tournaments.TournamentMatch.User> users, long tournamentMatchId, byte gameSessionType = 0)

參數

  • users:參與錦標賽對戰的使用者。
  • tournamentMatchId:錦標賽對戰ID。
  • gameSessionType:遊戲階段的類型(在儀表板中定義,比如團隊對戰、殊死戰,俘虜旗幟等等。)

傳回

附有獨一無二的ID的遊戲階段,如果操作失敗則傳回空值。報告結果時將需要。

備註

針對特定的錦標賽對戰ID來傳回相同的遊戲階段,直到結果已提交並且遊戲階段已關閉。

CreateGameSession(IEnumerable<GameSession.User>, long, byte)

針對特定錦標賽對戰來建立遊戲階段。
被傳送的使用者必須是錦標賽對戰中指定的使用者的子集。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.GameSessions.GameSession> CreateGameSession(System.Collections.Generic.IEnumerable<Gimmebreak.Backbone.GameSessions.GameSession.User> users, long tournamentMatchId, byte gameSessionType = 0)

參數

  • users:參與錦標賽對戰的使用者。
  • tournamentMatchId:錦標賽對戰ID。
  • gameSessionType:遊戲階段的類型(在儀表板中定義,比如團隊對戰、殊死戰,俘虜旗幟等等。)

傳回

附有獨一無二的ID的遊戲階段,如果操作失敗則傳回空值。報告結果時將需要。

備註

針對特定的錦標賽對戰ID來傳回相同的遊戲階段,直到結果已提交並且遊戲階段已關閉。

CreatePartyCodeForTournament(long, bool)

針對錦標賽來建立陣營代碼,其可以被共享及用於加入陣營。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.PartyCodeResult> CreatePartyCodeForTournament(long tournamentId, bool recreate = False)

參數

  • tournamentId:錦標賽ID。
  • recreate:如果設定為真,新的陣營代碼將替換現有的陣營代碼。

傳回

陣營建立代碼流程的結果。

備註

當透過將「重新建立」參數設定為真,來重新建立陣營代碼時,舊的陣營代碼將被轉譯為無效,並且不能再用於加入陣營。

CreatePartyInviteForTournament(long, long)

透過提供使用者ID,針對錦標賽來建立陣營邀請。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.PartyInviteResult> CreatePartyInviteForTournament(long tournamentId, long inviteUserId)

參數

  • tournamentId:錦標賽ID。
  • inviteUserId:將接收陣營邀請的使用者的ID。

傳回

陣營邀請流程的結果。

CreatePartyInviteForTournament(long, LoginProvider.Platform, string)

透過提供特定平台的類型以及使用者ID,針對錦標賽來建立陣營邀請。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.PartyInviteResult> CreatePartyInviteForTournament(long tournamentId, Gimmebreak.Backbone.User.LoginProvider.Platform inviteUserPlatformType, string inviteUserPlatformId)

參數

  • tournamentId:錦標賽ID。
  • inviteUserPlatformType:特定平台類型。
  • inviteUserPlatformId:特定平台ID。

傳回

陣營邀請流程的結果。

CreatePartyInviteForTournament(long, string, int)

透過提供使用者暱稱及雜湊號碼,針對錦標賽來建立陣營邀請。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.PartyInviteResult> CreatePartyInviteForTournament(long tournamentId, string inviteUserNick, int inviteUserHash)

參數

  • tournamentId:錦標賽ID。
  • inviteUserNick:使用者暱稱。
  • inviteUserHash:使用者雜湊號碼。

傳回

陣營邀請流程的結果。

DeclinePartyInvite(long)

拒絕錦標賽陣營邀請。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> DeclinePartyInvite(long partyInviteId)

參數

  • partyInviteId:陣營邀請ID。

傳回

如果操作成功,則為真。

備註

拒絕一個邀請將不會防止其他使用者來再次發送另一個邀請。

DisconnectTournamentHub()

中斷連線錦標賽中心,並且停止運行回調。

C#

public void DisconnectTournamentHub()

DismissNotification(Notification)

取消使用者通知,並且從啟用中清單中移除它。
通知仍然可用,直到下一次清單重新整理。
檢查IsDismissed屬性以確定通知是否已經被取消。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> DismissNotification(Gimmebreak.Backbone.Notifications.Notification notification)

參數

  • notification:通知以取消。

傳回

如果通知被取消,則為真。

DownloadGameSessionReplay(GameSession)

如果遊戲階段重播可用,則下載遊戲階段重播,並且在遊戲階段重播物件(GameSessions.GameSession.Replay)上填入提交清單。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> DownloadGameSessionReplay(Gimmebreak.Backbone.GameSessions.GameSession gameSession)

參數

  • gameSession:有效的遊戲階段。

傳回

如果操作成功,則為真。

Initialize(IBackboneClientCallbackHandler)

使用來自預設骨幹客戶端設定資產的設定,來初始化骨幹客戶端。

C#

public static Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Core.BackboneClient> Initialize(Gimmebreak.Backbone.Core.IBackboneClientCallbackHandler callbackHandler = null)

參數

  • callbackHandler:傳送將接聽客戶端回調的處理常式。

傳回

已準備好使用的被初始化骨幹客戶端。

Initialize(BackboneClientSetting, IBackboneClientCallbackHandler)

使用來自骨幹客戶端設定資產的設定,來初始化骨幹客戶端。

C#

public static Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Core.BackboneClient> Initialize(Gimmebreak.Backbone.Core.BackboneClientSetting settings, Gimmebreak.Backbone.Core.IBackboneClientCallbackHandler callbackHandler = null)

參數

  • settings:骨幹客戶端設定資產。
  • callbackHandler:傳送將接聽客戶端回調的處理常式。

傳回

已準備好使用的被初始化骨幹客戶端。

Initialize(Uri, string, IBackboneClientCallbackHandler)

針對特定伺服器及遊戲來初始化骨幹客戶端。

C#

public static Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Core.BackboneClient> Initialize(System.Uri server, string gameId, Gimmebreak.Backbone.Core.IBackboneClientCallbackHandler callbackHandler = null)

參數

  • server:伺服器URL或IP。
  • gameId:從骨幹儀表板獲得的遊戲ID。
  • callbackHandler:傳送將接聽客戶端回調的處理常式。

傳回

已準備好使用的被初始化骨幹客戶端。

LoadNotifications()

載入使用者啟用中的通知(比如新聞、陣營邀請等等。)

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> LoadNotifications()

傳回

如果通知被載入,則為真

LoadTournament(Tournament)

載入所有錦標賽資料。(陣營使用者、對戰、詳細資訊等等。)

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> LoadTournament(Gimmebreak.Backbone.Tournaments.Tournament tournament)

參數

  • tournament:要載入資料的錦標賽。

傳回

如果資料被載入,則為真。

LoadTournament(long)

載入所有錦標賽資料。(陣營使用者、對戰、詳細資訊等等。)

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> LoadTournament(long tournamentId)

參數

  • tournamentId:要載入資料的錦標賽。

傳回

如果資料被載入,則為真。

LoadTournamentList()

載入錦標賽清單,其含有過去的、即將來臨的以及目前的錦標賽。
被載入的錦標賽不含有所有中繼資料。
您可以檢查屬性HasAllDataLoaded。
為了載入所有資料,您必須隨後調用LoadTournament()。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> LoadTournamentList()

傳回

如果清單被成功地重新整理,則為真。

LoadTournamentMatches(long, IEnumerable<long>)

針對特定的對戰ID,來載入錦標賽對戰。
傳回的限制是每個調用為25個對戰。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<System.Collections.Generic.List<Gimmebreak.Backbone.Tournaments.TournamentMatch>> LoadTournamentMatches(long tournamentId, System.Collections.Generic.IEnumerable<long> matchIds)

參數

  • tournamentId:錦標賽ID。
  • matchIds:特定錦標賽對戰ID(最多25個)。

傳回

成功的錦標賽對戰的清單,否則為空值。

LoadTournamentMatches(long, int, int, int, int, int, bool, int)

針對特定階段來載入錦標賽對戰。
這個方法允許瀏覽所有在錦標賽中的對戰。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.MatchesPaginatedResult> LoadTournamentMatches(long tournamentId, int phaseId, int fromRoundId, int toRoundId, int maxResults, int page, bool onlyInProgress, int groupId = 0)

參數

  • tournamentId:錦標賽ID。
  • phaseId:要載入對戰的特定錦標賽階段。
  • fromRoundId:要從中載入對戰的階段回合ID,內含。
  • toRoundId:將對戰載入到的階段回合ID,內含。
  • maxResults:每個頁面要傳回的最大結果數量。
  • page:被請求的頁面號碼。
  • onlyInProgress:只載入進行中的對戰。
  • groupId:要載入對戰的特定階段群。

傳回

一頁的錦標賽對戰。

LoadTournamentMatchesAll(long, int, int)

針對特定階段來載入所有錦標賽對戰。
如果階段含有大量的對戰,操作將被分為超過一個調用,並且可能需要一些時間以完成。
如果您希望只載入/重新整理特定對戰,請使用LoadTournamentMatches()方法。(比如,為了只從第一回合載入對戰。)

C#

public Gimmebreak.Backbone.Core.AsyncOperation<System.Collections.Generic.List<Gimmebreak.Backbone.Tournaments.TournamentMatch>> LoadTournamentMatchesAll(long tournamentId, int phaseId, int groupId = 0)

參數

  • tournamentId:錦標賽ID。
  • phaseId:要載入對戰的特定錦標賽階段。
  • groupId:要載入對戰的特定階段群。

傳回

所有階段對戰的清單,否則為空值。

LoadTournamentMatchGameSessions(TournamentMatch)

載入錦標賽對戰的已完成遊戲階段。
將只處理正在進行的或已完成的錦標賽對戰。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> LoadTournamentMatchGameSessions(Gimmebreak.Backbone.Tournaments.TournamentMatch tournamentMatch)

參數

  • tournamentMatch:正在進行的或已完成的錦標賽對戰。

傳回

如果操作成功,則為真。

LoadTournaments(DateTime, DateTime, int, int)

載入特定日期之間的錦標賽。
被載入的錦標賽不含有所有中繼資料。
您可以檢查屬性HasAllDataLoaded。
為了載入所有資料,您必須隨後調用LoadTournament()。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.TournamentsPaginatedResult> LoadTournaments(System.DateTime sinceDate, System.DateTime untilDate, int maxResults = 25, int page = 1)

參數

  • sinceDate:UTC日期時間(小於截止日期)。
  • untilDate:UTC日期時間(大於開始日期)。
  • maxResults:每個頁面傳回的最大結果數量。
  • page:被請求的頁面號碼。

傳回

一頁的錦標賽。

LoadTournamentsAll(DateTime, DateTime)

載入特定日期之間的錦標賽。
已載入的錦標賽不含有所有中繼資料。
您可以檢查屬性HasAllDataLoaded。
為了載入所有資料,您必須隨後調用LoadTournament()。
如果時間框架含有大量的錦標賽,操作將被分為超過一個調用,並且可能需要一些時間以完成。
如果您希望只載入/重新整理特定錦標賽,請使用LoadTournaments()方法。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<System.Collections.Generic.List<Gimmebreak.Backbone.Tournaments.Tournament>> LoadTournamentsAll(System.DateTime sinceDate, System.DateTime untilDate)

參數

  • sinceDate:UTC日期時間(小於截止日期)。
  • untilDate:UTC日期時間(大於開始日期)。

傳回

日期之間的所有錦標賽的清單,否則為空值。

LoadTournamentScores(long, int, int, int, int)

針對特定階段來載入錦標賽得分。
這個方法允許在錦標賽中瀏覽所有陣營得分。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.ScoresPaginatedResult> LoadTournamentScores(long tournamentId, int phaseId, int maxResults, int page, int groupId = 0)

參數

  • tournamentId:錦標賽ID。
  • phaseId:要載入得分的特定錦標賽階段。
  • maxResults:每個頁面傳回的最大結果數量。
  • page:被請求的頁面號碼。
  • groupId:要載入得分的特定階段群。

傳回

一頁的錦標賽得分。

LoadTournamentScoresAll(long, int, int)

針對特定階段來載入所有錦標賽得分。
如果階段含有大量的陣營,操作將被分為超過一個調用,並且可能需要一些時間以完成。
如果您希望只載入/重新整理特定得分,請使用LoadTournamentScores()方法。(比如,為了只從前10名載入得分。)

C#

public Gimmebreak.Backbone.Core.AsyncOperation<System.Collections.Generic.List<Gimmebreak.Backbone.Tournaments.TournamentScore>> LoadTournamentScoresAll(long tournamentId, int phaseId, int groupId = 0)

參數

  • tournamentId:錦標賽ID。
  • phaseId:要載入得分的特定錦標賽階段。
  • groupId:要載入得分的特定階段群。

傳回

所有階段得分的清單,否則為空值。

LoadUserSeasonProfile(long, int)

針對特定賽季來載入使用者個人檔案。
這含有統計資料,比如已遊玩遊戲、錦標賽等等,以及最後被遊玩遊戲階段。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Season.UserSeasonProfile> LoadUserSeasonProfile(long userId, int season)

參數

  • userId:使用者ID
  • season:賽季號碼,以1開始。

傳回

如果操作成功,則為使用者賽季個人檔案。

LoadUserSeasonProfile(LoginProvider.Platform, string, int)

針對特定賽季來載入使用者個人檔案。
這含有統計資料,比如已遊玩遊戲、錦標賽等等,以及最後被遊玩遊戲階段。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Season.UserSeasonProfile> LoadUserSeasonProfile(Gimmebreak.Backbone.User.LoginProvider.Platform userPlatformType, string userPlatformId, int season)

參數

  • userPlatformType:特定平台類型。
  • userPlatformId:特定平台ID。
  • season:賽季號碼,以1開始。

傳回

如果操作成功,則為使用者賽季個人檔案。

Login(LoginProvider)

透過特定登入提供者來登入使用者。如果使用者不存在,它將失敗或基於提供者設定來建立一個新的使用者。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.User.LoginResult> Login(Gimmebreak.Backbone.User.LoginProvider loginProvider)

參數

  • loginProvider:用於驗證的登入提供者。

傳回

存取及重新整理權杖對。

Logout()

登出使用者並且移除所有已快取資料

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> Logout()

傳回

如果使用者被登出,則為真

RemovePartyUser(long, long)

從錦標賽陣營移除使用者。
在陣營中的其他使用者只能由陣營領袖來移除。
您可以傳送您自己的ID以離開陣營。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.TournamentRemoveUserStatus> RemovePartyUser(long tournamentId, long userId)

參數

  • tournamentId:要從中移除使用者的陣營的錦標賽ID。
  • userId:將被移除的使用者的ID。

傳回

移除使用者狀態。

備註

如果陣營領袖離開陣營(透過移除他自己),將從剩餘的陣營使用者來自動設定新的陣營領袖。

ReportUser(long, ReportReason, long, long, long)

報告使用者涉嫌作弊或其他原因。
這個動作可以由使用者發起,或可以由任何防作弊裝置自動發起。
使用正確的報告原因,其指出是誰發起報告(使用者或系統)。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> ReportUser(long userId, Gimmebreak.Backbone.User.ReportReason reportReason, long gameSessionId = 0, long tournamentMatchId = 0, long tournamentId = 0)

參數

  • userId:被報告的使用者的ID。
  • reportReason:報告的原因。
  • gameSessionId:可選的遊戲階段ID(可用於追蹤遊戲階段重播)。
  • tournamentMatchId:可選的錦標賽對戰ID。
  • tournamentId:可選的錦標賽ID。

傳回

如果操作成功,則為真。

備註

在錦標賽儀表板中立即可見報告。
在進行中的錦標賽的情形,管理員可以踢出或禁止太常被報告的使用者。

SaveSession()

快照客戶端狀態,並且儲存資料到硬碟。當客戶端初始化它時,載入最新快照。
這樣的話,遊戲可以在離線模式中存取使用者資料。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> SaveSession()

傳回

如果快照被儲存,則為真。

SignoutFromTournament(long)

如果註冊開啟,則從錦標賽登出。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.InviteResult> SignoutFromTournament(long tournamentId)

參數

  • tournamentId:要登出的錦標賽的ID。

傳回

登出流程的結果。如果錦標賽ID是無效的,可以傳回空值。

SignupForTournament(long)

如果註冊開啟,則針對錦標賽來註冊使用者。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.InviteResult> SignupForTournament(long tournamentId)

參數

  • tournamentId:要註冊的錦標賽ID。

傳回

註冊流程的結果。如果錦標賽ID是無效的,可以傳回空值。

備註

如果針對錦標賽設定了可以在本機驗證的自訂要求,請在處理可能失敗的使用者註冊之前先檢查它們。
使用伺服器要求驗證,作為例行性檢查,而非指揮使用者體驗流。
相同的情況適用於錦標賽的任何入場費。
在處理可能失敗的使用者註冊之前,請先檢查使用者是否已經擁有所有入場費(比如貨幣、物品、點數)。

SignupForTournament(string)

如果註冊開啟,則針對錦標賽來註冊使用者。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<Gimmebreak.Backbone.Tournaments.InviteResult> SignupForTournament(string privateCode)

參數

  • privateCode:要註冊的錦標賽的私人代碼。

傳回

註冊流程的結果。

備註

如果針對錦標賽設定了可以在本機驗證的自訂要求,請在處理可能失敗的使用者註冊之前先檢查它們。
使用伺服器要求驗證,作為例行性檢查,而非指揮使用者體驗流。
相同的情況適用於錦標賽的任何入場費。
在處理可能失敗的使用者註冊之前,請先檢查使用者是否已經擁有所有入場費(比如貨幣、物品、點數)。

SubmitGameSession(GameSession, byte[])

提交遊戲階段結果到伺服器。
所有使用者都必須設定好最終名次,以指派點數。
您可以提供在儀表板中設定的遊戲統計資料(比如射擊的次數、擊殺次數、選擇的能力等等)。
所有對戰參與者都必須提交結果,而且它們必須是相同的。
如果有人報告不同的結果,將標記該場對戰,而且使用者將收到警告報告,以進一步調查潛在作弊行為。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> SubmitGameSession(Gimmebreak.Backbone.GameSessions.GameSession gameSession, byte[] replayData = null)

參數

  • gameSession:附有最終結果及統計資料的遊戲階段。
  • replayData:遊戲階段的可選的重播資料。

傳回

如果提交為成功,則為真。

SubmitGameSessionReplay(long, byte[])

提交使用者遊戲階段重播到伺服器。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> SubmitGameSessionReplay(long gameSessionId, byte[] replayData = null)

參數

  • gameSessionId:有效的遊戲階段ID。
  • replayData:未壓縮的原始重播資料。(資料在發送前將被壓縮)

傳回

如果操作成功,則為真。

備註

所有使用者必須成功地提交遊戲階段重播,否則它將不會指出重播是可用的。

SynchUser(bool)

從伺服器獲得最新的使用者資料。

C#

public Gimmebreak.Backbone.Core.AsyncOperation<bool> SynchUser(bool fullSynch = False)

參數

  • fullSynch:有些部分可以被漸近式更新,如果應該進行完整同步,則設定為真。

傳回

如果操作成功,則為真。

Back to top