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 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
Data và ResponseStatus cho thao tác 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 qua một trong các 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 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
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::RealTimeMultiplayerManager::FetchInvitationsResponse

Data và ResponseStatus cho thao tác FetchInvitations.

gpg::RealTimeMultiplayerManager::RealTimeRoomResponse

Data và ResponseStatus cho một đối tượng RealTimeRoom cụ thể.

gpg::RealTimeMultiplayerManager::RoomInboxUIResponse

Data và ResponseStatus cho thao tác ShowRoomInboxUI.

gpg::RealTimeMultiplayerManager::WaitingRoomUIResponse

Data và ResponseStatus cho thao tác 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

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 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ể.

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.