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)>
กำหนด Callback ที่สามารถใช้เพื่อรับ 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
ปฏิเสธ MultiplayerInvitation เป็น TurnBasedMatch
DismissInvitation(const MultiplayerInvitation & invitation)
void
ปิด MultiplayerInvitation เป็น TurnBasedMatch
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
แสดง UI กล่องจดหมายที่ตรงกันแบบไม่พร้อมกัน เพื่อให้โปรแกรมเล่นเลือกการจับคู่หรือคำเชิญได้
ShowMatchInboxUIBlocking(Timeout timeout)
เวอร์ชันการบล็อกของ ShowMatchInboxUI
ShowMatchInboxUIBlocking()
ShowMatchInboxUIBlocking มากเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
ไม่พร้อมกัน การแสดง UI การเลือกผู้เล่น ทำให้ผู้เล่นสามารถเลือกผู้เล่นอื่นที่จะแข่งขันด้วยได้
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

กำหนด Callback ที่สามารถใช้เพื่อรับ MultiplayerStatus

ใช้โดยฟังก์ชัน ReadyMatch และ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

ผู้เข้าร่วมซึ่งส่งผ่านไปยังวิธีการต่างๆ ซึ่งนำ ผู้เข้าร่วม"

ซึ่งจะทำให้เกิดการเลือกผู้เข้าร่วมคนถัดไปผ่านการจับคู่อัตโนมัติ การส่ง kAutomatchingEvents ไปยังฟังก์ชันหนึ่งๆ จะทำได้ต่อเมื่อ TurnBasedMatch::AutomatchingSlotsAvailable มีค่ามากกว่า 0 สำหรับการจับคู่ที่เกี่ยวข้อง

ฟังก์ชันสาธารณะ

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

ยอมรับ MultiplayerInvitation แบบไม่พร้อมกันและแสดงผลลัพธ์ผ่าน TurnBasedMatchCallback

หากการดำเนินการสำเร็จ TurnBasedMatch ที่แสดงผลผ่าน Callback จะอยู่ในสถานะ TurnBasedMatchState::MY_TURN

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

เวอร์ชันที่บล็อกของ AcceptInvitation

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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 ไว้

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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
Callback ที่ได้รับ TurnBasedMatchResponse

FinishMatchDuringMyTurnBlocking

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

เวอร์ชันการบล็อกของ FinishMatchDuringMyTurn

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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 จะมีสถานะของการแข่งขันหลังจากที่โปรแกรมเล่นในเครื่องออกจากตำแหน่งไปแล้ว หากการออกเดินทางนี้ออกจากการแข่งขันที่มีผู้เข้าร่วมน้อยกว่า 2 คน การแข่งขันจะถูกยกเลิก match.Status() ต้องแสดงผล MatchStatus::MY_TURN เพื่อให้ฟังก์ชันนี้ใช้งานได้

รายละเอียด
พารามิเตอร์
match
การแข่งขันที่จะออก
next_participant
ผู้เข้าร่วมในรอบต่อไป ระบบอาจใช้ TurnBasedMultiplayerManager::kAutomatchingParticipant เพื่อระบุว่าควรเลือกผู้เข้าร่วมคนถัดไปผ่านการจับคู่อัตโนมัติ
callback
Callback ที่ได้รับ TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

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

เวอร์ชันการบล็อกของ LeaveMatchDuringMyTurn

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล ERROR_TIMEOUT

LeaveMatchDuringMyTurnBlocking

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

LeaveMatchDuringMyTurnBlocking ทำงานหนักเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

ไม่พร้อมกันจะเป็นการทิ้งการแข่งขันในตาของผู้เข้าร่วมรายอื่น

คำตอบที่แสดงผลผ่าน MultiplayerStatusCallback จะระบุว่าผู้เข้าร่วมในระบบออกจากการแข่งขันได้สำเร็จหรือไม่ หากการออกเดินทางนี้ออกจากการแข่งขันที่มีผู้เข้าร่วมน้อยกว่า 2 คน การแข่งขันจะถูกยกเลิก match.Status() ต้องแสดงผล MatchStatus::THEIR_TURN เพื่อให้ฟังก์ชันนี้ใช้งานได้

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

เวอร์ชันการบล็อกของ LeaveMatchDuringTheirTurn

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล ERROR_TIMEOUT

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

LeaveMatchDuringTheirTurnBlocking ทำงานหนักเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี

เล่นอีกครั้ง

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

จับคู่การจับคู่ใหม่ที่มีสถานะ MatchStatus::COMPLETED

หากการแข่งขันนัดที่สองเป็นไปได้ TurnBasedMatchCallback จะได้รับการแข่งขันใหม่

รายละเอียด
พารามิเตอร์
match
การแข่งขันนัดที่สอง
callback
Callback ที่ได้รับ TurnBasedMatchResponse

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

กำลังบล็อกเวอร์ชันเล่นซ้ำ

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล ERROR_TIMEOUT

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

RematchBlocking ทำงานหนักเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

แสดง UI กล่องจดหมายที่ตรงกันแบบไม่พร้อมกัน เพื่อให้โปรแกรมเล่นเลือกการจับคู่หรือคำเชิญได้

เมื่อเสร็จสิ้น ระบบจะส่งคืนการจับคู่หรือคำเชิญที่เลือกผ่านทาง MatchInboxUICallback

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

เวอร์ชันที่บล็อกของ ShowMatchInboxUI

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล ERROR_TIMEOUT

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

ShowMatchInboxUIBlocking มากเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี

ShowPlayerSelectUI

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

ไม่พร้อมกัน การแสดง UI การเลือกผู้เล่น ทำให้ผู้เล่นสามารถเลือกผู้เล่นอื่นที่จะแข่งขันด้วยได้

เมื่อเสร็จสิ้น ผู้เล่นที่เลือกไว้จะถูกส่งคืนผ่านทาง PlayerSelectUICallback

ShowPlayerSelectUIBlocking

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

กำลังบล็อกเวอร์ชัน ShowPlayerSelectUI

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล 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
Callback ที่ได้รับ TurnBasedMatchResponse

TakeMyTurnBlocking

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

กำลังบล็อกเวอร์ชัน TakeMyTurn

อนุญาตให้ผู้โทรระบุระยะหมดเวลาเป็นมิลลิวินาที หลังจากพ้นเวลาที่ระบุ ฟังก์ชันจะแสดงผล ERROR_TIMEOUT

TakeMyTurnBlocking

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

TakeMyTurnBlocking มากเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี