gpg::RealTimeMultiplayerManager

#include <real_time_multiplayer_manager.h>

Tìm nạp, sửa đổi, xử lý việc nhắn tin và tạo đối tượng RealTimeRoom.

Tóm tắt

Loại công khai

FetchInvitationsCallback typedef
std::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 typedef
std::function< void(const ResponseStatus &)>
Xác định lệnh gọi lại có thể nhận ResponseStatus từ LeaveRoom.
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
Xác định lệnh gọi lại có thể nhận PlayerSelectUIResponse từ ShowPlayerSelectUI.
PlayerSelectUIResponse typedef
DataResponseStatus cho toán tử ShowPlayerSelectUI.
RealTimeRoomCallback typedef
std::function< void(const RealTimeRoomResponse &)>
Xác định lệnh gọi lại có thể dùng để nhận cấu trúc RealTimeRoomResponse từ một trong những hoạt động nhiều người chơi theo lượt.
RoomInboxUICallback typedef
std::function< void(const RoomInboxUIResponse &)>
Xác định lệnh gọi lại có thể nhận RoomInboxUIResponse từ ShowRoomInboxUI.
SendReliableMessageCallback typedef
std::function< void(const MultiplayerStatus &)>
Xác định lệnh gọi lại có thể nhận ResponseStatus từ SendReliableMessage.
WaitingRoomUICallback typedef
std::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 không đồng bộ MultiplayerInvitation và trả về kết quả qua RealTimeRoomCallback.
AcceptInvitation(const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback)
void
Chấp nhận không đồng bộ MultiplayerInvitation và trả về kết quả qua RealTimeRoomCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation, IRealTimeEventListener *listener)
Phiên bản chặn của AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation, IRealTimeEventListener *listener)
Tùy chọn nạp chồng AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper)
Phiên bản chặn của AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper)
Tùy chọn nạp chồng 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 một đối tượng RealTimeRoom một cách không đồng bộ bằng lớp RealTimeRoomConfig được cung cấp.
CreateRealTimeRoom(const gpg::RealTimeRoomConfig & config, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback)
void
Tạo một đối tượng RealTimeRoom một cách không đồng bộ bằng lớp RealTimeRoomConfig được cung cấp.
CreateRealTimeRoomBlocking(Timeout timeout, const RealTimeRoomConfig & config, IRealTimeEventListener *listener)
Phiên bản chặn của CreateRealTimeRoom.
CreateRealTimeRoomBlocking(const RealTimeRoomConfig & config, IRealTimeEventListener *listener)
Xử lý 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)
Phiên bản chặn của CreateRealTimeRoom.
CreateRealTimeRoomBlocking(const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper)
Xử lý 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 MultiplayerInvitation đến RealTimeRoom.
DismissInvitation(const MultiplayerInvitation & invitation)
void
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)
Phiên bản chặn của FetchInvitations.
FetchInvitationsBlocking()
Tình trạng nạp chồng của FetchInvitationsBlocking, sử dụng thời gian chờ mặc định là 10 năm.
LeaveRoom(const RealTimeRoom & room, LeaveRoomCallback callback)
void
Để lại một RealTimeRoom.
LeaveRoomBlocking(Timeout timeout, const RealTimeRoom & room)
Chặn phiên bản LeaveRoom.
LeaveRoomBlocking(const RealTimeRoom & room)
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 đã chỉ định.
SendReliableMessageBlocking(Timeout timeout, const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data)
Chặn phiên bản SendReliableMessage.
SendReliableMessageBlocking(const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data)
Quá tải 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 đã chỉ định.
SendUnreliableMessageToOthers(const RealTimeRoom & room, std::vector< uint8_t > data)
void
Gửi tin nhắn cho tất cả những người tham gia trừ 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 người chơi, cho phép người chơi chọn những người chơi khác tham gia phòng cùng.
ShowPlayerSelectUIBlocking(Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Phiên bản chặn của ShowPlayerSelectUI.
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Quá tải của 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 của 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)
Phiên bản chặn của ShowRoomInboxUI.
ShowRoomInboxUIBlocking()
Quá tải của 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
Giao diện người dùng của phòng chờ cho thấy trạng thái của những Người tham gia nhiều người chơi đang 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)
Quá tải của ShowWaitingRoomUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.

Cấu trúc

gpg::RealTimeMultiplayerManager::FetchInvitationsResponse

DataResponseStatus cho toán tử FetchInvitations.

gpg::RealTimeMultiplayerManager::RealTimeRoomResponse

DataResponseStatus cho một đối tượng RealTimeRoom cụ thể.

