시스템 정보

앱인토스 플랫폼에서 제공하는 기기, 환경, 네트워크 등의 시스템 정보를 조회하는 API예요.
모든 API는 async/await 패턴으로 동작해요.

---

API

API	반환 타입	설명
AIT.GetDeviceId()	string	기기 고유 식별자
AIT.GetLocale()	string	사용자 로케일 (예: ko-KR)
AIT.GetNetworkStatus()	NetworkStatus	네트워크 상태
AIT.GetOperationalEnvironment()	string	운영 환경 (toss 또는 sandbox)
AIT.GetPlatformOS()	string	플랫폼 OS (예: iOS, Android)
AIT.GetSchemeUri()	string	화면 진입 시 스킴 URI
AIT.GetServerTime()	double?	서버 시간 (Unix timestamp ms)
AIT.GetTossAppVersion()	string	토스 앱 버전

---

사용 예제

기기 정보 조회

using AppsInToss;
using UnityEngine;

public class SystemInfoExample : MonoBehaviour
{
    async void Start()
    {
        try
        {
            string deviceId = await AIT.GetDeviceId();
            Debug.Log($"Device ID: {deviceId}");

            string platform = await AIT.GetPlatformOS();
            Debug.Log($"Platform: {platform}");

            string locale = await AIT.GetLocale();
            Debug.Log($"Locale: {locale}");

            string tossVersion = await AIT.GetTossAppVersion();
            Debug.Log($"Toss App Version: {tossVersion}");
        }
        catch (AITException ex)
        {
            Debug.LogError($"시스템 정보 조회 실패: {ex.ErrorCode} - {ex.Message}");
        }
    }
}

환경 및 네트워크 확인

using AppsInToss;
using UnityEngine;

public class EnvironmentCheck : MonoBehaviour
{
    async void Start()
    {
        try
        {
            // 운영 환경 확인
            string env = await AIT.GetOperationalEnvironment();
            if (env == "sandbox")
            {
                Debug.Log("샌드박스 환경에서 실행 중이에요");
            }

            // 네트워크 상태 확인
            NetworkStatus network = await AIT.GetNetworkStatus();
            Debug.Log($"Network: {network}");
        }
        catch (AITException ex)
        {
            Debug.LogError($"환경 확인 실패: {ex.Message}");
        }
    }
}

서버 시간 조회

using AppsInToss;
using UnityEngine;

public class ServerTimeExample : MonoBehaviour
{
    async void Start()
    {
        try
        {
            double? serverTime = await AIT.GetServerTime();
            if (serverTime.HasValue)
            {
                var dateTime = DateTimeOffset.FromUnixTimeMilliseconds((long)serverTime.Value);
                Debug.Log($"서버 시간: {dateTime}");
            }
        }
        catch (AITException ex)
        {
            Debug.LogError($"서버 시간 조회 실패: {ex.Message}");
        }
    }
}

스킴 URI 확인

딥링크 등으로 미니앱에 진입했을 때 스킴 URI를 확인할 수 있어요.

using AppsInToss;
using UnityEngine;

public class SchemeExample : MonoBehaviour
{
    async void Start()
    {
        try
        {
            string schemeUri = await AIT.GetSchemeUri();
            if (!string.IsNullOrEmpty(schemeUri))
            {
                Debug.Log($"스킴 URI: {schemeUri}");
                // 스킴에 따라 화면 분기 처리
            }
        }
        catch (AITException ex)
        {
            Debug.LogError($"스킴 URI 조회 실패: {ex.Message}");
        }
    }
}

---

주의사항

TIP

• 모든 API는 WebGL 빌드에서만 실제로 동작해요. Unity Editor에서는 Mock 값을 반환해요.
• GetServerTime()은 지원하지 않는 버전에서 null을 반환할 수 있어요.
• GetOperationalEnvironment()로 샌드박스/프로덕션 환경을 구분할 수 있어요.