gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

אחזור, שינוי ויצירה של TurnBasedMatch אובייקטים.

סיכום

סוגים ציבוריים
MatchInboxUICallback typedef
std::function< void(const MatchInboxUIResponse &)>
מגדירה קריאה חוזרת (callback) שיכולה לקבל MatchInboxUIResponse מ-ShowMatchInboxUI.
MultiplayerStatusCallback typedef
std::function< void(MultiplayerStatus)>
מגדיר התקשרות חזרה שאפשר להשתמש בה כדי לקבל סטטוס רב-משתתפים.
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
מגדירה קריאה חוזרת (callback) שיכולה לקבל PlayerSelectUIResponse מ-ShowPlayerSelectUI.
TurnBasedMatchCallback typedef
std::function< void(const TurnBasedMatchResponse &)>
מגדירה קריאה חוזרת (callback) שניתן להשתמש בה כדי לקבל TurnBasedMatchResponse מאחת מהפעולות של ריבוי משתתפים המבוססות על תורות.
TurnBasedMatchesCallback typedef
std::function< void(const TurnBasedMatchesResponse &)>
מגדירה קריאה חוזרת (callback) שיכולה לקבל TurnBasedMatchesResponse מאחת הפעולות של ריבוי משתתפים המבוססות על תורות.

מאפיינים סטטיים ציבוריים
kAutomatchingParticipant
משתתף שאפשר להעביר אותו לשיטות של השתתפות ב "משתתף הבא".

