gpg:: RealTimeMultiplayerManager
#include <real_time_multiplayer_manager.h>
Tìm nạp, sửa đổi, xử lý thông báo và tạo đối tượng RealTimeRoom
.
Tóm tắt
Loại công khai |
|
---|---|
FetchInvitationsCallback
|
typedefstd::function< void(const FetchInvitationsResponse &)>
Xác định lệnh gọi lại có thể dùng để nhận WaitingRoomUIResponse từ một trong các hoạt động nhiều người chơi theo thời gian thực. |
LeaveRoomCallback
|
typedefstd::function< void(const ResponseStatus &)>
Xác định lệnh gọi lại có thể nhận ResponseStatus từ LeaveRoom . |
PlayerSelectUICallback
|
typedefstd::function< void(const PlayerSelectUIResponse &)>
Xác định lệnh gọi lại có thể nhận PlayerSelectUIResponse từ ShowPlayerSelectUI . |
PlayerSelectUIResponse
|
typedefData và ResponseStatus cho thao tác ShowPlayerSelectUI . |
RealTimeRoomCallback
|
typedefstd::function< void(const RealTimeRoomResponse &)>
Xác định lệnh gọi lại có thể dùng để nhận cấu trúc RealTimeRoomResponse qua một trong các hoạt động nhiều người chơi theo lượt. |
RoomInboxUICallback
|
typedefstd::function< void(const RoomInboxUIResponse &)>
Xác định lệnh gọi lại có thể nhận RoomInboxUIResponse từ ShowRoomInboxUI . |
SendReliableMessageCallback
|
typedefstd::function< void(const MultiplayerStatus &)>
Xác định lệnh gọi lại có thể nhận ResponseStatus từ SendReliableMessage . |
WaitingRoomUICallback
|
typedefstd::function< void(const WaitingRoomUIResponse &)>
Xác định lệnh gọi lại có thể dùng để nhận WaitingRoomUIResponse từ một trong các hoạt động nhiều người chơi theo thời gian thực. |
Hàm công khai |
|
---|---|
AcceptInvitation(const MultiplayerInvitation & invitation, IRealTimeEventListener *listener, RealTimeRoomCallback callback)
|
void
Chấp nhận
MultiplayerInvitation một cách không đồng bộ và trả về kết quả qua RealTimeRoomCallback . |
AcceptInvitation(const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback)
|
void
Chấp nhận
MultiplayerInvitation một cách không đồng bộ và trả về kết quả qua RealTimeRoomCallback . |
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation, IRealTimeEventListener *listener)
|
Chặn phiên bản của AcceptInvitation.
|
AcceptInvitationBlocking(const MultiplayerInvitation & invitation, IRealTimeEventListener *listener)
|
Tình trạng quá tải của AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper)
|
Chặn phiên bản của AcceptInvitation.
|
AcceptInvitationBlocking(const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper)
|
Tình trạng quá tải của AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
CreateRealTimeRoom(const gpg::RealTimeRoomConfig & config, IRealTimeEventListener *listener, RealTimeRoomCallback callback)
|
void
Tạo đối tượng
RealTimeRoom một cách không đồng bộ bằng cách sử dụng lớp RealTimeRoomConfig đã cung cấp. |
CreateRealTimeRoom(const gpg::RealTimeRoomConfig & config, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback)
|
void
Tạo đối tượng
RealTimeRoom một cách không đồng bộ bằng cách sử dụng lớp RealTimeRoomConfig đã cung cấp. |
CreateRealTimeRoomBlocking(Timeout timeout, const RealTimeRoomConfig & config, IRealTimeEventListener *listener)
|
Chặn phiên bản của CreateRealTimeRoom.
|
CreateRealTimeRoomBlocking(const RealTimeRoomConfig & config, IRealTimeEventListener *listener)
|
Quá tải CreateRealTimeRoomBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
CreateRealTimeRoomBlocking(Timeout timeout, const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper)
|
Chặn phiên bản của CreateRealTimeRoom.
|
CreateRealTimeRoomBlocking(const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper)
|
Quá tải CreateRealTimeRoomBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
DeclineInvitation(const MultiplayerInvitation & invitation)
|
void
Từ chối một
MultiplayerInvitation với một RealTimeRoom . |
DismissInvitation(const MultiplayerInvitation & invitation)
|
void
Đóng
MultiplayerInvitation khỏi RealTimeRoom . |
FetchInvitations(FetchInvitationsCallback callback)
|
void
Tìm nạp mọi
MultiplayerInvitation cho các phòng theo thời gian thực. |
FetchInvitationsBlocking(Timeout timeout)
|
Chặn phiên bản của FetchInvitations.
|
FetchInvitationsBlocking()
|
Tình trạng quá tải của FetchInvitationsBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
LeaveRoom(const RealTimeRoom & room, LeaveRoomCallback callback)
|
void
Rời khỏi một
RealTimeRoom . |
LeaveRoomBlocking(Timeout timeout, const RealTimeRoom & room)
|
Đang chặn phiên bản LeaveRoom.
|
LeaveRoomBlocking(const RealTimeRoom & room)
|
Tình trạng quá tải của LeaveRoomBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
SendReliableMessage(const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data, SendReliableMessageCallback callback)
|
void
Gửi tin nhắn đến
MultiplayerParticipant được chỉ định. |
SendReliableMessageBlocking(Timeout timeout, const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data)
|
Chặn phiên bản của SendReliableMessage.
|
SendReliableMessageBlocking(const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data)
|
Nạp chồng SendReliableMessageBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
SendUnreliableMessage(const RealTimeRoom & room, const std::vector< MultiplayerParticipant > & participants, std::vector< uint8_t > data)
|
void
Gửi tin nhắn đến các
MultiplayerParticipant được chỉ định. |
SendUnreliableMessageToOthers(const RealTimeRoom & room, std::vector< uint8_t > data)
|
void
Gửi tin nhắn cho tất cả người tham gia không phải người dùng hiện tại.
|
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
|
void
Hiển thị không đồng bộ giao diện người dùng chọn của người chơi, cho phép người chơi chọn những người chơi khác để tham gia vào phòng.
|
ShowPlayerSelectUIBlocking(Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
|
Chặn phiên bản của ShowPlayerSelectUI.
|
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
|
Tình trạng quá tải ShowPlayerSelectUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
ShowRoomInboxUI(RoomInboxUICallback callback)
|
void
Hiển thị không đồng bộ giao diện người dùng trong hộp thư đến của phòng, cho phép người chơi chọn lời mời nhiều người chơi.
|
ShowRoomInboxUIBlocking(Timeout timeout)
|
Chặn phiên bản ShowRoomInboxUI.
|
ShowRoomInboxUIBlocking()
|
Tình trạng quá tải đối với ShowRoomInboxUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
ShowWaitingRoomUI(const RealTimeRoom & room, uint32_t min_participants_to_start, WaitingRoomUICallback callback)
|
void
Hiển thị giao diện người dùng của phòng chờ cho thấy trạng thái Người tham gia nhiều người chơi tham gia phòng này.
|
ShowWaitingRoomUIBlocking(Timeout timeout, const RealTimeRoom & room, uint32_t min_participants_to_start)
|
Chặn phiên bản ShowWaitingRoomUI.
|
ShowWaitingRoomUIBlocking(const RealTimeRoom & room, uint32_t min_participants_to_start)
|
Tình trạng quá nhiều đối với ShowWaitingRoomUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
|
Cấu trúc |
|
---|---|
gpg:: |
|
gpg:: |
|
gpg:: |
|
gpg:: |
|
Loại công khai
FetchInvitationsCallback
std::function< void(const FetchInvitationsResponse &)> FetchInvitationsCallback
Xác định lệnh gọi lại có thể dùng để nhận WaitingRoomUIResponse
từ một trong các hoạt động nhiều người chơi theo thời gian thực.
LeaveRoomCallback
std::function< void(const ResponseStatus &)> LeaveRoomCallback
Xác định lệnh gọi lại có thể nhận ResponseStatus
từ LeaveRoom
.
PlayerSelectUICallback
std::function< void(const PlayerSelectUIResponse &)> PlayerSelectUICallback
Xác định lệnh gọi lại có thể nhận PlayerSelectUIResponse
từ ShowPlayerSelectUI
.
PlayerSelectUIResponse
TurnBasedMultiplayerManager::PlayerSelectUIResponse PlayerSelectUIResponse
Data
và ResponseStatus
cho thao tác ShowPlayerSelectUI
.
Trò chơi này được chia sẻ với nhiều người chơi theo lượt.
RealTimeRoomCallback
std::function< void(const RealTimeRoomResponse &)> RealTimeRoomCallback
Xác định lệnh gọi lại có thể dùng để nhận cấu trúc RealTimeRoomResponse
qua một trong các hoạt động nhiều người chơi theo lượt.
RoomInboxUICallback
std::function< void(const RoomInboxUIResponse &)> RoomInboxUICallback
Xác định lệnh gọi lại có thể nhận RoomInboxUIResponse
từ ShowRoomInboxUI
.
SendReliableMessageCallback
std::function< void(const MultiplayerStatus &)> SendReliableMessageCallback
Xác định lệnh gọi lại có thể nhận ResponseStatus
từ SendReliableMessage
.
WaitingRoomUICallback
std::function< void(const WaitingRoomUIResponse &)> WaitingRoomUICallback
Xác định lệnh gọi lại có thể dùng để nhận WaitingRoomUIResponse
từ một trong các hoạt động nhiều người chơi theo thời gian thực.
Hàm công khai
AcceptInvitation
void AcceptInvitation( const MultiplayerInvitation & invitation, IRealTimeEventListener *listener, RealTimeRoomCallback callback )
Chấp nhận MultiplayerInvitation
một cách không đồng bộ và trả về kết quả qua RealTimeRoomCallback
.
AcceptInvitation
void AcceptInvitation( const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback )
Chấp nhận MultiplayerInvitation
một cách không đồng bộ và trả về kết quả qua RealTimeRoomCallback
.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( Timeout timeout, const MultiplayerInvitation & invitation, IRealTimeEventListener *listener )
Chặn phiên bản của AcceptInvitation.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( const MultiplayerInvitation & invitation, IRealTimeEventListener *listener )
Tình trạng quá tải của AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( Timeout timeout, const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper )
Chặn phiên bản của AcceptInvitation.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper )
Tình trạng quá tải của AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.
CreateRealTimeRoom
void CreateRealTimeRoom( const gpg::RealTimeRoomConfig & config, IRealTimeEventListener *listener, RealTimeRoomCallback callback )
Tạo đối tượng RealTimeRoom
một cách không đồng bộ bằng cách sử dụng lớp RealTimeRoomConfig
đã cung cấp.
Nếu tạo thành công, hàm này sẽ trả về đối tượng RealTimeRoom
thông qua RealTimeRoomCallback
được cung cấp.
CreateRealTimeRoom
void CreateRealTimeRoom( const gpg::RealTimeRoomConfig & config, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback )
Tạo đối tượng RealTimeRoom
một cách không đồng bộ bằng cách sử dụng lớp RealTimeRoomConfig
đã cung cấp.
Nếu tạo thành công, hàm này sẽ trả về đối tượng RealTimeRoom
thông qua RealTimeRoomCallback
được cung cấp.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( Timeout timeout, const RealTimeRoomConfig & config, IRealTimeEventListener *listener )
Chặn phiên bản của CreateRealTimeRoom.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( const RealTimeRoomConfig & config, IRealTimeEventListener *listener )
Quá tải CreateRealTimeRoomBlocking, sử dụng thời gian chờ mặc định là 10 năm.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( Timeout timeout, const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper )
Chặn phiên bản của CreateRealTimeRoom.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper )
Quá tải CreateRealTimeRoomBlocking, sử dụng thời gian chờ mặc định là 10 năm.
DeclineInvitation
void DeclineInvitation( const MultiplayerInvitation & invitation )
Từ chối một MultiplayerInvitation
với một RealTimeRoom
.
Thao tác này sẽ huỷ phòng dành cho những người tham gia khác và xoá phòng khỏi thiết bị của người chơi trên thiết bị.
DismissInvitation
void DismissInvitation( const MultiplayerInvitation & invitation )
Đóng MultiplayerInvitation
khỏi RealTimeRoom
.
Thao tác này không làm thay đổi trạng thái hiển thị của RealTimeRoom
đối với những người tham gia khác, nhưng sẽ xoá trạng thái đó khỏi thiết bị của người chơi trên thiết bị.
FetchInvitations
void FetchInvitations( FetchInvitationsCallback callback )
Tìm nạp mọi MultiplayerInvitation
cho các phòng theo thời gian thực.
Các MultiplayerInvitation
đã tìm nạp được trả về qua FetchInvitationsCallback
được cung cấp.
FetchInvitationsBlocking
FetchInvitationsResponse FetchInvitationsBlocking( Timeout timeout )
Chặn phiên bản của FetchInvitations.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã tách riêng trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
FetchInvitationsBlocking
FetchInvitationsResponse FetchInvitationsBlocking()
Tình trạng quá tải của FetchInvitationsBlocking, sử dụng thời gian chờ mặc định là 10 năm.
LeaveRoom
void LeaveRoom( const RealTimeRoom & room, LeaveRoomCallback callback )
Rời khỏi một RealTimeRoom
.
Bạn không nên tạo phòng mới hoặc tìm cách tham gia một phòng khác cho đến khi hoạt động này hoàn tất. Kết quả của thao tác này được trả về qua LeaveRoomCallback
.
LeaveRoomBlocking
ResponseStatus LeaveRoomBlocking( Timeout timeout, const RealTimeRoom & room )
Đang chặn phiên bản LeaveRoom.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
LeaveRoomBlocking
ResponseStatus LeaveRoomBlocking( const RealTimeRoom & room )
Tình trạng quá tải của LeaveRoomBlocking, sử dụng thời gian chờ mặc định là 10 năm.
SendReliableMessage
void SendReliableMessage( const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data, SendReliableMessageCallback callback )
Gửi tin nhắn đến MultiplayerParticipant
được chỉ định.
Sử dụng một phương thức đáng tin cậy để gửi tin nhắn. Phương pháp gửi dữ liệu này có thể mất nhiều thời gian hơn so với việc gửi tin nhắn một cách không đáng tin cậy. Kết quả gửi được báo cáo qua lệnh gọi lại đã cung cấp.
SendReliableMessageBlocking
MultiplayerStatus SendReliableMessageBlocking( Timeout timeout, const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data )
Chặn phiên bản của SendReliableMessage.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
SendReliableMessageBlocking
MultiplayerStatus SendReliableMessageBlocking( const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data )
Nạp chồng SendReliableMessageBlocking, sử dụng thời gian chờ mặc định là 10 năm.
SendUnreliableMessage
void SendUnreliableMessage( const RealTimeRoom & room, const std::vector< MultiplayerParticipant > & participants, std::vector< uint8_t > data )
Gửi tin nhắn đến các MultiplayerParticipant
được chỉ định.
Sử dụng phương thức không đáng tin cậy để gửi tin nhắn. Phương thức gửi dữ liệu này nhanh hơn cách gửi dữ liệu theo cách đáng tin cậy và nên được ưu tiên nếu có thể.
SendUnreliableMessageToOthers
void SendUnreliableMessageToOthers( const RealTimeRoom & room, std::vector< uint8_t > data )
Gửi tin nhắn cho tất cả người tham gia không phải người dùng hiện tại.
Sử dụng phương thức không đáng tin cậy để gửi tin nhắn. Phương thức gửi dữ liệu này nhanh hơn so với việc gửi dữ liệu theo cách đáng tin cậy và nên được ưu tiên nếu có thể.
ShowPlayerSelectUI
void ShowPlayerSelectUI( uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback )
Hiển thị không đồng bộ giao diện người dùng chọn của người chơi, cho phép người chơi chọn những người chơi khác để tham gia vào phòng.
Sau khi hoàn thành, những người chơi đã chọn sẽ được trả về qua PlayerSelectUICallback
.
ShowPlayerSelectUIBlocking
PlayerSelectUIResponse ShowPlayerSelectUIBlocking( Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch )
Chặn phiên bản của ShowPlayerSelectUI.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
ShowPlayerSelectUIBlocking
PlayerSelectUIResponse ShowPlayerSelectUIBlocking( uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch )
Tình trạng quá tải ShowPlayerSelectUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
ShowRoomInboxUI
void ShowRoomInboxUI( RoomInboxUICallback callback )
Hiển thị không đồng bộ giao diện người dùng trong hộp thư đến của phòng, cho phép người chơi chọn lời mời nhiều người chơi.
Sau khi hoàn tất, lời mời đã chọn sẽ được trả về qua RoomInboxUIResponse
.
ShowRoomInboxUIBlocking
RoomInboxUIResponse ShowRoomInboxUIBlocking( Timeout timeout )
Chặn phiên bản ShowRoomInboxUI.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
ShowRoomInboxUIBlocking
RoomInboxUIResponse ShowRoomInboxUIBlocking()
Tình trạng quá tải đối với ShowRoomInboxUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
ShowWaitingRoomUI
void ShowWaitingRoomUI( const RealTimeRoom & room, uint32_t min_participants_to_start, WaitingRoomUICallback callback )
Hiển thị giao diện người dùng của phòng chờ cho thấy trạng thái Người tham gia nhiều người chơi tham gia phòng này.
ShowWaitingRoomUIBlocking
WaitingRoomUIResponse ShowWaitingRoomUIBlocking( Timeout timeout, const RealTimeRoom & room, uint32_t min_participants_to_start )
Chặn phiên bản ShowWaitingRoomUI.
Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian đã tách riêng trôi qua, hàm sẽ trả về ERROR_TIMEOUT
.
ShowWaitingRoomUIBlocking
WaitingRoomUIResponse ShowWaitingRoomUIBlocking( const RealTimeRoom & room, uint32_t min_participants_to_start )
Tình trạng quá nhiều đối với ShowWaitingRoomUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.