Unity 멤버십

<activity>
  <intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.BROWSABLE" />
    <category android:name="android.intent.category.DEFAULT" />
    <!-- Signin 리다이렉트 Custom uri -->
    <data
        android:host="signin"
        android:scheme="hyplatform"/>
  </intent-filter>
</activity>

<manifest>
  <queries>
	  <!-- intent에 action은 하나만 존재할 수 있으므로 이미 다른 intent가 있다면 따로 만들어줍니다.  -->
    <intent>
      <action android:name="android.support.customtabs.action.CustomTabsService" />
    </intent>
  </queries>
</manifest>

{	
   -- 중략 --
	"BuildEnv": "prod",
  "SteamAppID": 2484250,
  "SteamIdentity": "astra-prod-10040100"
}

{
   -- 중략 --
  "BuildEnv": "qa",
  "SteamAppID": 2581010,
  "SteamIdentity": "astra-qa-10040040"
}

Hybe.Platform.Version.CurrentVersion

bool bPlatformInitialized = false; //SDK 초기화 상태 플래그

private void Awake()
{

PlatformSupervisor.Mount("dev").ContinueWithOnMainThread( task =>
{
	if(task.Result == true)
	{
    		bPlatformInitialized = true;
      
		PlatformSupervisor.SetAuthEventDelegate(OnLoginSuccess, OnLoginFailur);
		PlatformSupervisor.SetLogoutEventDelegate(OnLogoutSuccess, OnLogoutFailur);
		PlatformSupervisor.SetMessagingEventDelegate(OnMessageReceived);

#if UNITY_STANDALONE_WIN
		PlatformSupervisor.SetSteamEventDelegate(OnSteamConnected); //Steam Support
#endif

		//3. 결제 이벤트를 처리하는 IBillingAgent를 설정한다.
		BillingPlatform.RegisterBillingAgent(new ClientBillingAgent());
		
		//4. 웹뷰 Agent를 등록한다.
		PlatformSupervisor.SetWebviewAgent(new StarterWebviewAgent());
	}
	else
	{
		Debug.LogError("Platform SDK Init Failur");
		return;
	}
});

}

private void Awake()
{
           ---- 중 략 ----
    PlatformSupervisor.SetLogoutEventDelegate(OnLogoutSuccess, OnLogoutFailur);
#if UNITY_STANDALONE_WIN
    PlatformSupervisor.SetSteamEventDelegate(OnSteamConnected);
#endif
}

void SetAuthEventDelegate(Action<string> loginSuccessDelegate,
                          Action<string> loginFailurDelegate)

void SetLogoutEventDelegate(Action logoutSuccessDelegate, 
                            Action<string> logoutFailurDelegate, 
                            Action withDrawDelegate)

public void Signin(SigninMethod signinMethod, bool bEnableAutologin)

public enum SigninMethod
{
    IM,
    GOOGLE,
    APPLE,
    STEAM,
    LINE,
    X,
    FACEBOOK,
    GUEST,
}

public void OnClickGoogleLogin()
{
    PlatformSupervisor.Signin(SigninMethod.GOOGLE, false);
}

public void DoAutoLogin(Action<bool> callback)

PlatformSupervisor.DoAutoLogin((bTrying) =>
{
  // 자동 로그인을 정상 시도하는 경우
  if(bTrying)
  {
      //로그인 버튼 숨김 처리
      UpdateLoginUI(bLogined: false, bTryLogin: true);
  }
});

using Hybe.Platform.Entity;

void OnLoginSuccess(string resultJson)
{
    LoginResult res = LoginResult.FromJson(resultJson);
    Debug.Assert(res.resultCode == ResultCode.SUCCESS);

    // TODO : 수신된 로그인 정보를 이용해서 게임사의 서버 로그인 진행
}

public class LoginResult
{
    public string loginToken;
    public string imid;
    public string countryCode; // 가입시점의 국가 코드 (ex. KR, JP 등)
}

void OnLoginFailur(string resultJson)
{
    HyError error = HyError.FromJson(resultJson);

    // TODO : 로그인 에러 실패 프로세스 구현
}