gpg::RealTimeMultiplayerManager::RoomInboxUIResponse

DataResponseStatus cho toán tử ShowRoomInboxUI.

gpg::RealTimeMultiplayerManager::WaitingRoomUIResponse

DataResponseStatus cho toán tử ShowWaitingRoomUI.

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

DataResponseStatus cho toán tử ShowPlayerSelectUI.

Tính năng này được chia sẻ với chế độ 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 từ một trong những 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 không đồng bộ MultiplayerInvitation và trả về kết quả qua RealTimeRoomCallback.

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  RealTimeEventListenerHelper helper,
  RealTimeRoomCallback callback
)

Chấp nhận không đồng bộ MultiplayerInvitation và trả về kết quả qua RealTimeRoomCallback.

AcceptInvitationBlocking

RealTimeRoomResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation,
  IRealTimeEventListener *listener
)

Phiên bản chặ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 được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

AcceptInvitationBlocking

RealTimeRoomResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation,
  IRealTimeEventListener *listener
)

Tùy chọn nạp chồng 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
)

Phiên bản chặ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 được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

AcceptInvitationBlocking

RealTimeRoomResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation,
  RealTimeEventListenerHelper helper
)

Tùy chọn nạp chồng 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 một đối tượng RealTimeRoom một cách không đồng bộ bằng lớp RealTimeRoomConfig được 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 một đối tượng RealTimeRoom một cách không đồng bộ bằng lớp RealTimeRoomConfig được 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
)

Phiên bản chặ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 được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

CreateRealTimeRoomBlocking

RealTimeRoomResponse CreateRealTimeRoomBlocking(
  const RealTimeRoomConfig & config,
  IRealTimeEventListener *listener
)

Xử lý 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
)

Phiên bản chặ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 được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

CreateRealTimeRoomBlocking

RealTimeRoomResponse CreateRealTimeRoomBlocking(
  const RealTimeRoomConfig & config,
  RealTimeEventListenerHelper helper
)

Xử lý 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 MultiplayerInvitation đến RealTimeRoom.

Thao tác này sẽ hủy phòng đối với những người tham gia khác và xóa phòng đó khỏi thiết bị của người chơi trên máy.

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Đóng MultiplayerInvitation cho RealTimeRoom.

Thao tác này không 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 này khỏi thiết bị của người chơi trên máy.

FetchInvitations

void FetchInvitations(
  FetchInvitationsCallback callback
)

Tìm nạp mọi MultiplayerInvitation cho các phòng theo thời gian thực.

MultiplayerInvitation đã tìm nạp sẽ được trả về qua FetchInvitationsCallback đã cung cấp.

FetchInvitationsBlocking

FetchInvitationsResponse FetchInvitationsBlocking(
  Timeout timeout
)

Phiên bản chặ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 được phân tách kết thúc, hàm sẽ trả về ERROR_TIMEOUT.

FetchInvitationsBlocking

FetchInvitationsResponse FetchInvitationsBlocking()

Tình trạng nạp chồng 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
)

Để lạ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 thao tác 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
)

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 được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

LeaveRoomBlocking

ResponseStatus LeaveRoomBlocking(
  const RealTimeRoom & room
)

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 đã 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 một tin nhắn 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 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 được 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
)

Quá tải 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 đã chỉ định.

Sử dụng một 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 một cách đáng tin cậy và nên được ưu tiên sử dụng nếu có thể.

SendUnreliableMessageToOthers

void SendUnreliableMessageToOthers(
  const RealTimeRoom & room,
  std::vector< uint8_t > data
)

Gửi tin nhắn cho tất cả những người tham gia trừ người dùng hiện tại.

Sử dụng một 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 một cách đáng tin cậy và nên được ưu tiên sử dụng 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 người chơi, cho phép người chơi chọn những người chơi khác tham gia phòng cùng.

Sau khi hoàn tất, 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
)

Phiên bản chặ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 được 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
)

Quá tải của 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 của 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
)

Phiên bản chặn của 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 được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

ShowRoomInboxUIBlocking

RoomInboxUIResponse ShowRoomInboxUIBlocking()

Quá tải của 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
)

Giao diện người dùng của phòng chờ cho thấy trạng thái của những Người tham gia nhiều người chơi đang 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 được phân tách kết thúc, hàm sẽ trả về ERROR_TIMEOUT.

ShowWaitingRoomUIBlocking

WaitingRoomUIResponse ShowWaitingRoomUIBlocking(
  const RealTimeRoom & room,
  uint32_t min_participants_to_start
)

Quá tải của ShowWaitingRoomUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.