Login with Facebook🔗

using MRGS;

public class MasterController : MonoBehaviour
{
    void Awake()
    {
        // Setting up MRGS params
        // ...

        var modulesParams = new List<MRGSExternalSDKSettings>
        modulesParams.Add(new MRGSFacebookParams("<FACEBOOK_APPID>"));
        // Setting up external sdk params
        // ...

        MRGService.Instance.Initialize(serviceParams, sdkParams);
    }
}

@import MRGService;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    //Configure MRGS Settings
    // ...
    //Configure external SDKs

    MRGSFacebookParams* facebookLoginParams = [[MRGSFacebookParams alloc] initWithAppId:@"<FACEBOOK_APP_ID>"];

    NSArray *externalParams = @[ ..., facebookLoginParams];
    [MRGService startWithServiceParams:<params> externalSDKParams:externalParams delegate:nil];
}

import games.my.mrgs.MRGSExternalSDKParams;
import games.my.mrgs.MRGSExternalSDKParams.FacebookParams;
import games.my.mrgs.MRGService;
import games.my.mrgs.MRGServiceParams;

public class YourApplicationClass extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // Setting MRGService
        final MRGServiceParams serviceParams = ...;
        // Setting External SDKs
        final MRGSExternalSDKParams externalSDKParams = MRGSExternalSDKParams.newInstance();
        externalSDKParams.facebookParams = FacebookParams.init("<FACEBOOK_APP_ID>");

        MRGService.service(context, serviceParams, externalSDKParams);
    }
}

// Setting
// 'this' conforms to 'IMRGSAuthenticationDelegate' protocol
MRGSAuthenticationFacebook.Instance.Delegate = this;

// Implementation
// The method that is called when the user has logged out of the social network remotely, or his session has ended.
public void OnAuthenticationProviderDidLogoutUser(MRGSAuthentication provider, MRGSAuthenticationUser user){
    Debug.Log("MRGSAuthentication<Unity> - OnAuthenticationProviderDidLogoutUser: " + user + "\nNetwork: " + provider.SocialId().ToString());
}

// Setting
[MRGSAuthenticationFacebook sharedInstance].delegate = self;

// Implementation
// The method that is called when the user remotely logs out of the social network, or his session ends.
- (void)authenticationProvider:(id<MRGSAuthentication>)provider didLogoutUser:(MRGSAuthenticationUser *)user{
    NSLog(@"User did logout: \n%@", user);
}
// The method that is called when the controller needs to be displayed to authorize the user.
- (void)shouldPresentAuthorizationController:(UIViewController *)viewController {
    UIViewController *rootVC = [UIApplication sharedApplication].keyWindow.rootViewController;
    [rootVC presentViewController:viewController animated:YES completion:nil];
}

import androidx.annotation.NonNull;

import games.my.mrgs.authentication.MRGSAuthentication.OnExternalLogoutListener;
import games.my.mrgs.authentication.MRGSAuthenticationNetwork;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

// Set a listener
MRGSFacebook.getInstance().setOnExternalLogoutListener(new OnExternalLogoutListener() {
    @Override
    public void onUserLogout(@NonNull MRGSAuthenticationNetwork network) {
        // Handel result.
    }
});

bool isLoggedIn = MRGSAuthenticationFacebook.Instance.IsLoggedIn();

BOOL isLoggedIn = [[MRGSAuthenticationFacebook sharedInstance] isLoggedIn];

import games.my.mrgs.authentication.facebook.MRGSFacebook;

final boolean isLoggedIn = MRGSFacebook.getInstance().isLoggedIn();

// If error occured, error object will be non-null
MRGSAuthenticationFacebook.Instance.Login((MRGSError error) => {
    if (error == null) {
        // Auth success
    } 
});

// The response will include an object describing the user and the token, and an error object, if any.
MRGSAuthenticationFacebook.Instance.Login((MRGSAuthenticationCredential credentials, MRGSError error) => {
    Debug.Log("MRGSAuthenticationFacebook:\nCredentials: " + credentials + "\nError:\n" + error);
    if (error == null) {
        // Auth success
    }
});

// Only the object of the error will come in the answer, if it happened
[[MRGSAuthenticationFacebook sharedInstance] login:^(NSError *error) {
    if (!error) {
        // Auth success
    }
}];