public class HyError
{
    public Code code;
    public string message;
}

public enum Code
{
    UNKNOWN_ERROR = 0,
    NO_INITIALIZE = 1,
    SIGNIN_FAIL = 2, //Google/Apple Signin
    PLATFORM_LOGIN_FAIL = 3, //Platform login
    AUTO_LOGIN_FAIL = 4, //Auto login fail
    WITHDRAW_ACCOUNT = 5, //계정 탈퇴 회원
    CANCELED = 6, //취소됨
}

void OnWithDraw()
{
    // 탈퇴가 요청되었으므로 기존에 로그인 되어있던 정보를 초기화 합니다.
    // 탈퇴를 요청한 계정은 PlatformSupervisor.SignOut을 수행할 수 없기 때문에 
    // 대신 ForceSignOut 함수를 사용합니다.
    PlatformSupervisor.ForceSignOut();
    
    // TODO:
    // ex) 계정 선택 창으로 이동
}

void OnShowWebview(string url)
{
    //TODO 지정된 URL로 인게임 웹뷰를 팝업합니다.
}

void OnLogoutSuccess()
{
  //TODO : 로그 아웃 이후 프로세스를 구현한다.
  //       ex) 다른 계정 또는 서버 접속 UX를 출력한다.
}

void OnLogoutFailur(string message)
{
}

  private void OnSteamConnected(string message)
  {
      if (string.IsEmptyOrNot(message) == false)
      {
          Log($"Steam Connected, ID = {message}");
      }
      else
      {
          Log("Steam Disonnected");
      }
  }

public void OnClickCancelLogin()
{
    PlatformSupervisor.CancelSignin();
}

void OnLoginFailur(string resultJson)
{
    HyError error = HyError.FromJson(resultJson);
    if(error.message == "Login Cancel")
			Debug("로그인이 취소되었습니다");
    else
			Debug("로그인 실패");
}

async Task<string> RefreshVerifyTokenAsync()

PlatformSupervisor.RefreshVerifyTokenAsync().ContinueWith(task =>
{
    string verifyLoginToken = task.Result;
    Debug.Log($"Platform Login Refresh Token : {verifyLoginToken}");
});

public interface IWebviewAgent
{
	void CloseWebview();
  	void OnWebviewClosed();  
	void OnShowWebview(string url);
	bool OnUrlChanged(string url)
	void OnReceiveMessage(string actionJson, Action<string> callback)
	void OnReceiveConsoleMessage(string source, int line, string message)
}

void CloseWebview()

class MyWebview : IWebviewAgent
{
    // ...
    
    // 웹뷰를 닫아줍니다.
    public void Close()
    {
        // 코드 생략 ...
        
        // OnWebviewClosed 함수를 호출해줌.
        ((IWebviewAgent)this).OnWebviewClosed();
    }
    
    // ...
}

bool OnUrlChanged(string url)

void OnReceiveMessage(string actionJson, Action<string> callback)

void OnReceiveConsoleMessage(string source, int line, string message)

var webview = mainWebViewPrefab.WebView as IWebView;
if (webview != null)
{
    var Self = this;
    //3.1 URL 변경 이벤트 핸들러
    webview.UrlChanged += (sender, eventArgs) => {
        // 웹뷰 URL이 변경되는 경우
        if( ((IWebviewAgent)Self).OnUrlChanged(eventArgs.Url))
        {
            mainWebViewPrefab.Visible = false;
        }
    };

    //3.2 웹뷰 콘솔 로그 이벤트 핸들러
    // 웹뷰 console log를 WebviewAgent에게 전달한다. (옵션)
    webview.ConsoleMessageLogged += (sender, eventArgs) => {
        ((IWebviewAgent)Self).OnReceiveConsoleMessage(eventArgs.Source, eventArgs.Line, eventArgs.Message);
    };

    //3.3 웹뷰(JavaScript)에서 유니티로 이벤트 전달 시 호출되는 이벤트 핸들러
    //    WebviewAgent에게 수신한 데이터를 전달한다.
    webview.MessageEmitted += (sender, eventArgs) => {
        ((IWebviewAgent)Self).OnReceiveMessage(eventArgs.Val전ㅊue, (result) => 
        { 
            if (!string.IsNullOrEmpty(result))
            {
                (mainWebViewPrefab.WebView as IWebView)?.PostMessage(result);
            }
        });
    };
}