תפקידים ציבוריים
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
הפונקציה מקבלת MultiplayerInvitation באופן אסינכרוני ומחזירה את התוצאה דרך TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
גרסת חסימה של AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
עומס יתר של AcceptInvitationBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
ביטול התאמה באופן אסינכרוני.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
גרסת חסימה של CancelMatch.
CancelMatchBlocking(const TurnBasedMatch & match)
עומס יתר של CancelMatch עם הזמן הקצוב לתפוגה שמוגדר כברירת מחדל ל-10 שנים.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
אישור התוצאות של משחק שהסתיים וממתין להשלמה מקומית.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
גרסת חסימה של ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
עומס יתר של ConfirmPendingCompletionBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
הפונקציה יוצרת TurnBasedMatch באופן אסינכרוני באמצעות ה-TurnBasedMatchConfig שסופק.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
גרסת החסימה של CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
עומס יתר של CreateTurnBasedMatchBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
DismissInvitation(const MultiplayerInvitation & invitation)
void
DismissMatch(const TurnBasedMatch & match)
void
סגירת TurnBasedMatch.
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
מאחזר באופן אסינכרוני התאמה ספציפית לפי מזהה.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
גרסת החסימה של FetchMatch.
FetchMatchBlocking(const std::string & match_id)
עומס יתר של FetchMatchBlocking, שמוגדר כברירת מחדל כשהזמן הקצוב לתפוגה של עשר שנים הוא 10 שנים.
FetchMatches(TurnBasedMatchesCallback callback)
void
מאחזר באופן אסינכרוני את האובייקטים TurnBasedMatch ו-Invitation של הנגן הנוכחי.
FetchMatchesBlocking(Timeout timeout)
גרסת חסימה של FetchMatches.
FetchMatchesBlocking()
עומס יתר של FetchMatchesBlocking, שמוגדר כברירת מחדל כשהזמן הקצוב לתפוגה הוא 10 שנים.
FinishMatchDuringMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, TurnBasedMatchCallback callback)
void
מסיים באופן אסינכרוני את ההתאמה שצוינה.
FinishMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
גרסת חסימה של FinishMatchDuringMyTurn.
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
עומס יתר של FinishMatchDuringMyTurnBlocking, שלפיו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
משאיר התאמה באופן אסינכרוני בתורו של המשתתף המקומי.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
גרסת חסימה של LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
עומס יתר של LeaveMatchDuringMyTurnBlocking, הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
משאירים התאמה באופן אסינכרוני בתורו של משתתף אחר.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
גרסת חסימה של LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
עומס יתר של LeaveMatchDuringTheirTurnBlocking, כאשר הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
תואם מחדש התאמה שהמצב שלה הוא MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
גרסת חסימה של התאמה מחדש.
RematchBlocking(const TurnBasedMatch & match)
עומס יתר של RematchBlocking, שמוגדר כברירת מחדל כשהזמן הקצוב לתפוגה הוא 10 שנים.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
מציג באופן אסינכרוני את ממשק המשתמש של תיבת הדואר הנכנס כדי להתאים, וכך מאפשר לשחקן לבחור התאמה או הזמנה.
ShowMatchInboxUIBlocking(Timeout timeout)
גרסת חסימה של ShowMatchInboxUI.
ShowMatchInboxUIBlocking()
עומס יתר של ShowMatchInboxUIBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
מציג באופן אסינכרוני את ממשק המשתמש של בחירת השחקן, וכך השחקן יכול לבחור שחקנים אחרים שישחקו איתם.
ShowPlayerSelectUIBlocking(Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
גרסת חסימה של ShowPlayerSelectUI.
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
עומס יתר של ShowPlayerSelectUIBlocking, הזמן הקצוב לתפוגה שמוגדר כברירת מחדל ל-10 שנים.
SynchronizeData()
void
אילוץ סנכרון של נתוני התאמת TBMP עם השרת.
TakeMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
לוקח את התור של המשתתף המקומי באופן אסינכרוני.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
גרסת חסימה של TakeMyTurn.
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
עומס יתר של TakeMyTurnBlocking, כאשר הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

מבנים
gpg::TurnBasedMultiplayerManager::MatchInboxUIResponse

Data וגם ResponseStatus עבור הפעולה ShowMatchInboxUI.

gpg::TurnBasedMultiplayerManager::PlayerSelectUIResponse

Data וגם ResponseStatus עבור הפעולה ShowPlayerSelectUI.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchResponse

Data וגם ResponseStatus עבור TurnBasedMatch ספציפי.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchesResponse

Data ו-ResponseStatus עבור TurnBasedMatches והזמנות.

סוגים ציבוריים

MatchInboxUICallback

std::function< void(const MatchInboxUIResponse &)> MatchInboxUICallback

מגדירה קריאה חוזרת (callback) שיכולה לקבל MatchInboxUIResponse מ-ShowMatchInboxUI.

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

מגדיר התקשרות חזרה שאפשר להשתמש בה כדי לקבל סטטוס רב-משתתפים.

משמש את הפונקציות ExitMatch ו-CancelMatch.

PlayerSelectUICallback

std::function< void(const PlayerSelectUIResponse &)> PlayerSelectUICallback

מגדירה קריאה חוזרת (callback) שיכולה לקבל PlayerSelectUIResponse מ-ShowPlayerSelectUI.

TurnBasedMatchCallback

std::function< void(const TurnBasedMatchResponse &)> TurnBasedMatchCallback

מגדירה קריאה חוזרת (callback) שניתן להשתמש בה כדי לקבל TurnBasedMatchResponse מאחת מהפעולות של ריבוי משתתפים המבוססות על תורות.

TurnBasedMatchesCallback

std::function< void(const TurnBasedMatchesResponse &)> TurnBasedMatchesCallback

מגדירה קריאה חוזרת (callback) שיכולה לקבל TurnBasedMatchesResponse מאחת הפעולות של ריבוי משתתפים המבוססות על תורות.

מאפיינים סטטיים ציבוריים

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

משתתף שאפשר להעביר אותו לשיטות של השתתפות ב "משתתף הבא".

פעולה זו גורמת לשיטה לבחור את המשתתף הבא באמצעות התאמה אוטומטית. אפשר להעביר את kAutomatchingParticipant לפונקציה רק אם הערך של TurnBasedMatch::AutomatchingSlotsAvailable גדול מ-0 להתאמה הקשורה.

תפקידים ציבוריים

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

הפונקציה מקבלת MultiplayerInvitation באופן אסינכרוני ומחזירה את התוצאה דרך TurnBasedMatchCallback.

אם הפעולה תתבצע בהצלחה, TurnBasedMatch שהוחזר באמצעות הקריאה החוזרת נמצא במצב TurnBasedMatchState::MY_TURN.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

גרסת חסימה של AcceptInvitation.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

עומס יתר של AcceptInvitationBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

ביטול התאמה באופן אסינכרוני.

הסטטוס שהוחזר דרך MultiplayerStatusCallback מציין אם הפעולה הצליחה. כדי שניתן יהיה להשתמש בפונקציה הזו, יש לוודא שהסטטוס של ההתאמה הוא InviteD, THEIR_TURN או MY_TURN.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

גרסת חסימה של CancelMatch.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

עומס יתר של CancelMatch עם הזמן הקצוב לתפוגה שמוגדר כברירת מחדל ל-10 שנים.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

אישור התוצאות של משחק שהסתיים וממתין להשלמה מקומית.

אפשר לקרוא לפונקציה הזו רק כאשר הפונקציה TurnBasedMatch::Status() מחזירה את הערך MatchStatus::PENDING_COMPLETION.

פרטים
פרמטרים
match
ההתאמה שיש לאשר את השלמתה.
callback
השיחה החוזרת מקבלת TurnBasedMatchResponse.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

גרסת חסימה של ConfirmPendingCompletion.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

עומס יתר של ConfirmPendingCompletionBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

CreateTurnBasedMatch

void CreateTurnBasedMatch(
  const gpg::TurnBasedMatchConfig & config,
  TurnBasedMatchCallback callback
)

הפונקציה יוצרת TurnBasedMatch באופן אסינכרוני באמצעות ה-TurnBasedMatchConfig שסופק.

אם היצירה תתבצע בהצלחה, הפונקציה הזו תחזיר את הערך TurnBasedMatch באמצעות ה-TurnBasedMatchCallback שסופק. TurnBasedMatch שנוצר לאחרונה מתחיל תמיד במצב TurnBasedMatchState::MY_TURN.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  Timeout timeout,
  const gpg::TurnBasedMatchConfig & config
)

גרסת החסימה של CreateTurnBasedMatch.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

עומס יתר של CreateTurnBasedMatchBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

דחייה של MultiplayerInvitation לTurnBasedMatch.

פעולה זו תבטל את המשחק עבור שאר המשתתפים ותסיר את ההתאמה מהמכשיר של השחקן המקומי.

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

דוחה MultiplayerInvitation ל-TurnBasedMatch.

הפעולה הזו לא משנה את המצב הגלוי של TurnBasedMatch עבור המשתתפים האחרים, אלא רק מסירה את TurnBasedMatch מהמכשיר של השחקן המקומי.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

סגירת TurnBasedMatch.

הפעולה הזו לא משנה את המצב הגלוי של TurnBasedMatch עבור המשתתפים האחרים, אלא רק מסירה את TurnBasedMatch מהמכשיר של השחקן המקומי.

FetchMatch

void FetchMatch(
  const std::string & match_id,
  TurnBasedMatchCallback callback
)

מאחזר באופן אסינכרוני התאמה ספציפית לפי מזהה.

התוצאה של פעולה זו מוחזרת דרך TurnBasedMatchCallback.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  Timeout timeout,
  const std::string & match_id
)

גרסת החסימה של FetchMatch.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

עומס יתר של FetchMatchBlocking, שמוגדר כברירת מחדל כשהזמן הקצוב לתפוגה של עשר שנים הוא 10 שנים.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

מאחזר באופן אסינכרוני את האובייקטים TurnBasedMatch ו-Invitation של הנגן הנוכחי.

מוחזרים כל ההתאמות הפעילות ועד 10 התאמות שהושלמו.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

גרסת חסימה של FetchMatches.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

עומס יתר של FetchMatchesBlocking, שמוגדר כברירת מחדל כשהזמן הקצוב לתפוגה הוא 10 שנים.