// The response will contain an object describing the user and the token, and the object of the error if it happened
[[MRGSAuthenticationFacebook sharedInstance] loginWithCompletionHandler:^(MRGSAuthenticationCredential *credentials, NSError *error) {
    NSLog(@"Result - %@. Error - %@", credentials, error);
    if (!error) {
        // Auth success
    }
}];

import android.app.Activity;

import androidx.annotation.NonNull;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSCredentials;
import games.my.mrgs.authentication.MRGSLoginCallback;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

MRGSFacebook.getInstance().login(activity, new MRGSLoginCallback() {
    @Override
    public void onSuccess(@NonNull MRGSCredentials credentials) {
        // Handle result.
    }

    @Override
    public void onError(@NonNull MRGSError error) {
        // Handle error.
    }
});

* Email - MRGSAuthenticationFacebook.Scopes.Email
* Access Friends List - MRGSAuthenticationFacebook.Scopes.UserFriends
* Access to the user's birthday - MRGSAuthenticationFacebook.Scopes.UserBirthday
* Access to user gender - MRGSAuthenticationFacebook.Scopes.UserGender
* Access to user's hometown -MRGSAuthenticationFacebook.Scopes.UserHometown
* Access to the user's location (indicated in the profile) - MRGSAuthenticationFacebook.Scopes.UserLocation

* Email - kMRGSAuthenticationFacebookScopeEmail
* Access Friends List - kMRGSAuthenticationFacebookScopeFriends
* Access to the user’s description "about yourself" - kMRGSAuthenticationFacebookScopeUserAboutMe
* Access to the user's birthday - kMRGSAuthenticationFacebookScopeBirthday
* Access to user gender - kMRGSAuthenticationFacebookScopeGender
* Access to user's hometown - kMRGSAuthenticationFacebookScopeHometown
* Access to the user's location (indicated in the profile) - kMRGSAuthenticationFacebookScopeLocation

* Email - "email"
* Access to friends list - "user_friends"
* Access to the user’s description "about yourself" - "public_profile"
* Access to the user's birthday - "user_birthday"
* Access to user gender - "user_gender"
* Access to the user's hometown - "user_hometown"
* Access to the user's location (indicated in the profile) - "user_location"

var scopes = new List<string>();
scopes.Add(MRGSAuthenticationFacebook.Scopes.Email);
scopes.Add(MRGSAuthenticationFacebook.Scopes.UserFriends);
scopes.Add(MRGSAuthenticationFacebook.Scopes.UserBirthday);
scopes.Add(MRGSAuthenticationFacebook.Scopes.UserGender);
scopes.Add(MRGSAuthenticationFacebook.Scopes.UserHometown);
scopes.Add(MRGSAuthenticationFacebook.Scopes.UserLocation);

MRGSAuthenticationFacebook.Instance.Login(scopes, (MRGSAuthenticationCredential credentials, MRGSError error) => {
    Debug.Log("MRGSAuthenticationFacebook:\nCredentials: " + credentials + "\nError:\n" + error);
    if (error == null) {
        // Auth success
    }
});

NSArray* scopesToRequest = @[kMRGSAuthenticationFacebookScopeEmail,kMRGSAuthenticationFacebookScopeFriends,kMRGSAuthenticationFacebookScopeUserAboutMe,kMRGSAuthenticationFacebookScopeBirthday,kMRGSAuthenticationFacebookScopeGender,kMRGSAuthenticationFacebookScopeHometown,kMRGSAuthenticationFacebookScopeLocation];
[[MRGSAuthenticationFacebook sharedInstance] loginWithScopes:scopesToRequest completionHandler:^(MRGSAuthenticationCredential *credentials, NSError *error) {
    NSLog(@"Result - %@. Error - %@", credentials, error);
}];

import android.app.Activity;

import androidx.annotation.NonNull;

import java.util.Arrays;
import java.util.List;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSCredentials;
import games.my.mrgs.authentication.MRGSLoginCallback;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

