PICO Unreal Platform SDK
OnlineSessionInterfacePico.h
1/*******************************************************************************
2Copyright © 2015-2022 PICO Technology Co., Ltd.All rights reserved.
3
4NOTICE:All information contained herein is, and remains the property of
5PICO Technology Co., Ltd. The intellectual and technical concepts
6contained herein are proprietary to PICO Technology Co., Ltd. and may be
7covered by patents, patents in process, and are protected by trade secret or
8copyright law. Dissemination of this information or reproduction of this
9material is strictly forbidden unless prior written permission is obtained from
10PICO Technology Co., Ltd.
11*******************************************************************************/
12// 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.
13// Unreal® Engine, Copyright 1998 – 2022, Epic Games, Inc.All rights reserved.
14
15#pragma once
16
17#include "CoreMinimal.h"
18#include "OnlineSubsystemPico.h"
19#include "Interfaces/OnlineSessionInterface.h"
20#include "OnlineSubsystemPicoPackage.h"
21
23
24// @brief Used to set the matchmaking pool name.
25#define SETTING_PICO_POOL FName(TEXT("PICOPOOL"))
26// @brief Used to set the pico build unique ID.
27#define SETTING_PICO_BUILD_UNIQUE_ID FName(TEXT("PICOSESSIONBUILDUNIQUEID"))
28// @brief Used to set whether to search for moderated rooms.
29#define SEARCH_PICO_MODERATED_ROOMS_ONLY FName(TEXT("PICOMODERATEDROOMSONLY"))
30// @brief Used to set the page index when searching for moderated rooms.
31#define GET_MODERATEDROOMS_PAGEINDEX FName(TEXT("GETMODERATEDROOMSPAGEINDEX"))
32// @brief Used to set the page size when searching for moderated rooms.
33#define GET_MODERATEDROOMS_PAGESIZE FName(TEXT("GETMODERATEDROOMSPAGESIZE"))
34
35class FUniqueNetIdPico;
36class FOnlineSessionInfoPico;
37
38
39// Notifications
40DECLARE_MULTICAST_DELEGATE_TwoParams(FOnGameConnectionComplete, int /*Result*/, bool /*bWasSuccessful*/);
41DECLARE_MULTICAST_DELEGATE_TwoParams(FOnGameRequestFailedComplete, int /*Result*/, bool /*bWasSuccessful*/);
42DECLARE_MULTICAST_DELEGATE_OneParam(FOnGameStateResetComplete, bool /*bWasSuccessful*/);
43DECLARE_MULTICAST_DELEGATE_OneParam(FOnMatchmakingCancel2Complete, bool /*bWasSuccessful*/);
44DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomLeaveComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
45DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomJoin2Complete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
46DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomSetDescriptionComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
47DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomKickUserComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
48DECLARE_MULTICAST_DELEGATE_OneParam(FOnRoomUpdateOwnerComplete, bool /*bWasSuccessful*/);
49DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomUpdateDataStoreComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
50DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomUpdateMembershipLockStatusComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
51DECLARE_MULTICAST_DELEGATE_TwoParams(FOnRoomInviteAcceptedComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/);
52DECLARE_MULTICAST_DELEGATE_FourParams(FOnPicoSessionUserInviteAcceptedComplete, const bool /*bWasSuccessful*/, const int32 /*ControllerId*/, const FString& /*UserId*/, const FPicoOnlineSessionSearchResult& /*InviteResult*/);
53
54DECLARE_MULTICAST_DELEGATE_FourParams(FOnRoomUpdateComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/, int, /*ErrorCode,*/ const FString& /*ErrorMessage*/);
55DECLARE_MULTICAST_DELEGATE_FourParams(FOnMatchmakingFoundComplete, const FString& /*RoomID*/, bool /*bWasSuccessful*/, int, /*ErrorCode,*/ const FString& /*ErrorMessage*/);
56
57
70class FOnlineSessionPico : public IOnlineSession
71{
72private:
73
74 // <summary>Reference to the main Pico subsystem.</summary>
75 FOnlineSubsystemPico& PicoSubsystem;
76
77 // <summary>Current sessions map.</summary>
78 TMap<FName, TSharedPtr<FNamedOnlineSession>> Sessions;
79
80 // <summary>The SearchSettings for matchmaking.</summary>
81 TSharedPtr<FOnlineSessionSearch> InProgressMatchmakingSearch;
82
83 // <summary>The SessionName when in matchmaking.</summary>
84 FName InProgressMatchmakingSearchName;
85
89 ppfID GetRoomIDOfSession(const FNamedOnlineSession& Session) const;
90
91 // <summary>Returns the search results of the sessions where the invitation has been accepted. Supported version: 4.8.0 or later.</summary>
92 TArray<TSharedRef<const FOnlineSessionSearchResult>> InviteAcceptedSessions;
93
94
95 TArray<TSharedRef<const FOnlineSessionSearchResult>> PendingInviteAcceptedSessions;
96 ppfID InviteAcceptedRoomID;
97
101 int32 GetRoomBuildUniqueId(const ppfRoomHandle Room);
102
103 static void SaveLog(const ELogVerbosity::Type Verbosity, const FString& Log);
104
105PACKAGE_SCOPE:
106
107 FDelegateHandle OnRoomNotificationUpdateHandle;
108 void OnRoomNotificationUpdate(ppfMessageHandle Message, bool bIsError);
109
110 FDelegateHandle OnRoomNotificationInviteAcceptedHandle;
111 void OnRoomInviteAccepted(ppfMessageHandle Message, bool bIsError);
112
113 FDelegateHandle OnMatchmakingNotificationMatchFoundHandle;
114 void OnMatchmakingNotificationMatchFound(ppfMessageHandle Message, bool bIsError);
115
116 TSharedRef<FOnlineSession> CreateSessionFromRoom(ppfRoomHandle Room) const;
117
118 void UpdateSessionFromRoom(FNamedOnlineSession& Session, ppfRoomHandle Room) const;
119 void UpdateSessionSettingsFromDataStore(FOnlineSessionSettings& SessionSettings, ppfDataStoreHandle DataStore) const;
120
121 void TickPendingInvites(float DeltaTime);
122
123 bool CreateRoomSession(FNamedOnlineSession& Session, ppfRoomJoinPolicy JoinPolicy);
124 bool CreateMatchmakingSession(FNamedOnlineSession& Session, ppfRoomJoinPolicy JoinPolicy);
125 void OnCreateRoomComplete(ppfMessageHandle Message, bool bIsError, FName SessionName);
126
135 bool FindModeratedRoomSessions(const TSharedRef<FOnlineSessionSearch>& SearchSettings);
136
146 bool FindMatchmakingSessions(const FString Pool, const TSharedRef<FOnlineSessionSearch>& SearchSettings);
147
148 bool UpdateRoomDataStore(FName SessionName, FOnlineSessionSettings& UpdatedSessionSettings);
149
150
151public:
152
153 // <summary>The constructor.</summary>
154 // <param name="InSubsystem">A reference to the online subsystem.</param>
155 FOnlineSessionPico(FOnlineSubsystemPico& InSubsystem);
156
159
160
161 // Begin IOnlineSession interface
162
176 virtual bool CreateSession(int32 HostingPlayerNum, FName SessionName, const FOnlineSessionSettings& NewSessionSettings) override;
177 virtual bool CreateSession(const FUniqueNetId& HostingPlayerId, FName SessionName, const FOnlineSessionSettings& NewSessionSettings) override;
178
187 virtual bool StartSession(FName SessionName) override;
188
199 virtual bool UpdateSession(FName SessionName, FOnlineSessionSettings& UpdatedSessionSettings, bool bShouldRefreshOnlineData = true) override;
200
209 virtual bool EndSession(FName SessionName) override;
210
223 virtual bool DestroySession(FName SessionName, const FOnDestroySessionCompleteDelegate& CompletionDelegate = FOnDestroySessionCompleteDelegate()) override;
224
234 virtual bool IsPlayerInSession(FName SessionName, const FUniqueNetId& UniqueId) override;
235
247 virtual bool StartMatchmaking(const TArray< TSharedRef<const FUniqueNetId> >& LocalPlayers, FName SessionName, const FOnlineSessionSettings& NewSessionSettings, TSharedRef<FOnlineSessionSearch>& SearchSettings) override;
248
258 virtual bool CancelMatchmaking(int32 SearchingPlayerNum, FName SessionName) override;
259 virtual bool CancelMatchmaking(const FUniqueNetId& SearchingPlayerId, FName SessionName) override;
260
270 virtual bool FindSessions(int32 SearchingPlayerNum, const TSharedRef<FOnlineSessionSearch>& SearchSettings) override;
271 virtual bool FindSessions(const FUniqueNetId& SearchingPlayerId, const TSharedRef<FOnlineSessionSearch>& SearchSettings) override;
272
284 virtual bool FindSessionById(const FUniqueNetId& SearchingUserId, const FUniqueNetId& SessionId, const FUniqueNetId& FriendId, const FOnSingleSessionResultCompleteDelegate& CompletionDelegate) override;
285 virtual bool CancelFindSessions() override;
286 virtual bool PingSearchResults(const FOnlineSessionSearchResult& SearchResult) override;
287
298 virtual bool JoinSession(int32 PlayerNum, FName SessionName, const FOnlineSessionSearchResult& DesiredSession) override;
299 virtual bool JoinSession(const FUniqueNetId& PlayerId, FName SessionName, const FOnlineSessionSearchResult& DesiredSession) override;
300
301 virtual bool FindFriendSession(int32 LocalUserNum, const FUniqueNetId& Friend) override;
302 virtual bool FindFriendSession(const FUniqueNetId& LocalUserId, const FUniqueNetId& Friend) override;
303 virtual bool FindFriendSession(const FUniqueNetId& LocalUserId, const TArray<TSharedRef<const FUniqueNetId>>& FriendList) override;
304
305 virtual bool SendSessionInviteToFriend(int32 LocalUserNum, FName SessionName, const FUniqueNetId& Friend) override;
306 virtual bool SendSessionInviteToFriend(const FUniqueNetId& LocalUserId, FName SessionName, const FUniqueNetId& Friend) override;
307 virtual bool SendSessionInviteToFriends(int32 LocalUserNum, FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Friends) override;
308 virtual bool SendSessionInviteToFriends(const FUniqueNetId& LocalUserId, FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Friends) override;
309 virtual bool GetResolvedConnectString(FName SessionName, FString& ConnectInfo, FName PortType = NAME_GamePort) override;
310 virtual bool GetResolvedConnectString(const class FOnlineSessionSearchResult& SearchResult, FName PortType, FString& ConnectInfo) override;
311 virtual FOnlineSessionSettings* GetSessionSettings(FName SessionName) override;
312 virtual bool RegisterPlayer(FName SessionName, const FUniqueNetId& PlayerId, bool bWasInvited) override;
313 virtual bool RegisterPlayers(FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Players, bool bWasInvited = false) override;
314 virtual bool UnregisterPlayer(FName SessionName, const FUniqueNetId& PlayerId) override;
315 virtual bool UnregisterPlayers(FName SessionName, const TArray< TSharedRef<const FUniqueNetId> >& Players) override;
316 virtual void RegisterLocalPlayer(const FUniqueNetId& PlayerId, FName SessionName, const FOnRegisterLocalPlayerCompleteDelegate& Delegate) override;
317 virtual void UnregisterLocalPlayer(const FUniqueNetId& PlayerId, FName SessionName, const FOnUnregisterLocalPlayerCompleteDelegate& Delegate) override;
318 virtual int32 GetNumSessions() override;
319 virtual void DumpSessionState() override;
320
321 virtual TSharedPtr<const FUniqueNetId> CreateSessionIdFromString(const FString& SessionIdStr) override;
322 FNamedOnlineSession* GetNamedSession(FName SessionName) override;
323 virtual void RemoveNamedSession(FName SessionName) override;
324 virtual EOnlineSessionState::Type GetSessionState(FName SessionName) const override;
325 virtual bool HasPresenceSession() override;
326 class FNamedOnlineSession* AddNamedSession(FName SessionName, const FOnlineSessionSettings& SessionSettings) override;
327 class FNamedOnlineSession* AddNamedSession(FName SessionName, const FOnlineSession& Session) override;
328
329
330private:
331 FString InitStateErrorMessage = FString("Error: InitSuccess is false");
332 bool InitSuccess = false;
333 bool OnUpdateRoomData(ppfRoomHandle Room, ppfID RoomId);
334 void OnRoomInviteAccepted(ppfID RoomId);
335PACKAGE_SCOPE:
336
337 void OnGetAccessTokenComplete(ppfMessageHandle Message, bool bIsError);
338 void OnGameInitializeComplete(ppfMessageHandle Message, bool bIsError);
339
340 FDelegateHandle OnNetNotificationConnectionHandle;
341 void OnNetNotificationConnection(ppfMessageHandle Message, bool bIsError);
342
343 FDelegateHandle OnNetNotificationRequestFailedHandle;
344 void OnNetNotificationRequestFailed(ppfMessageHandle Message, bool bIsError);
345
346 FDelegateHandle OnNetNotificationGameStateResetHandle;
347 void OnNetNotificationGameStateReset(ppfMessageHandle Message, bool bIsError);
348
349 FDelegateHandle OnMatchmakingNotificationCancel2Handle;
350 void OnMatchmakingNotificationCancel2(ppfMessageHandle Message, bool bIsError);
351
352 FDelegateHandle OnRoomNotificationLeaveHandle;
353 void OnRoomNotificationLeave(ppfMessageHandle Message, bool bIsError);
354
355 FDelegateHandle OnRoomNotificationJoin2Handle;
356 void OnRoomNotificationJoin2(ppfMessageHandle Message, bool bIsError);
357
358 FDelegateHandle OnRoomNotificationSetDescriptionHandle;
359 void OnRoomNotificationSetDescription(ppfMessageHandle Message, bool bIsError);
360
361 FDelegateHandle OnRoomNotificationKickUserHandle;
362 void OnRoomNotificationKickUser(ppfMessageHandle Message, bool bIsError);
363
364 FDelegateHandle OnRoomNotificationUpdateOwnerHandle;
365 void OnRoomNotificationUpdateOwner(ppfMessageHandle Message, bool bIsError);
366
367 FDelegateHandle OnRoomNotificationUpdateDataStoreHandle;
368 void OnRoomNotificationUpdateDataStore(ppfMessageHandle Message, bool bIsError);
369
370 FDelegateHandle OnRoomNotificationUpdateMembershipLockStatusHandle;
371 void OnRoomNotificationUpdateMembershipLockStatus(ppfMessageHandle Message, bool bIsError);
372
373 void LogRoomData(ppfRoomHandle Room) const;
374
375public:
378
382
390 void SetInitState(bool State);
391
399 bool IsInitSuccess() const;
400
403
406 void OnForcedLeaveRoom(ppfID RoomID);
407
416
417 FOnMatchmakingFoundComplete MatchmakingFoundCallback;
418 FOnRoomUpdateComplete RoomUpdateCallback;
419
420 FOnRoomInviteAcceptedComplete RoomInviteAcceptedCallback;
421 FOnPicoSessionUserInviteAcceptedComplete PicoSessionUserInviteAcceptedCallback;
422
423 FOnGameConnectionComplete GameConnectionCallback;
424 FOnGameRequestFailedComplete GameRequestFailedCallback;
425 FOnGameStateResetComplete GameStateResetCallback;
426 FOnMatchmakingCancel2Complete MatchmakingCancel2Callback;
427 FOnRoomLeaveComplete RoomLeaveCallback;
428 FOnRoomJoin2Complete RoomJoin2Callback;
429 FOnRoomUpdateOwnerComplete RoomUpdateOwnerCallback;
430 // Not Used
431 FOnRoomSetDescriptionComplete RoomSetDescriptionCallback;
432 FOnRoomKickUserComplete RoomKickUserCallback;
433 FOnRoomUpdateDataStoreComplete RoomUpdateDataStoreCallback;
434 FOnRoomUpdateMembershipLockStatusComplete RoomUpdateMembershipLockStatusCallback;
435
436 const char* JoinPolicyNames[6] = { "None", "Everyone", "FriendsOfMembers", "FriendsOfOwner", "InvitedUsers", "Unknown" };
437 const char* RoomTypeNames[4] = { "Unknown", "Matchmaking", "Moderated", "Private" };
438 const char* ConnectionResultNames[8] = { "Connected", "Closed", "Lost", "Resumed", "KickedByRelogin", "KickedByGameServer", "GameLogicError", "Unknown" };
439 const char* JoinabilityNames[7] = { "Unknown", "AreIn", "AreKicked", "CanJoin", "IsFull", "NoViewer", "PolicyPrevents" };
440
441 void TestDumpNamedSession(const FNamedOnlineSession* NamedSession) const;
442 void TestDumpSession(const FOnlineSession* Session) const;
443 void TestDumpSessionSettings(const FOnlineSessionSettings* SessionSettings) const;
444}; // end of Session(OnlineSub) // end of Function
447typedef TSharedPtr<FOnlineSessionPico, ESPMode::ThreadSafe> FOnlineSessionPicoPtr;
FOnlineSessionPico class inherited from IOnlineSession(Unreal Engine).
Definition: OnlineSessionInterfacePico.h:71
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:395