FinishMatchDuringMyTurn

void FinishMatchDuringMyTurn(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  TurnBasedMatchCallback callback
)

מסיים באופן אסינכרוני את ההתאמה שצוינה.

אפשר להשתמש בפעולה הזו במקום ב-TakeMyTurn בסבב האחרון של המשחק. מאפשר למתקשר לציין ערך סופי עבור match_data וכן קבוצה של ערכים סופיים עבור ParticipantResults. בסיום הפעולה הזו, ההתאמה המעודכנת תוחזר באמצעות הפונקציה TurnBasedMatchCallback. שצוינה אפשר לקרוא לפונקציה הזו רק כאשר הפונקציה TurnBasedMatch::Status() מחזירה את הערך MatchStatus::MY_TURN.

פרטים
פרמטרים
match
המשחק שצריך לסיים.
match_data
אוסף נתונים שמייצג את המצב הסופי של המשחק.
results
כל התוצאות של כל שחקן במשחק. לתשומת ליבך, אסור שתוצאות אלה יסתרו את התוצאות שצוינו קודם לכן דרך TakeTurn. אם תנסו להגדיר תוצאות שונות לשחקן, התוצאה תהיה ERROR_INVALID_RESULTS.
callback
הקריאה החוזרת שמקבלת את TurnBasedMatchResponse.

FinishMatchDuringMyTurnBlocking

TurnBasedMatchResponse FinishMatchDuringMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results
)

גרסת חסימה של FinishMatchDuringMyTurn.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

FinishMatchDuringMyTurnBlocking

TurnBasedMatchResponse FinishMatchDuringMyTurnBlocking(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results
)

עומס יתר של FinishMatchDuringMyTurnBlocking, שלפיו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

LeaveMatchDuringMyTurn

void LeaveMatchDuringMyTurn(
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant,
  MultiplayerStatusCallback callback
)

משאיר התאמה באופן אסינכרוני בתורו של המשתתף המקומי.

התשובה שהוחזרה דרך TurnBasedMatchCallback מכילה את מצב המשחק אחרי שהשחקן המקומי עוזב. אם העזיבה הזו יוצאת מהמשחק עם פחות משני משתתפים, המשחק מתבטל. כדי שיהיה אפשר להשתמש בפונקציה הזו, הפונקציה match.Status() חייבת להחזיר MatchStatus::MY_TURN.

פרטים
פרמטרים
match
ההתאמה שיש לעזוב.
next_participant
המשתתף שהתור שלו הוא הבא. ניתן להשתמש ב-TurnBasedMultiplayerManager::kAutomatchingParticipant כדי לציין שיש לבחור את המשתתף הבא באמצעות התאמה אוטומטית.
callback
הקריאה החוזרת שמקבלת את TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

MultiplayerStatus LeaveMatchDuringMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant
)

גרסת חסימה של LeaveMatchDuringMyTurn.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

LeaveMatchDuringMyTurnBlocking

MultiplayerStatus LeaveMatchDuringMyTurnBlocking(
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant
)

עומס יתר של LeaveMatchDuringMyTurnBlocking, הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

משאירים התאמה באופן אסינכרוני בתורו של משתתף אחר.

התשובה שהוחזרה דרך MultiplayerStatusCallback מציינת אם המשתתף המקומי עזב את המשחק בהצלחה. אם העזיבה הזו יוצאת מהמשחק עם פחות משני משתתפים, המשחק מתבטל. כדי שיהיה אפשר להשתמש בפונקציה הזו, הפונקציה match.Status() חייבת להחזיר MatchStatus::THEIR_TURN.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

גרסת חסימה של LeaveMatchDuringTheirTurn.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

עומס יתר של LeaveMatchDuringTheirTurnBlocking, כאשר הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

משחק חוזר

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

תואם מחדש התאמה שהמצב שלה הוא MatchStatus::COMPLETED.

