gpg:: RealTimeMultiplayerManager
#include <real_time_multiplayer_manager.h>
提取、修改、处理 RealTimeRoom
对象的消息传递,并创建 RealTimeRoom
对象。
摘要
公共类型 |
|
---|---|
FetchInvitationsCallback
|
typedefstd::function< void(const FetchInvitationsResponse &)>
定义可用于从一项实时多人游戏操作接收 WaitingRoomUIResponse 的回调。 |
LeaveRoomCallback
|
typedefstd::function< void(const ResponseStatus &)>
定义可从 LeaveRoom 接收 ResponseStatus 的回调。 |
PlayerSelectUICallback
|
typedefstd::function< void(const PlayerSelectUIResponse &)>
定义可从 ShowPlayerSelectUI 接收 PlayerSelectUIResponse 的回调。 |
PlayerSelectUIResponse
|
typedef 用于 ShowPlayerSelectUI 操作的 Data 和 ResponseStatus 。 |
RealTimeRoomCallback
|
typedefstd::function< void(const RealTimeRoomResponse &)>
定义一个回调,用于从某个回合制多人游戏操作中接收 RealTimeRoomResponse 结构体。 |
RoomInboxUICallback
|
typedefstd::function< void(const RoomInboxUIResponse &)>
定义可从 ShowRoomInboxUI 接收 RoomInboxUIResponse 的回调。 |
SendReliableMessageCallback
|
typedefstd::function< void(const MultiplayerStatus &)>
定义可从 SendReliableMessage 接收 ResponseStatus 的回调。 |
WaitingRoomUICallback
|
typedefstd::function< void(const WaitingRoomUIResponse &)>
定义可用于从一项实时多人游戏操作接收 WaitingRoomUIResponse 的回调。 |
结构体 |
|
---|---|
gpg:: |
用于 |
gpg:: |
|
gpg:: |
用于 |
gpg:: |
用于 |
公共类型
FetchInvitationsCallback
std::function< void(const FetchInvitationsResponse &)> FetchInvitationsCallback
定义可用于从一项实时多人游戏操作接收 WaitingRoomUIResponse
的回调。
LeaveRoomCallback
std::function< void(const ResponseStatus &)> LeaveRoomCallback
定义可从 LeaveRoom
接收 ResponseStatus
的回调。
PlayerSelectUICallback
std::function< void(const PlayerSelectUIResponse &)> PlayerSelectUICallback
定义可从 ShowPlayerSelectUI
接收 PlayerSelectUIResponse
的回调。
PlayerSelectUIResponse
TurnBasedMultiplayerManager::PlayerSelectUIResponse PlayerSelectUIResponse
用于 ShowPlayerSelectUI
操作的 Data
和 ResponseStatus
。
这是与回合制多人游戏共享的内容。
RealTimeRoomCallback
std::function< void(const RealTimeRoomResponse &)> RealTimeRoomCallback
定义一个回调,用于从某个回合制多人游戏操作中接收 RealTimeRoomResponse
结构体。
RoomInboxUICallback
std::function< void(const RoomInboxUIResponse &)> RoomInboxUICallback
定义可从 ShowRoomInboxUI
接收 RoomInboxUIResponse
的回调。
SendReliableMessageCallback
std::function< void(const MultiplayerStatus &)> SendReliableMessageCallback
定义可从 SendReliableMessage
接收 ResponseStatus
的回调。
WaitingRoomUICallback
std::function< void(const WaitingRoomUIResponse &)> WaitingRoomUICallback
定义可用于从一项实时多人游戏操作接收 WaitingRoomUIResponse
的回调。
公共函数
AcceptInvitation
void AcceptInvitation( const MultiplayerInvitation & invitation, IRealTimeEventListener *listener, RealTimeRoomCallback callback )
异步接受 MultiplayerInvitation
,并通过 RealTimeRoomCallback
返回结果。
AcceptInvitation
void AcceptInvitation( const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback )
异步接受 MultiplayerInvitation
,并通过 RealTimeRoomCallback
返回结果。
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( Timeout timeout, const MultiplayerInvitation & invitation, IRealTimeEventListener *listener )
AcceptInvitation 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( const MultiplayerInvitation & invitation, IRealTimeEventListener *listener )
使 AcceptInvitationBlocking 过载,其默认超时时间为 10 年。
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( Timeout timeout, const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper )
AcceptInvitation 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper )
使 AcceptInvitationBlocking 过载,其默认超时时间为 10 年。
CreateRealTimeRoom
void CreateRealTimeRoom( const gpg::RealTimeRoomConfig & config, IRealTimeEventListener *listener, RealTimeRoomCallback callback )
使用提供的 RealTimeRoomConfig
类异步创建 RealTimeRoom
对象。
如果创建成功,此函数会通过提供的 RealTimeRoomCallback
返回 RealTimeRoom
对象。
CreateRealTimeRoom
void CreateRealTimeRoom( const gpg::RealTimeRoomConfig & config, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback )
使用提供的 RealTimeRoomConfig
类异步创建 RealTimeRoom
对象。
如果创建成功,此函数会通过提供的 RealTimeRoomCallback
返回 RealTimeRoom
对象。
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( Timeout timeout, const RealTimeRoomConfig & config, IRealTimeEventListener *listener )
CreateRealTimeRoom 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( const RealTimeRoomConfig & config, IRealTimeEventListener *listener )
CreateRealTimeRoomBlocking 过载,其默认超时时间为 10 年。
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( Timeout timeout, const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper )
CreateRealTimeRoom 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper )
CreateRealTimeRoomBlocking 过载,其默认超时时间为 10 年。
DeclineInvitation
void DeclineInvitation( const MultiplayerInvitation & invitation )
拒绝向 RealTimeRoom
发出的 MultiplayerInvitation
。
这样做会为其他参与者取消会议室,并从本地玩家的设备中移除该会议室。
DismissInvitation
void DismissInvitation( const MultiplayerInvitation & invitation )
关闭对 RealTimeRoom
的 MultiplayerInvitation
。
这不会更改其他参与者的 RealTimeRoom
的可见状态,但会将其从本地玩家的设备中移除。
FetchInvitations
void FetchInvitations( FetchInvitationsCallback callback )
获取实时聊天室的所有 MultiplayerInvitation
。
提取的 MultiplayerInvitation
通过提供的 FetchInvitationsCallback
返回。
FetchInvitationsBlocking
FetchInvitationsResponse FetchInvitationsBlocking( Timeout timeout )
FetchInvitations 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。超过指定时间后,该函数将返回 ERROR_TIMEOUT
。
FetchInvitationsBlocking
FetchInvitationsResponse FetchInvitationsBlocking()
过载 FetchInvitationsBlocking(默认超时时间为 10 年)。
LeaveRoom
void LeaveRoom( const RealTimeRoom & room, LeaveRoomCallback callback )
退出 RealTimeRoom
。
在此操作完成之前,请勿创建新聊天室或尝试加入其他聊天室。此操作的结果将通过 LeaveRoomCallback
返回。
LeaveRoomBlocking
ResponseStatus LeaveRoomBlocking( Timeout timeout, const RealTimeRoom & room )
LeaveRoom 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
LeaveRoomBlocking
ResponseStatus LeaveRoomBlocking( const RealTimeRoom & room )
使 LeaveRoomBlocking 过载,默认超时时间为 10 年。
SendReliableMessage
void SendReliableMessage( const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data, SendReliableMessageCallback callback )
向指定的 MultiplayerParticipant
发送消息。
使用可靠的方法发送消息。与无法可靠地发送消息相比,这种发送数据的方法可能需要更长时间。通过提供的回调报告发送结果。
SendReliableMessageBlocking
MultiplayerStatus SendReliableMessageBlocking( Timeout timeout, const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data )
SendReliableMessage 的阻塞版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
SendReliableMessageBlocking
MultiplayerStatus SendReliableMessageBlocking( const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data )
SendReliableMessageBlocking 的过载,默认超时时间为 10 年。
SendUnreliableMessage
void SendUnreliableMessage( const RealTimeRoom & room, const std::vector< MultiplayerParticipant > & participants, std::vector< uint8_t > data )
向指定的 MultiplayerParticipant
发送消息。
使用不可靠的方法发送消息。这种发送数据的方法比可靠地发送数据更快,应尽量首选使用方法。
SendUnreliableMessageToOthers
void SendUnreliableMessageToOthers( const RealTimeRoom & room, std::vector< uint8_t > data )
向除当前用户之外的所有参与者发送消息。
使用不可靠的方法发送消息。这种发送数据的方法比可靠地发送数据更快,应尽量首选使用方法。
ShowPlayerSelectUI
void ShowPlayerSelectUI( uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback )
异步显示玩家选择界面,允许玩家选择其他玩家加入房间。
完成后,系统会通过 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 年。
ShowRoomInboxUI
void ShowRoomInboxUI( RoomInboxUICallback callback )
异步显示聊天室收件箱界面,允许玩家选择多人游戏邀请。
完成后,系统会通过 RoomInboxUIResponse
返回所选的邀请。
ShowRoomInboxUIBlocking
RoomInboxUIResponse ShowRoomInboxUIBlocking( Timeout timeout )
ShowRoomInboxUI 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。指定的时间过后,该函数会返回 ERROR_TIMEOUT
。
ShowRoomInboxUIBlocking
RoomInboxUIResponse ShowRoomInboxUIBlocking()
ShowRoomInboxUIBlocking 过载,默认超时时间为 10 年。
ShowWaitingRoomUI
void ShowWaitingRoomUI( const RealTimeRoom & room, uint32_t min_participants_to_start, WaitingRoomUICallback callback )
显示等候室界面,其中会显示加入此会议室的 MultiplayerContributors 的状态。
ShowWaitingRoomUIBlocking
WaitingRoomUIResponse ShowWaitingRoomUIBlocking( Timeout timeout, const RealTimeRoom & room, uint32_t min_participants_to_start )
ShowWaitingRoomUI 的屏蔽版本。
允许调用方指定超时(以毫秒为单位)。超过指定时间后,该函数将返回 ERROR_TIMEOUT
。
ShowWaitingRoomUIBlocking
WaitingRoomUIResponse ShowWaitingRoomUIBlocking( const RealTimeRoom & room, uint32_t min_participants_to_start )
ShowWaitingRoomUIBlocking 的过载,其默认超时时间为 10 年。