gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

ดึงข้อมูล แก้ไข และสร้างออบเจ็กต์ TurnBasedMatch รายการ

สรุป

ประเภทสาธารณะ
MatchInboxUICallback	typedef std::function< void(const MatchInboxUIResponse &)> กำหนดโค้ดเรียกกลับที่สามารถรับ MatchInboxUIResponse จาก ShowMatchInboxUI
MultiplayerStatusCallback	typedef std::function< void(MultiplayerStatus)> กำหนดโค้ดเรียกกลับที่สามารถใช้เพื่อรับสถานะผู้เล่นหลายคน
PlayerSelectUICallback	typedef std::function< void(const PlayerSelectUIResponse &)> กำหนดโค้ดเรียกกลับที่สามารถรับ PlayerSelectUIResponse จาก ShowPlayerSelectUI
TurnBasedMatchCallback	typedef std::function< void(const TurnBasedMatchResponse &)> กำหนดโค้ดเรียกกลับที่ใช้เพื่อรับ TurnBasedMatchResponse จากการดำเนินการผู้เล่นหลายคนแบบผลัดกันเล่น
TurnBasedMatchesCallback	typedef std::function< void(const TurnBasedMatchesResponse &)> กำหนดโค้ดเรียกกลับที่สามารถรับ TurnBasedMatchesResponse จากการดำเนินการผู้เล่นหลายคนแบบผลัดกันเล่น

แอตทริบิวต์สาธารณะแบบคงที่
kAutomatchingParticipant	const MultiplayerParticipant ผู้เข้าร่วมซึ่งสามารถส่งต่อไปยังเมธอดที่จะได้รับ "ผู้เข้าร่วมคนถัดไป"

ฟังก์ชันสาธารณะ
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)	void ยอมรับ MultiplayerInvitation แบบไม่พร้อมกันและแสดงผลลัพธ์ผ่าน TurnBasedMatchCallback
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)	TurnBasedMatchResponse เวอร์ชันการบล็อกของ AcceptInvitation
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)	TurnBasedMatchResponse มีการโอเวอร์โหลด AcceptInvitationBlocking มากเกินไป ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)	void ยกเลิกการจับคู่แบบไม่พร้อมกัน
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)	MultiplayerStatus เวอร์ชันการบล็อกของ CancelMatch
CancelMatchBlocking(const TurnBasedMatch & match)	MultiplayerStatus มีการโอเวอร์โหลด CancelMatch ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)	void ยืนยันผลของการแข่งขันที่สิ้นสุดลงแล้วและกำลังรอการดำเนินการในพื้นที่เสร็จสิ้น
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)	TurnBasedMatchResponse เวอร์ชันการบล็อกของ ConfirmPendingCompletion
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)	TurnBasedMatchResponse มีการโอเวอร์โหลด ConfirmPendingCompletionBlocking ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)	void สร้าง TurnBasedMatch แบบไม่พร้อมกันโดยใช้ TurnBasedMatchConfig ที่ให้ไว้
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)	TurnBasedMatchResponse เวอร์ชันการบล็อกของ CreateTurnBasedMatch
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)	TurnBasedMatchResponse มีการโอเวอร์โหลด 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)	TurnBasedMatchResponse FetchMatch เวอร์ชันที่ถูกบล็อก
FetchMatchBlocking(const std::string & match_id)	TurnBasedMatchResponse มีการโอเวอร์โหลด FetchMatchBlocking ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
FetchMatches(TurnBasedMatchesCallback callback)	void ดึงออบเจ็กต์ TurnBasedMatch และ Invitation แบบไม่พร้อมกันสำหรับโปรแกรมเล่นปัจจุบัน
FetchMatchesBlocking(Timeout timeout)	TurnBasedMatchesResponse เวอร์ชันการบล็อกของ FetchMatches
FetchMatchesBlocking()	TurnBasedMatchesResponse มีการโอเวอร์โหลด 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)	TurnBasedMatchResponse เวอร์ชันการบล็อกของ FinishMatchDuringMyTurn
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)	TurnBasedMatchResponse โอเวอร์โหลด FinishMatchDuringMyTurnBlocking ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)	void ออกจากการแข่งขันแบบไม่พร้อมกันระหว่างตาของผู้เข้าร่วมภายใน
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)	MultiplayerStatus เวอร์ชันการบล็อกของ LeaveMatchDuringMyTurn
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)	MultiplayerStatus มีการโอเวอร์โหลด LeaveMatchDuringMyTurnBlocking ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)	void ออกจากการแข่งขันแบบไม่พร้อมกันระหว่างตาของผู้เข้าร่วมรายอื่น
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)	MultiplayerStatus เวอร์ชันการบล็อกของ LeaveMatchDuringTheirTurn
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)	MultiplayerStatus มีการโอเวอร์โหลด LeaveMatchDuringTheirTurnBlocking มากกว่า ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)	void จับคู่การแข่งขันที่มีสถานะเป็น MatchStatus::COMPLETED อีกครั้ง
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)	TurnBasedMatchResponse เวอร์ชันการบล็อกของการจับคู่ซ้ำ
RematchBlocking(const TurnBasedMatch & match)	TurnBasedMatchResponse มีการโอเวอร์โหลด RematchBlocking ซึ่งใช้ระยะหมดเวลาเริ่มต้น 10 ปี
ShowMatchInboxUI(MatchInboxUICallback callback)	void แสดง UI กล่องจดหมายการแข่งขันแบบอะซิงโครนัส ซึ่งช่วยให้ผู้เล่นเลือกการแข่งขันหรือคำเชิญได้
ShowMatchInboxUIBlocking(Timeout timeout)	MatchInboxUIResponse เวอร์ชันการบล็อกของ ShowMatchInboxUI
ShowMatchInboxUIBlocking()	MatchInboxUIResponse มีการโอเวอร์โหลด 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)	PlayerSelectUIResponse เวอร์ชันการบล็อกของ ShowPlayerSelectUI
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)	PlayerSelectUIResponse มีการโอเวอร์โหลด 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)	TurnBasedMatchResponse เวอร์ชันที่ถูกบล็อกของ TakeMyTurn
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)	TurnBasedMatchResponse มีการโอเวอร์โหลด 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

กำหนดโค้ดเรียกกลับที่สามารถรับ MatchInboxUIResponse จาก ShowMatchInboxUI

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

กำหนดโค้ดเรียกกลับที่สามารถใช้เพื่อรับสถานะผู้เล่นหลายคน

ใช้โดยฟังก์ชัน ReleaseMatch และCancelMatch

PlayerSelectUICallback

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

กำหนดโค้ดเรียกกลับที่สามารถรับ PlayerSelectUIResponse จาก ShowPlayerSelectUI

TurnBasedMatchCallback

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

กำหนดโค้ดเรียกกลับที่ใช้เพื่อรับ TurnBasedMatchResponse จากการดำเนินการผู้เล่นหลายคนแบบผลัดกันเล่น

TurnBasedMatchesCallback

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

กำหนดโค้ดเรียกกลับที่สามารถรับ 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

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