webViewObject.Init(
  cb: (msg) =>
  {
      //JavaScript -> Unity 이벤트 전달
      var result = ActionDelegator.Instance.RunAction(msg);
      if (string.IsNullOrEmpty(result) == false)
      {
          webViewObject.EvaluateJS($"window.unityEventHandler({result})");
      }
  },

public void ShowWebview(string url)
{
    webViewObject = (new GameObject("WebViewObject")).AddComponent<WebViewObject>();
    webViewObject.Init(
        cb: (msg) =>
        {
            //JavaScript -> Unity 이벤트 전달
            var result = ActionDelegator.Instance.RunAction(msg);
            if (string.IsNullOrEmpty(result) == false)
            {
                webViewObject.EvaluateJS($"window.unityEventHandler({result})");
            }
        },
        err: (msg) =>
        {
            HyDebug.Log(string.Format("CallOnError[{0}]", msg));
        },
        started: (msg) => { HyDebug.Log($"WebView Started : {msg}"); },
        hooked: (msg) => { HyDebug.Log($"WebView Hooked : {msg}"); },
        ld: (msg) =>
        {
            HyDebug.Log(string.Format("CallOnLoaded[{0}]", msg));
#if UNITY_EDITOR_OSX || UNITY_STANDALONE_OSX || UNITY_IOS
        // NOTE: the following js definition is required only for UIWebView; if
        // enabledWKWebView is true and runtime has WKWebView, Unity.call is defined
        // directly by the native plugin.
#if true
        var js = @"
            if (!(window.webkit && window.webkit.messageHandlers)) {
                window.Unity = {
                    call: function(msg) {
                        window.location = 'unity:' + msg;
                    }
                };
            }
        ";
#else
        // NOTE: depending on the situation, you might prefer this 'iframe' approach.
        // cf. <https://github.com/gree/unity-webview/issues/189>
        var js = @"
            if (!(window.webkit && window.webkit.messageHandlers)) {
                window.Unity = {
                    call: function(msg) {
                        var iframe = document.createElement('IFRAME');
                        iframe.setAttribute('src', 'unity:' + msg);
                        document.documentElement.appendChild(iframe);
                        iframe.parentNode.removeChild(iframe);
                        iframe = null;
                    }
                };
            }
        ";
#endif
#elif UNITY_WEBPLAYER || UNITY_WEBGL
        var js = @"
            window.Unity = {
                call:function(msg) {
                    parent.unityWebView.sendMessage('WebViewObject', msg);
                }
            };
        ";
#else
            var js = "";
#endif
        },
        enableWKWebView: true);
#if UNITY_EDITOR_OSX || UNITY_STANDALONE_OSX
webViewObject.bitmapRefreshCycle = 1;
#endif
    webViewObject.SetMargins(0, 0, 0, 0);
    webViewObject.SetVisibility(true);

    if (url.StartsWith("http"))
    {
        webViewObject.LoadURL(url.Replace(" ", "%20"));
    }
}
#endif
}

static public bool IsSteamOverlaySupport()

static public SteamInfo GetSteamInfo()

public class SteamInfo
{
  public ulong Id;
  public string Language;
  public string Currency;
}

static async Task<AgreementPayload> GetAgreementStatus()

public class AgreementPayload
{
  public bool advertising;   // 마케팅 수신 동의
  public bool adPush;        // 앱 푸시 수신 동의
  public bool adNightPush;   // 야간 푸시 수신 동의
}

async Task<AgreementPayload> UpdateAgreements(AgreementPayload agreementPayload )

