gpg:: TurnBasedMultiplayerManager
#include <turn_based_multiplayer_manager.h>
ดึงข้อมูล แก้ไข และสร้างออบเจ็กต์ TurnBasedMatch
รายการ
สรุป
ประเภทสาธารณะ |
|
---|---|
MatchInboxUICallback
|
typedefstd::function< void(const MatchInboxUIResponse &)>
กำหนดโค้ดเรียกกลับที่สามารถรับ MatchInboxUIResponse จาก ShowMatchInboxUI |
MultiplayerStatusCallback
|
typedefstd::function< void(MultiplayerStatus)>
กำหนดโค้ดเรียกกลับที่สามารถใช้เพื่อรับสถานะผู้เล่นหลายคน |
PlayerSelectUICallback
|
typedefstd::function< void(const PlayerSelectUIResponse &)>
กำหนดโค้ดเรียกกลับที่สามารถรับ PlayerSelectUIResponse จาก ShowPlayerSelectUI |
TurnBasedMatchCallback
|
typedefstd::function< void(const TurnBasedMatchResponse &)>
กำหนดโค้ดเรียกกลับที่ใช้เพื่อรับ TurnBasedMatchResponse จากการดำเนินการผู้เล่นหลายคนแบบผลัดกันเล่น |
TurnBasedMatchesCallback
|
typedefstd::function< void(const TurnBasedMatchesResponse &)>
กำหนดโค้ดเรียกกลับที่สามารถรับ TurnBasedMatchesResponse จากการดำเนินการผู้เล่นหลายคนแบบผลัดกันเล่น |
แอตทริบิวต์สาธารณะแบบคงที่ |
|
---|---|
kAutomatchingParticipant
|
const MultiplayerParticipant
ผู้เข้าร่วมซึ่งสามารถส่งต่อไปยังเมธอดที่จะได้รับ "ผู้เข้าร่วมคนถัดไป"
|
ฟังก์ชันสาธารณะ |
|
---|---|
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:: |
|
gpg:: |
|
gpg:: |
|
gpg:: |
|
ประเภทสาธารณะ
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
เท่านั้น
รายละเอียด | |||||
---|---|---|---|---|---|
พารามิเตอร์ |
|
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.
กลับมาเท่านั้น
รายละเอียด | |||||||||
---|---|---|---|---|---|---|---|---|---|
พารามิเตอร์ |
|
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
เพื่อให้ฟังก์ชันนี้ใช้งานได้
รายละเอียด | |||||||
---|---|---|---|---|---|---|---|
พารามิเตอร์ |
|
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
จะได้รับการจับคู่ใหม่
รายละเอียด | |||||
---|---|---|---|---|---|
พารามิเตอร์ |
|
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
เท่านั้น
รายละเอียด | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
พารามิเตอร์ |
|
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 ปี