final List<String> scopes = Arrays.asList("email", "user_friends", "user_birthday");
MRGSFacebook.getInstance().login(activity, scopes, new MRGSLoginCallback() {
    @Override
    public void onSuccess(@NonNull MRGSCredentials credentials) {
        // Handle result
    }

    @Override
    public void onError(@NonNull MRGSError error) {
        // Handle error.
    }
});

// The information about the user, identifier, name, email, etc.
MRGSAuthenticationFacebook.Instance.GetCurrentUser((MRGSAuthenticationUser user, MRGSError error) => {
    Debug.Log("MRGSAuthenticationFacebook:\User: " + user + "\nError:\n" + error);
    if (error == null) {
        // Work with user data
    }
});

// Information about the token, lifetime, etc.
MRGSAuthenticationFacebook.Instance.GetAccessToken((MRGSAuthenticationAccessToken token, MRGSError error) => {
    Debug.Log("MRGSAuthenticationFacebook:\Token: " + token + "\nError:\n" + error);
    if (error == null) {
        // Work with token info
    }
    else if (error.Code == (int)MRGSAuthenticationErrorCode.ConnectionFailed)
    {
        // No network, try later     
    }
    else
    {
        // Logout user from app (MRGS will logout automatically in SDK)
    }
});

// An object is returned that combines information about the user (identifier, name, email, etc.) and about the token.
[[MRGSAuthenticationFacebook sharedInstance] getCredentials:^(MRGSAuthenticationCredential *credentials, NSError *error) {
    NSLog(@"Result - %@. Error - %@", credentials, error);
    if(!error){
        // Credentials data work
    }
}];

// User information - identifier, name, email, etc.
[[MRGSAuthenticationFacebook sharedInstance] getCurrentUser:^(MRGSAuthenticationUser *user, NSError *error) {
    NSLog(@"User - %@. Error - %@", user, error);
    if(!error){
        // User data work
    }
}];

// Information about the token - lifetime, etc. 
[[MRGSAuthenticationFacebook sharedInstance] getAccessToken:^(MRGSAuthenticationAccessToken *token, NSError *error) {
    if (!error) {
        NSLog(@"getAccessToken result - %@", token);
    } else {
        NSLog(@"getAccessToken error - %@", error);
    }
}];

import android.util.Log;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSAccessToken;
import games.my.mrgs.authentication.MRGSAuthentication;
import games.my.mrgs.authentication.MRGSUser;
import games.my.mrgs.authentication.facebook.MRGSFacebook;
import games.my.mrgs.utils.optional.BiConsumer;

// Returns user's information.
MRGSFacebook.getInstance().getCurrentUser(new MRGSAuthentication.UserCallback() {
    @Override
    public void onSuccess(@NonNull final MRGSUser user) {
    }

    @Override
    public void onError(@NonNull MRGSError error) {
    }
});

// Returns authentication's information.
MRGSFacebook.getInstance().getAccessToken(new BiConsumer<MRGSAccessToken, MRGSError>() {
    @Override
    public void accept(@Nullable MRGSAccessToken accessToken, @Nullable MRGSError error) {
        if (error != null) {
            Log.d("MRGSAuthentication", "AccessToken error: " + error.getErrorText());
        } else {
            Log.d("MRGSAuthentication", "AccessToken success: " + accessToken);
        }
    }
});

MRGSAuthenticationFacebook.Instance.Logout();

[[MRGSAuthenticationFacebook sharedInstance] logout];

import games.my.mrgs.authentication.facebook.MRGSFacebook;

MRGSFacebook.getInstance().logout();

MRGSAuthenticationFacebook.Instance.GetAvatar("required_user_id", MRGSAuthenticationPhotoSize.Small, (Texture2D avatar, MRGSError error) => {
    if(error == null){
        // Operation completed sucessfully
    }
});

[[MRGSAuthenticationFacebook sharedInstance] getAvatarForPlayerWithId: @"required_user_id" size:GKPhotoSizeSmall completionHandler:^(UIImage *image, NSError *error) {
    if(!error){
        // Operation completed successfully, work with data
    }
}];

import android.graphics.Bitmap;

import androidx.annotation.NonNull;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSAvatarCallback;
import games.my.mrgs.authentication.MRGSUser;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

