Com.phantomsxr.xrmodgameservices NPM

XRMOD Game Services

Take your game to the next level without having to worry about maintaining or scaling your back-end infrastructure. XRMOD-GS simplifies many game development tasks and challenges.

TOC(#authentication)
Voice
Leaderboard
Cloud Save

You must add LOCATION_CHINA to defines when you in China and installed our custom UGS packages.
Authentication

How to use?

if using it with special platform: Apple/Google/Meta etc, you must add define for you Unity Project.

About Credential

[System.Serializable]
public class Credential
{
    public string Token;
    public string Name;
    public string Email;
    public string AvatarUrl;
}

Apple platform has not provide avatar, so avatar url will empty.
SignIn
Custom UserName with Password

Method

 public static void SignInUserNameWithPassword(String _userName,String _pwd);
 public static void SignUpUserNameWithPassword(String _userName,String _pwd);
 public static void UpdateUserNamePassword(String _userName,String _pwd);

Example

 AuthenticationManager.SignUpUserNameWithPassword("XRMODUser","XRMOD@User");
 AuthenticationManager.SignInUserNameWithPassword("XRMODUser","XRMOD@User");
 AuthenticationManager.UpdateUserNamePassword("XRMODUser","XRMOD@User");

Apple platform

Add USE_APPLE_AUTHENTICATION to your project setting
Call AuthenticationManager.SignInWithApple to signin

Method

 public static void SignInWithApple(Action<Credential> _signSuccess = null,Action<string> _signFailed = null);

Example

AuthenticationManager.SignInWithApple(_credential=>{},Debug.LogError);

Google platform

Add USE_Google_AUTHENTICATION to your project setting
Call AuthenticationManager.SignInWithGoogle to signin

Method

 public static void SignInWithGoogle(Action<Credential> _signSuccess = null,Action<string> _signFailed = null);

Example

AuthenticationManager.SignInWithGoogle(_credential=>{},Debug.LogError);

Meta platform

Add USE_META_AUTHENTICATION to your project setting
Call AuthenticationManager.SignInWithMeta to signin

Method

 public static void SignInWithMeta(Action<Credential> _signSuccess = null,Action<string> _signFailed = null);

Example

AuthenticationManager.SignInWithMeta(_credential=>{},Debug.LogError);

SignInWithAnonymous

Method

public static async Task SignInWithAnonymous()

Example

AuthenticationManager.SignInWithAnonymous();

SignOut

Nothing special needs to be done, just call AuthenticationManager.SignOut()

GetUserInfo

Nothing special needs to be done, just call AuthenticationManager.GetUserInfo()

SignIn or Authorize State

Nothing special needs to be done, just call

AuthenticationManager.IsSignedIn
AuthenticationManager.IsAuthorized
AuthenticationManager.IsExpired

Voice

With Voice as your communication platform, you can offer cross-platform communications to your players and scale seamlessly as you grow.

How to use?

You must Add USE_XXXX define to your project config of Unity. And must installed Authentication System.

Vivox -> USE_VIVOX
Agora -> USE_AGORA_RTC
PHOTON -> USE_PHOTON_VOICE

Event Callback

You can register event callbacks with ActionNotificationCenter and use the VoiceEventKey in NotificationData to identify the event type.

ActionNotificationCenter.DefaultCenter.AddObserver(OnVoiceEvent, VoiceModuleNotifyActionKey.CONST_VOICE_EVENT_KEY);
Convert BaseNotificationData to voiceNotificationDataArgs in OnVoiceEvent function.

Example

void Start(){
    ActionNotificationCenter.DefaultCenter.AddObserver(OnVoiceEvent,
  VoiceModuleNotifyActionKey.CONST_VOICE_EVENT_KEY);
}

void OnVoiceEvent(BaseNotificationData _data){
 if (_data is VoiceNotificationDataArgs tmp_VoiceNotification){
       switch (tmp_VoiceNotification.VoiceEventKey){
            //....    
       }
 }    
}