אם ההתאמה החוזרת אפשרית, TurnBasedMatchCallback יקבל את ההתאמה החדשה.

פרטים
פרמטרים
match
המשחק שהיה משחק חוזר.
callback
הקריאה החוזרת שמקבלת TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

גרסת חסימה של התאמה מחדש.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

עומס יתר של RematchBlocking, שמוגדר כברירת מחדל כשהזמן הקצוב לתפוגה הוא 10 שנים.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

מציג באופן אסינכרוני את ממשק המשתמש של תיבת הדואר הנכנס כדי להתאים, וכך מאפשר לשחקן לבחור התאמה או הזמנה.

בסיום, המשחק או ההזמנה שנבחרו יוחזרו באמצעות MatchInboxUICallback.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

גרסת חסימה של ShowMatchInboxUI.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

עומס יתר של ShowMatchInboxUIBlocking, שבו הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.

ShowPlayerSelectUI

void ShowPlayerSelectUI(
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch,
  PlayerSelectUICallback callback
)

מציג באופן אסינכרוני את ממשק המשתמש של בחירת השחקן, וכך השחקן יכול לבחור שחקנים אחרים שישחקו איתם.

בסיום, השחקנים שנבחרו יוחזרו באמצעות PlayerSelectUICallback.

ShowPlayerSelectUIBlocking

PlayerSelectUIResponse ShowPlayerSelectUIBlocking(
  Timeout timeout,
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch
)

גרסת חסימה של ShowPlayerSelectUI.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

ShowPlayerSelectUIBlocking

PlayerSelectUIResponse ShowPlayerSelectUIBlocking(
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch
)

עומס יתר של ShowPlayerSelectUIBlocking, הזמן הקצוב לתפוגה שמוגדר כברירת מחדל ל-10 שנים.

SynchronizeData

void SynchronizeData()

אילוץ סנכרון של נתוני התאמת TBMP עם השרת.

קבלה של נתונים חדשים מפעילה OnTurnBasedMatchEventCallback או OnMultiplayerInvitationReceivedCallback.

TakeMyTurn

void TakeMyTurn(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant,
  TurnBasedMatchCallback callback
)

לוקח את התור של המשתתף המקומי באופן אסינכרוני.

במהלך סיבוב, המשתתף יכול לציין ערך חדש עבור match_data וגם קבוצה של ParticipantResults. בסיום הפנייה, ההתאמה המעודכנת תוחזר דרך TurnBasedMatchCallback. אפשר לקרוא לפונקציה הזו רק כאשר הערך של TurnBasedMatch::Status() הוא MatchStatus::MY_TURN.

פרטים
פרמטרים
match
המשחק שבו מתרחשת התור.
match_data
חבילת נתונים לשליחה למשתתף הבא.
results
כל התוצאות הידועות של המשחק נכון לעכשיו. חשוב לזכור שאפשר לציין את התוצאה עבור שחקן נתון רק פעם אחת. אם תנסו להגדיר תוצאות שונות לשחקן, התוצאה תהיה ERROR_INVALID_RESULTS.
next_participant
המשתתף שהתור שלו הוא הבא. ניתן להשתמש ב-TurnBasedMultiplayerManager::kAutomatchingParticipant כדי לציין שיש לבחור את המשתתף הבא באמצעות התאמה אוטומטית.
callback
הקריאה החוזרת שמקבלת את TurnBasedMatchResponse.

TakeMyTurnBlocking

TurnBasedMatchResponse TakeMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant
)

גרסת חסימה של TakeMyTurn.

מאפשרת למתקשר לציין זמן קצוב לתפוגה ב-ms. לאחר שיחלוף הזמן שצוין, הפונקציה מחזירה את ERROR_TIMEOUT.

TakeMyTurnBlocking

TurnBasedMatchResponse TakeMyTurnBlocking(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant
)

עומס יתר של TakeMyTurnBlocking, כאשר הזמן הקצוב לתפוגה שמוגדר כברירת מחדל הוא 10 שנים.