// Call #getCurrentUser() to get current user.
final MRGSUser user = ...
// Get user's avatar.
MRGSFacebook.getInstance().getUserAvatar(user, new MRGSAvatarCallback() {
    @Override
    public void onSuccess(@NonNull Bitmap bitmap) {
        // Handle result.
    }

    @Override
    public void onError(@NonNull MRGSError error) {
        // Handle error.
    }
});

MRGSAuthenticationFacebook.Instance.GetFriendsIds((List<string> ids, MRGSError error) => {
    if(error == null){
        // Operation completed sucessfully
    }
});

[[MRGSAuthenticationFacebook sharedInstance] getFriendsIds:^(NSArray *ids, NSError *error) {
    if(!error){
        // Operation completed successfully
    }
}];

import androidx.annotation.NonNull;

import java.util.List;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSSocial;
import games.my.mrgs.authentication.MRGSUser;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

MRGSFacebook.getInstance().getFriends(new MRGSSocial.FriendsCallback() {
    @Override
    public void onSuccess(@NonNull List<MRGSUser> users) {
    }

    @Override
    public void onError(@NonNull MRGSError error) {
    }
});

MRGSAuthenticationFacebook.Instance.GetUser("required_user_id",(MRGSAuthenticationUser user, MRGSError error) => {
    if(error == null){
        // Operation completed sucessfully
    }
});

[[MRGSAuthenticationFacebook sharedInstance] getUserWithId:@"required_user_id" completionHandler:^(MRGSAuthenticationUser *user, NSError *error) {
    if(!error){
        // Operation completed sucessfully
    }
}];

import androidx.annotation.NonNull;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSAuthentication;
import games.my.mrgs.authentication.MRGSUser;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

MRGSFacebook.getInstance().getUserWithId("userId", new MRGSAuthentication.UserCallback() {
    @Override
    public void onSuccess(@NonNull MRGSUser user) {
    }

    @Override
    public void onError(@NonNull MRGSError error) {
    }
});

MRGSAuthenticationFacebook.Instance.GetUsers(ids,(List<MRGSAuthenticationUser> users, MRGSError error) => { 
    if(error == null){
        // Operation completed sucessfully
    }
});

[[MRGSAuthenticationFacebook sharedInstance] getUsersWithIds: @[@"required_user_id_1", @"required_user_id_2"] completionHandler:^(NSArray<MRGSAuthenticationUser*>* users, NSError *error) {
    if(!error){
        // Operation completed successfully
    }
}];

import androidx.annotation.NonNull;

import java.util.Arrays;
import java.util.List;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSSocial;
import games.my.mrgs.authentication.MRGSUser;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

MRGSFacebook.getInstance().getUsersWithId(Arrays.asList("user_id_1", "user_id_2"), new MRGSSocial.FriendsCallback() {
    @Override
    public void onSuccess(@NonNull List<MRGSUser> users) {
    }

    @Override
    public void onError(@NonNull MRGSError error) {
    }
});

var post = new MRGSAuthenticationPost();
post.Caption = "Check out our site!";
post.Link = "https://mrgs.astrum.team";

MRGSAuthenticationFacebook.Instance.ShowPostOnWallDialog(post, (MRGSError error) => {
    if(error == null){
        // Operation completed successfully
    }
});

MRGSAuthenticationPost *post = [[MRGSAuthenticationPost alloc] init];
post.caption = @"Check out MRGS site!";
post.link = @"http://mrgs.astrum.team";

[[MRGSAuthenticationFacebook sharedInstance] showPostOnWallDialog:post completionHandler:^(NSError *error) {
    if(!error){
        // Operation completed successfully
    }
}];

// Sending an invitation to join a game
var inviteIn = new MRGSAuthenticationInvite();
inviteIn.Message = @"Test invite message";
inviteIn.Title = @"Test title";

MRGSAuthenticationFacebook.Instance.SendInvite(inviteIn, (MRGSAuthenticationInvite inviteOut, MRGSError error) => {
    if(error == null){
        // Operation completed successfully
        Debug.Log("Sended invite - " + inviteOut);
    }
});

// Sending a game request
var inviteIn = new MRGSAuthenticationInvite();
inviteIn.Message = @"Test invite message";
inviteIn.Title = @"Test MRGS title";
inviteIn.Data = @"Test invite data";
inviteIn.Frictionless = true;

