If you plan so you can integrate Impressive Membership Functions along with your game, therefore must target console programs, excite call us in the eas-on-console- to help you complement a release package.
Winning contests with your relatives and you may meeting this new professionals on line are essential parts of of several on line features. New Epic On line Services (EOS) SDK uses this new Family Interface so you’re able to access brand new relatives listing getting good logged-for the athlete.
Friend listings is actually kept from the online service’s servers, and can changes during the an appointment once the household members is actually added otherwise removed or if perhaps members of the family grant otherwise revoke agree to the video game to use their recommendations.
Through to profitable conclusion from a pals listing ask, the fresh new Nearest and dearest Program produces a location cache which is used from the some other Household members Interface qualities. Together with SDK receives announcements in the backend on events that produce mutations of one’s family checklist, such as a pal are got rid of, an invitation being accepted otherwise a pal revoking the accept to have the suggestions used by the overall game.
To use the fresh new Family unit members Software, your product or service should have Impressive Membership Attributes (EAS) active, and may see representative accept availableness Nearest and dearest List studies. You might turn on EAS toward Creator Site, or get the full story in the Epic’s records.
Retrieving and Caching the newest Friends Record
In order to recover an excellent player’s nearest and dearest number, you will want an EOS_HFriends handle. You can get this deal with through the Platform Program setting, EOS_Platform_GetFriendsInterface . Family Software functions wanted it handle to get into your signed-during the customer’s family number. It is essential to remember that EOS_Friends_QueryFriends will only get back family relations with starred the game in the minimum immediately after and has provided the consent. Agree is given when a player logs directly into a software using Impressive Account Characteristics (EAS) and you will allows EAS use of their account study.
The initial step in working with a great player’s friends number was to-name EOS_Friends_QueryFriends which have a keen EOS_Friends_QueryFriendsOptions data construction. This can install the absolute most right up-to-big date sort of a beneficial player’s family relations checklist for the local cache, then invoke your EOS_Friends_QueryFriends callback setting through to conclusion.
Citation new Loved ones Software manage, this new EOS_Friends_QueryFriendsOptions construction, plus callback suggestions to your mode. Provided that the newest EOS_HPlatform handle was ticking, the brand new callback your given is going to run if the process concludes.
When your callback executes, you can check this new ResultCode field of the brand new EOS_Friends_QueryFriendsCallbackInfo build to decide whether the process been successful or unsuccessful. A success code demonstrates the SDK features cached this new research from the machine, that you’ll glance at any moment.
Exploring the Members of the family Number
- Determine what amount of family unit members with the checklist by contacting EOS_Friends_GetFriendsCount .
- Access the fresh EOS_EpicAccountId each and every pal by the calling EOS_Friends_GetFriendAtIndex .
The newest EOS_EpicAccountId returned by this mode would be enacted on the Representative Facts User interface in order to recover much more information regarding the user.
- Dictate the modern status of one’s personal relationship by contacting EOS_Friends_GetStatus . It function yields certainly one of five viewpoints:
Family relations listings can transform any moment, each other out-of inside-game events such as for example conference the chat room for black new players, and of aside-of-game events like the pro switching the new account of a great es don’t need and should not label EOS_Friends_QueryFriends over and over again for each login out-of a person. However, immediately after a player logs aside, their friends number must be queried again once they log on once more. To save an excellent game’s local backup of the members of the family record up up until now, subscribe to pal position update notifications.
Subscribing to Buddy Condition Condition
The brand new callback form would-be titled whenever a friend gets an upgrade. The latest callback get an EOS_Friends_OnFriendsUpdateInfo construction into following variables:
EOS_Friends_AddNotifyFriendsUpdate often return an enthusiastic EOS_NotificationId , that’s an alternative manage that must be familiar with unsubscribe out-of notifications while they are no longer required. In case there is a deep failing, it can get back a consequence password of EOS_INVALID_NOTIFICATIONID .
Managing the Household members Record
Service to possess Nintendo Option, PlayStation, and Xbox 360 console networks is arranged. Assistance to possess macOS, Linux, Android and ios are planned.
You can allow local affiliate to transmit friend demands to help you most other pages about games, of the contacting the latest EOS_Friends_SendInvite SDK API. To apply game UI functionality to own accepting otherwise rejecting people received buddy attracts, you should use the new EOS_Friends_AcceptInvite and you can EOS_Friends_RejectInvite SDK APIs correspondingly.
