Services Core SDK API#

Services Core 패키지는 단일 호출로 모든 Unity Gaming Services를 초기화하는 솔루션을 제공하며, 여러 패키지에서 사용되는 공통 컴포넌트를 정의합니다. 이러한 표준화된 컴포넌트는 Unity Gaming Services 패키지와 작업할 때 전체적인 경험을 통합하는 것을 목표로 합니다.

UnityServices#

namespace Unity.Services.Core
{
    public static class UnityServices{}
}

이 클래스를 사용하여 현재 프로젝트에 설치된 모든 Unity Gaming Services를 초기화합니다.

InitializeAsync#

public static Task InitializeAsync(InitializationOptions options)

이 메서드는 현재 프로젝트에 설치된 모든 Unity Gaming Services를 초기화합니다. 이 메서드는 초기화 진행 상황을 모니터링할 수 있는 Task를 반환합니다.

참고: 이 메서드는 런타임 시에만 지원됩니다.

State#

public static ServicesInitializationState State

이 메서드는 런타임 시 게임의 현재 ServicesInitializationState를 반환합니다.

InitializationOptions#

namespace Unity.Services.Core 
{
    public class InitializationOptions{}
}

초기화 옵션은 고유한 SDK 초기화 사양을 용이하게 할 수 있는 키-값 스토리지 역할을 합니다. Unity Gaming Services SDK를 초기화할 때 InitializeAsync 메서드를 통해 이러한 옵션을 전달합니다.

TryGetOption#

public bool TryGetOption(string key, out bool option)
public bool TryGetOption(string key, out int option)
public bool TryGetOption(string key, out float option)
public bool TryGetOption(string key, out string option)

이 메서드는 지정된 키가 존재하면 true 를 반환하고, 존재하지 않으면 false를 반환합니다.

SetOption#

public InitializationOptions SetOption(string key, bool value)
public InitializationOptions SetOption(string key, int value)
public InitializationOptions SetOption(string key, float value)
public InitializationOptions SetOption(string key, string value)

이러한 메서드는 지정된 키의 값을 저장합니다.

초기화 예제#

다음 예제는 개발 환경 초기화 확장 기능을 사용하여 모든 서비스를 한 번에 초기화합니다.

using System;
using Unity.Services.Core;
using Unity.Services.Core.Environments;
using UnityEngine;
 
public class InitializeUGS : MonoBehaviour {
    
    public string environment = "production";
 
    async void Start() {
        try {
            var options = new InitializationOptions()
                .SetEnvironmentName(environment);
 
            await UnityServices.InitializeAsync(options);
        }
        catch (Exception exception) {
            // An error occurred during initialization.
        }
    }
}

초기화 디버깅#

Services Core 버전 1.4.2 이상에서는 디버깅 목적으로 상세 모드를 활성화할 수 있습니다. 상세 모드를 활성화하면, Services Core SDK는 모든 서비스가 공유하는 공통 구성에 대한 정보를 에디터의 콘솔에 기록합니다. 상세 모드를 활성화하려면 다음을 수행합니다.

1. Unity 에디터에서 Edit > Project Settings > Player를 선택합니다.
2. 플레이어 설정 창에서 Other Settings를 클릭합니다.
3. Script Compilation 아래에 다음 스크립팅 Define 기호를 추가합니다. ENABLE_UNITY_SERVICES_CORE_VERBOSE_LOGGING
4. Apply를 클릭합니다.

예외 유형#

ServicesInitializationException#

서비스 초기화 중 발생하는 오류에 대한 기본 예외 유형입니다.

CircularDependencyException#

등록된 두 개의 IInitializablePackage 인스턴스가 서로 종속될 때 발생하는 예외입니다. 이 오류는 설계 문제를 나타내는 경우가 많으므로 반드시 수정해야 합니다.

RequestFailedException#

요청이 실패할 때 발생하는 기본 예외 유형입니다. 각 예외는 실패 원인을 지정하는 int ErrorCode를 반환합니다.