MRGSAuthenticationFacebook.Instance.SendGameRequest(inviteIn, (MRGSAuthenticationInvite inviteOut, MRGSError error) => {
    if(error == null){
        // Operation completed successfully
        Debug.Log("Sended game request - " + inviteOut);
    }
});

// Receiving incoming game requests to the user
MRGSAuthenticationFacebook.Instance.GetGameRequests((List<Dictionary<string, object>> requests, MRGSError error) => {
    if(error == null){
        // Operation completed successfully
        string requestsString = requests != null ? MRGS.JSON.Json.Serialize(requests.ConvertAll(x => (object)x), true) : "null";
        Debug.Log("Received requests - " + requestsString);
    }
});

// Sending an invitation to join a game
MRGSAuthenticationInvite *invite = [[MRGSAuthenticationInvite alloc] init];
invite.message = @"Test invite message";
invite.title = @"Test title";

[[MRGSAuthenticationFacebook sharedInstance] sendInvite:invite completionHandler:^(MRGSAuthenticationInvite* inviteOut,NSError *error) {
    if(!error){
        // Operation completed successfully
        NSLog(@"Sended invite - %@", inviteOut);
    }
}];

// Sending a game request
MRGSAuthenticationInvite *invite = [[MRGSAuthenticationInvite alloc] init];
invite.message = @"Test invite message";
invite.title = @"Test MRGS title";
invite.data = @"Test invite data";
invite.frictionless = YES;

[[MRGSAuthenticationFacebook sharedInstance] sendGameRequest:invite completionHandler:^(MRGSAuthenticationInvite* inviteOut, NSError *error) {
    if(!error){
        // Operation completed successfully
        NSLog(@"Sended request - %@", inviteOut);
    }
}];

// Receiving incoming game requests to the user
[[MRGSAuthenticationFacebook sharedInstance] getGameRequests:^(NSArray<NSDictionary *> *requests, NSError *error) {
    if(!error){
        // Operation completed successfully
        NSLog(@"Received requests - %@", requests);
    }           
}];

import androidx.annotation.NonNull;

import java.util.Collections;
import java.util.List;

import games.my.mrgs.MRGSError;
import games.my.mrgs.MRGSList;
import games.my.mrgs.authentication.MRGSSocial;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

// Send invite request
MRGSFacebook.getInstance().sendGameRequest("Game Request",
        "Invite message",
        true,
        Collections.singletonList(friend),
        new MRGSSocial.GameRequestResultCallback() {
            @Override
            public void onSuccess(@NonNull List<String> users) {
                // Handle result
            }

            @Override
            public void onError(@NonNull MRGSError error) {
                // Handle error
            }
        });

// Send game request
MRGSFacebook.getInstance().sendGameRequest("Game Request",
        "Game request message",
        false,
        Collections.singletonList(friend),
        new MRGSSocial.GameRequestResultCallback() {
            @Override
            public void onSuccess(@NonNull List<String> users) {
                // Handle result
            }

            @Override
            public void onError(@NonNull MRGSError error) {
                // Handle error
            }
        });

// Get games requests
MRGSFacebook.getInstance().getGameRequests(new MRGSSocial.GameRequestCallback() {
    @Override
    public void onSuccess(@NonNull final MRGSList requests) {
        // Handle result
    }

    @Override
    public void onError(@NonNull MRGSError error) {
        // Handle error
    }
});

MRGSAuthenticationFacebook.Instance.DeleteGameRequestWithId(requestId, (MRGSError error) => {
    if(error == null){
        // Operation completed sucessfully
    }
});

[[MRGSAuthenticationFacebook sharedInstance] deleteGameRequestWithId:requestId completionHandler:^(NSError *error) {
    if(!error){
        // Operation completed sucessfully
    }
}];

import androidx.annotation.NonNull;

import games.my.mrgs.MRGSError;
import games.my.mrgs.authentication.MRGSSocial;
import games.my.mrgs.authentication.facebook.MRGSFacebook;

MRGSFacebook.getInstance().deleteGameRequest(itemId, new MRGSSocial.GameRequestDeleteCallback() {
    @Override
    public void onSuccess() {
    }

    @Override
    public void onError(@NonNull MRGSError error) {
    }
});