async Task<HyResult<Banner[]>> PlatformSupervisor.GetBanners(string mappingId, string fallbackLanguage = null)

public readonly struct BannerContentImageInfo
{
    public readonly string key;
    public readonly string url;
    public readonly int no;
}

public readonly struct BannerContent
{
    public readonly uint bannerContentId;
    public readonly string languageCode;
    public readonly string title;
    public readonly string subTitle;
    public readonly string landingType;
    public readonly string landingUrl;
    public readonly BannerContentImageInfo[] imageInfos;
}

public readonly struct Banner
{
    public readonly uint bannerId;
    public readonly uint bannerInfoId;
    public readonly string defaultLanguageCode;
    public readonly string[] platforms;
    public readonly ulong exposureStartAt;
    public readonly ulong? exposureEndAt;
    public readonly int? exposeOrder;
    public readonly ulong createdAt;
    public readonly ulong? updatedAt;
    public readonly BannerContent content;
}

string PlatformSupervisor.GetBoardUrl(string boardId)

void SendEvent(Dictionary<string, object> clientEvent)
void SendEvent(Dictionary<string, object>[] clientEvents)

var clientEvent = new Dictionary<string, object>()
{
    ["srl"] = "external_device_id",
    ["event_name"] = "00_060_FirstLogin",
    ["external_device_id"] = "deviceUniqueId",
    ["external_device_type"] = 0,
    ["service_id"] = "100200200"
};
PlatformSupervisor.SendEvent(clientEvent);

  private void OnStart()
  {
      string location = PlatformSupervisor.GetLocationCode();
      Log($"Location = {location}");
  }

string GetUrl(string urlType, string language)

string communityUrl = PlatformSupervisor.GetUrl("homepage", "ko"); // 커뮤니티

bool SetWritableStorageDir(string dir)

PlatformSupervisor.SetWritableStorageDir(GetDownloadPath());

public static string GetDownloadPath()
    {
#if UNITY_EDITOR
        return $"{Application.dataPath}/../DownloadedAssetBundle";
#elif UNITY_STANDALONE
			return $"{LONGPATH_PREFIX}{Application.dataPath}/DownloadedAssetBundle";
#else
			return System.IO.Path.Combine(Application.persistentDataPath);
#endif
    }

void ListenReturnToGameEvent(int timeoutSecond)

void ShowReview()

private void Awake()
{
	PlatformSupervisor.Mount("dev").ContinueWithOnMainThread( task =>
	{
                -- 중 략 --
     CheckPushPermission();
	}
}

void CheckPushPermission()
{
  // 안드로이드 api level을 구한다.
  string androidInfo = SystemInfo.operatingSystem;
  int apiLevel = int.Parse(androidInfo.Substring(androidInfo.IndexOf("-") + 1, 2));
  Debug.Log("apiLevel: " + apiLevel);

  // 디바이스 api level이 33 이상이면 퍼미션 요청
  if (apiLevel >= 33 &&
      !Permission.HasUserAuthorizedPermission("android.permission.POST_NOTIFICATIONS"))
  {
      Permission.RequestUserPermission("android.permission.POST_NOTIFICATIONS");
  }
}`

Task<ConvertMemberResult> PlatformSupervisor.ConvertMember(SigninMethod method, UserBirthDay userBirthDay)

struct ConvertMemberResult
{
    public readonly bool successful;        // 정회원 전환 성공 여부
    public readonly string errorMessage;    // 실패시 애러 메시지
    public readonly string resultCode;      // 결과 코드
    public readonly string countryCode;     // 가입시점의 국가 코드 (ex. KR, JP 등)
}

Task<string> PlatformSupervisor.ShowRequireGuestBirth()

SignInTag? PlatformSupervisor.GetLastSignInTag()

public struct SignInTag
{
    // 유저의 이메일 데이터입니다. 일부 Method(GUEST 등)의 경우 이메일이 비어있을 수 있습니다.
    public string MaskedEmail { get; }
    
    // 로그인 수단 데이터입니다.
    public string Method { get; }

    
    public SigninMethod MethodEnum { get; }
}