PICO Unreal Platform SDK
OnlineSessionInterfacePico.h
1// Copyright 2022 Pico Technology Co., Ltd.All rights reserved.
2// This plugin incorporates portions of the Unreal® Engine. Unreal® is a trademark or registered trademark of Epic Games, Inc.In the United States of America and elsewhere.
3// Unreal® Engine, Copyright 1998 – 2022, Epic Games, Inc.All rights reserved.
4
5#pragma once
6
7#include "CoreMinimal.h"
8#include "OnlineSubsystemPico.h"
9#include "Interfaces/OnlineSessionInterface.h"
10#include "OnlineSubsystemPicoPackage.h"
11
13
14// @brief Used to set the matchmaking pool name.
15#define SETTING_PICO_POOL FName(TEXT("PICOPOOL"))
16// @brief Used to set the pico build unique ID.
17#define SETTING_PICO_BUILD_UNIQUE_ID FName(TEXT("PICOSESSIONBUILDUNIQUEID"))
18// @brief Used to set whether to search for moderated rooms.
19#define SEARCH_PICO_MODERATED_ROOMS_ONLY FName(TEXT("PICOMODERATEDROOMSONLY"))
20// @brief Used to set the page index when searching for moderated rooms.
21#define GET_MODERATEDROOMS_PAGEINDEX FName(TEXT("GETMODERATEDROOMSPAGEINDEX"))
22// @brief Used to set the page size when searching for moderated rooms.
23#define GET_MODERATEDROOMS_PAGESIZE FName(TEXT("GETMODERATEDROOMSPAGESIZE"))
24
25class FUniqueNetIdPico;
26class FOnlineSessionInfoPico;
27
28
29// Notifications
30DECLARE_MULTICAST_DELEGATE_TwoParams(FOnGameConnectionComplete, int /*Result*/, bool /*bWasSuccessful*/);
31DECLARE_MULTICAST_DELEGATE_TwoParams(FOnGameRequestFailedComplete, int /*Result*/, bool /*bWasSuccessful*/);
32DECLARE_MULTICAST_DELEGATE_OneParam(FOnGameStateResetComplete, bool /*bWasSuccessful*/);
33DECLARE_MULTICAST_DELEGATE_OneParam(FOnMatchmakingCancel2Complete, bool /*bWasSuccessful*/);
34DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomLeaveComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
35DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomJoin2Complete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
36DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomSetDescriptionComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
37DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomKickUserComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
38DECLARE_MULTICAST_DELEGATE_OneParam(FOnRoomUpdateOwnerComplete, bool /*bWasSuccessful*/);
39DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomUpdateDataStoreComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
40DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomUpdateMembershipLockStatusComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
41DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomUpdateComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
42DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomInviteAcceptedComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
43DECLARE_MULTICAST_DELEGATE_FourParams(FOnPicoSessionUserInviteAcceptedComplete, const bool /*bWasSuccessful*/, const int32 /*ControllerId*/, const FString& /*UserId*/, const FPicoOnlineSessionSearchResult& /*InviteResult*/);
44
45
46
59class FOnlineSessionPico : public IOnlineSession
60{
61private:
62
63 // <summary>Reference to the main Pico subsystem.</summary>
64 FOnlineSubsystemPico& PicoSubsystem;
65
66 // <summary>Current sessions map.</summary>
67 TMap<FName, TSharedPtr<FNamedOnlineSession>> Sessions;
68
69 // <summary>The SearchSettings for matchmaking.</summary>
70 TSharedPtr<FOnlineSessionSearch> InProgressMatchmakingSearch;
71
72 // <summary>The SessionName when in matchmaking.</summary>
73 FName InProgressMatchmakingSearchName;
74
78 ppfID GetRoomIDOfSession(const FNamedOnlineSession& Session) const;
79
80 // <summary>Returns the search results of the sessions where the invitation has been accepted. Supported version: 4.8.0 or later.</summary>
81 TArray<TSharedRef<const FOnlineSessionSearchResult>> InviteAcceptedSessions;
82
83
84 TArray<TSharedRef<const FOnlineSessionSearchResult>> PendingInviteAcceptedSessions;
85 ppfID InviteAcceptedRoomID;
86
90 int32 GetRoomBuildUniqueId(const ppfRoomHandle Room);
91
92 static void SaveLog(const ELogVerbosity::Type Verbosity, const FString& Log);
93
94PACKAGE_SCOPE:
95
96 FDelegateHandle OnRoomNotificationUpdateHandle;
97 void OnRoomNotificationUpdate(ppfMessageHandle Message, bool bIsError);
98
99 FDelegateHandle OnRoomNotificationInviteAcceptedHandle;
100 void OnRoomInviteAccepted(ppfMessageHandle Message, bool bIsError);
101
102 FDelegateHandle OnMatchmakingNotificationMatchFoundHandle;
103 void OnMatchmakingNotificationMatchFound(ppfMessageHandle Message, bool bIsError);
104
105 TSharedRef<FOnlineSession> CreateSessionFromRoom(ppfRoomHandle Room) const;
106
107 void UpdateSessionFromRoom(FNamedOnlineSession& Session, ppfRoomHandle Room) const;
108 void UpdateSessionSettingsFromDataStore(FOnlineSessionSettings& SessionSettings, ppfDataStoreHandle DataStore) const;
109
110 void TickPendingInvites(float DeltaTime);
111
112 bool CreateRoomSession(FNamedOnlineSession& Session, ppfRoomJoinPolicy JoinPolicy);
113 bool CreateMatchmakingSession(FNamedOnlineSession& Session, ppfRoomJoinPolicy JoinPolicy);
114 void OnCreateRoomComplete(ppfMessageHandle Message, bool bIsError, FName SessionName);
115
124 bool FindModeratedRoomSessions(const TSharedRef<FOnlineSessionSearch>& SearchSettings);
125
135 bool FindMatchmakingSessions(const FString Pool, const TSharedRef<FOnlineSessionSearch>& SearchSettings);
136
137 bool UpdateRoomDataStore(FName SessionName, FOnlineSessionSettings& UpdatedSessionSettings);
138
139
140public:
141
142 // <summary>The constructor.</summary>
143 // <param name="InSubsystem">A reference to the online subsystem.</param>
144 FOnlineSessionPico(FOnlineSubsystemPico& InSubsystem);
145
148
149
150 // Begin IOnlineSession interface
151
165 virtual bool CreateSession(int32 HostingPlayerNum, FName SessionName, const FOnlineSessionSettings& NewSessionSettings) override;
166 virtual bool CreateSession(const FUniqueNetId& HostingPlayerId, FName SessionName, const FOnlineSessionSettings& NewSessionSettings) override;
167
176 virtual bool StartSession(FName SessionName) override;
177
188 virtual bool UpdateSession(FName SessionName, FOnlineSessionSettings& UpdatedSessionSettings, bool bShouldRefreshOnlineData = true) override;
189
198 virtual bool EndSession(FName SessionName) override;
199
212 virtual bool DestroySession(FName SessionName, const FOnDestroySessionCompleteDelegate& CompletionDelegate = FOnDestroySessionCompleteDelegate()) override;
213
223 virtual bool IsPlayerInSession(FName SessionName, const FUniqueNetId& UniqueId) override;
224
236 virtual bool StartMatchmaking(const TArray< TSharedRef<const FUniqueNetId> >& LocalPlayers, FName SessionName, const FOnlineSessionSettings& NewSessionSettings, TSharedRef<FOnlineSessionSearch>& SearchSettings) override;
237
247 virtual bool CancelMatchmaking(int32 SearchingPlayerNum, FName SessionName) override;
248 virtual bool CancelMatchmaking(const FUniqueNetId& SearchingPlayerId, FName SessionName) override;
249
259 virtual bool FindSessions(int32 SearchingPlayerNum, const TSharedRef<FOnlineSessionSearch>& SearchSettings) override;
260 virtual bool FindSessions(const FUniqueNetId& SearchingPlayerId, const TSharedRef<FOnlineSessionSearch>& SearchSettings) override;
261
273 virtual bool FindSessionById(const FUniqueNetId& SearchingUserId, const FUniqueNetId& SessionId, const FUniqueNetId& FriendId, const FOnSingleSessionResultCompleteDelegate& CompletionDelegate) override;
274 virtual bool CancelFindSessions() override;
275 virtual bool PingSearchResults(const FOnlineSessionSearchResult& SearchResult) override;
276
287 virtual bool JoinSession(int32 PlayerNum, FName SessionName, const FOnlineSessionSearchResult& DesiredSession) override;
288 virtual bool JoinSession(const FUniqueNetId& PlayerId, FName SessionName, const FOnlineSessionSearchResult& DesiredSession) override;
289
290 virtual bool FindFriendSession(int32 LocalUserNum, const FUniqueNetId& Friend) override;
291 virtual bool FindFriendSession(const FUniqueNetId& LocalUserId, const FUniqueNetId& Friend) override;
292 virtual bool FindFriendSession(const FUniqueNetId& LocalUserId, const TArray<TSharedRef<const FUniqueNetId>>& FriendList) override;
293
294 virtual bool SendSessionInviteToFriend(int32 LocalUserNum, FName SessionName, const FUniqueNetId& Friend) override;
295 virtual bool SendSessionInviteToFriend(const FUniqueNetId& LocalUserId, FName SessionName, const FUniqueNetId& Friend) override;
296 virtual bool SendSessionInviteToFriends(int32 LocalUserNum, FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Friends) override;
297 virtual bool SendSessionInviteToFriends(const FUniqueNetId& LocalUserId, FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Friends) override;
298 virtual bool GetResolvedConnectString(FName SessionName, FString& ConnectInfo, FName PortType = NAME_GamePort) override;
299 virtual bool GetResolvedConnectString(const class FOnlineSessionSearchResult& SearchResult, FName PortType, FString& ConnectInfo) override;
300 virtual FOnlineSessionSettings* GetSessionSettings(FName SessionName) override;
301 virtual bool RegisterPlayer(FName SessionName, const FUniqueNetId& PlayerId, bool bWasInvited) override;
302 virtual bool RegisterPlayers(FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Players, bool bWasInvited = false) override;
303 virtual bool UnregisterPlayer(FName SessionName, const FUniqueNetId& PlayerId) override;
304 virtual bool UnregisterPlayers(FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Players) override;
305 virtual void RegisterLocalPlayer(const FUniqueNetId& PlayerId, FName SessionName, const FOnRegisterLocalPlayerCompleteDelegate& Delegate) override;
306 virtual void UnregisterLocalPlayer(const FUniqueNetId& PlayerId, FName SessionName, const FOnUnregisterLocalPlayerCompleteDelegate& Delegate) override;
307 virtual int32 GetNumSessions() override;
308 virtual void DumpSessionState() override;
309
310 virtual TSharedPtr<const FUniqueNetId> CreateSessionIdFromString(const FString& SessionIdStr) override;
311 FNamedOnlineSession* GetNamedSession(FName SessionName) override;
312 virtual void RemoveNamedSession(FName SessionName) override;
313 virtual EOnlineSessionState::Type GetSessionState(FName SessionName) const override;
314 virtual bool HasPresenceSession() override;
315 class FNamedOnlineSession* AddNamedSession(FName SessionName, const FOnlineSessionSettings& SessionSettings) override;
316 class FNamedOnlineSession* AddNamedSession(FName SessionName, const FOnlineSession& Session) override;
317
318
319private:
320 FString InitStateErrorMessage = FString("Error: InitSuccess is false");
321 bool InitSuccess = false;
322 bool OnUpdateRoomData(ppfRoomHandle Room, ppfID RoomId);
323 void OnRoomInviteAccepted(ppfID RoomId);
324PACKAGE_SCOPE:
325
326 void OnGetAccessTokenComplete(ppfMessageHandle Message, bool bIsError);
327 void OnGameInitializeComplete(ppfMessageHandle Message, bool bIsError);
328
329 // todo 这些是否可删
330 FDelegateHandle OnNetNotificationConnectionHandle;
331 void OnNetNotificationConnection(ppfMessageHandle Message, bool bIsError);
332
333 FDelegateHandle OnNetNotificationRequestFailedHandle;
334 void OnNetNotificationRequestFailed(ppfMessageHandle Message, bool bIsError);
335
336 FDelegateHandle OnNetNotificationGameStateResetHandle;
337 void OnNetNotificationGameStateReset(ppfMessageHandle Message, bool bIsError);
338
339 FDelegateHandle OnMatchmakingNotificationCancel2Handle;
340 void OnMatchmakingNotificationCancel2(ppfMessageHandle Message, bool bIsError);
341
342 FDelegateHandle OnRoomNotificationLeaveHandle;
343 void OnRoomNotificationLeave(ppfMessageHandle Message, bool bIsError);
344
345 FDelegateHandle OnRoomNotificationJoin2Handle;
346 void OnRoomNotificationJoin2(ppfMessageHandle Message, bool bIsError);
347
348 FDelegateHandle OnRoomNotificationSetDescriptionHandle;
349 void OnRoomNotificationSetDescription(ppfMessageHandle Message, bool bIsError);
350
351 FDelegateHandle OnRoomNotificationKickUserHandle;
352 void OnRoomNotificationKickUser(ppfMessageHandle Message, bool bIsError);
353
354 FDelegateHandle OnRoomNotificationUpdateOwnerHandle;
355 void OnRoomNotificationUpdateOwner(ppfMessageHandle Message, bool bIsError);
356
357 FDelegateHandle OnRoomNotificationUpdateDataStoreHandle;
358 void OnRoomNotificationUpdateDataStore(ppfMessageHandle Message, bool bIsError);
359
360 FDelegateHandle OnRoomNotificationUpdateMembershipLockStatusHandle;
361 void OnRoomNotificationUpdateMembershipLockStatus(ppfMessageHandle Message, bool bIsError);
362
363 void LogRoomData(ppfRoomHandle Room) const;
364
365public:
368
372
380 void SetInitState(bool State);
381
389 bool IsInitSuccess() const;
390
393
396 void OnForcedLeaveRoom(ppfID RoomID);
397
406
407 FOnRoomUpdateComplete RoomUpdateCallback;
408 FOnRoomInviteAcceptedComplete RoomInviteAcceptedCallback; // todo 可删
409 FOnPicoSessionUserInviteAcceptedComplete PicoSessionUserInviteAcceptedCallback; // todo 用这个还是用 RoomInviteAcceptedCallback
410
411 FOnGameConnectionComplete GameConnectionCallback;
412 FOnGameRequestFailedComplete GameRequestFailedCallback;
413 FOnGameStateResetComplete GameStateResetCallback;
414 FOnMatchmakingCancel2Complete MatchmakingCancel2Callback;
415 FOnRoomLeaveComplete RoomLeaveCallback;
416 FOnRoomJoin2Complete RoomJoin2Callback;
417 FOnRoomSetDescriptionComplete RoomSetDescriptionCallback;
418 FOnRoomKickUserComplete RoomKickUserCallback;
419 FOnRoomUpdateOwnerComplete RoomUpdateOwnerCallback;
420 FOnRoomUpdateDataStoreComplete RoomUpdateDataStoreCallback;
421 FOnRoomUpdateMembershipLockStatusComplete RoomUpdateMembershipLockStatusCallback;
422
423 const char* JoinPolicyNames[6] = { "None", "Everyone", "FriendsOfMembers", "FriendsOfOwner", "InvitedUsers", "Unknown" };
424 const char* RoomTypeNames[4] = { "Unknown", "Matchmaking", "Moderated", "Private" };
425 const char* ConnectionResultNames[8] = { "Connected", "Closed", "Lost", "Resumed", "KickedByRelogin", "KickedByGameServer", "GameLogicError", "Unknown" };
426 const char* JoinabilityNames[7] = { "Unknown", "AreIn", "AreKicked", "CanJoin", "IsFull", "NoViewer", "PolicyPrevents" };
427
428 void TestDumpNamedSession(const FNamedOnlineSession* NamedSession) const;
429 void TestDumpSession(const FOnlineSession* Session) const;
430 void TestDumpSessionSettings(const FOnlineSessionSettings* SessionSettings) const;
431}; // end of Session(OnlineSub) // end of Function
434typedef TSharedPtr<FOnlineSessionPico, ESPMode::ThreadSafe> FOnlineSessionPicoPtr;
FOnlineSessionPico class inherited from IOnlineSession(Unreal Engine).
Definition: OnlineSessionInterfacePico.h:60
bool IsInitSuccess() const
Checks the current state of InitSuccess.
virtual bool FindSessions(int32 SearchingPlayerNum, const TSharedRef< FOnlineSessionSearch > &SearchSettings) override
Searches for sessions matching the settings specified.
virtual bool CreateSession(int32 HostingPlayerNum, FName SessionName, const FOnlineSessionSettings &NewSessionSettings) override
Creates an online session based on the specified settings.
virtual ~FOnlineSessionPico()
The default destructor.
virtual bool JoinSession(int32 PlayerNum, FName SessionName, const FOnlineSessionSearchResult &DesiredSession) override
Joins the session specified.
void OnForcedCancelMatchmaking()
Forces to cancel matchmaking.
virtual bool UpdateSession(FName SessionName, FOnlineSessionSettings &UpdatedSessionSettings, bool bShouldRefreshOnlineData=true) override
Updates the localized settings/properties for the session in question.
int32 GetRoomBuildUniqueId(const ppfRoomHandle Room)
Gets the build unique ID of a room.
bool FindMatchmakingSessions(const FString Pool, const TSharedRef< FOnlineSessionSearch > &SearchSettings)
Searches for the "browse" type matchmaking rooms.
bool Uninitialize()
Uninitializes the game module.
ppfID GetRoomIDOfSession(const FNamedOnlineSession &Session) const
Gets the room ID of the session.
void OnForcedLeaveRoom(ppfID RoomID)
Forces to leave the specified room.
virtual bool StartMatchmaking(const TArray< TSharedRef< const FUniqueNetId > > &LocalPlayers, FName SessionName, const FOnlineSessionSettings &NewSessionSettings, TSharedRef< FOnlineSessionSearch > &SearchSettings) override
Starts cloud-based matchmaking for a session.
virtual bool CancelMatchmaking(int32 SearchingPlayerNum, FName SessionName) override
Cancels a matchmaking request for a given session.
void Initialize()
Initializes the game module.
void SetInitState(bool State)
Sets InitSuccess for the game module.
virtual bool StartSession(FName SessionName) override
Marks an online session as in progress (as opposed to being in lobby or pending).
virtual bool DestroySession(FName SessionName, const FOnDestroySessionCompleteDelegate &CompletionDelegate=FOnDestroySessionCompleteDelegate()) override
Destroys the specified online session.
virtual bool EndSession(FName SessionName) override
Marks an online session as having been ended.
bool FindModeratedRoomSessions(const TSharedRef< FOnlineSessionSearch > &SearchSettings)
Searches for moderated rooms.
virtual bool FindSessionById(const FUniqueNetId &SearchingUserId, const FUniqueNetId &SessionId, const FUniqueNetId &FriendId, const FOnSingleSessionResultCompleteDelegate &CompletionDelegate) override
Finds a session by session ID.
bool IsInMatchmakingProgress()
Checks InProgressMatchmakingSearch and SearchState.
virtual bool IsPlayerInSession(FName SessionName, const FUniqueNetId &UniqueId) override
Determines if the player is registered in the specified session.
Representation of a single search result. Similar to FOnlineSessionSearchResult.
Definition: OnlineSubsystemPicoNames.h:385