Initialize

public BackendReturnObject Initialize(bool useAsyncPoll = false, bool autoLocationToAsync = true);
public BackendReturnObject Initialize(BackendCustomSetting settings);
public void InitializeAsync(bool useAsyncPoll, bool autoLocationToAsync, Action<BackendReturnObject> callback);
public void InitializeAsync(BackendCustomSetting settings, Action<BackendReturnObject> callback);

파라미터

Value	Type	Description
useAsyncPoll	bool	비동기 함수의 콜백을 풀링 기능을 이용하여 메인 스레드에서 처리할지 여부
autoLocationToAsync	bool	국가 정보 불러오기를 비동기로 호출할 것인지, 혹은 초기화 함수 후에 호출하여 국가정보 불러오기까지 응답을 함께 받을 것인지 여부
settings	BackendCustomSetting	뒤끝 SDK를 초기화할 때 사용할 인자 값 객체
callback	Action<BackendReturnObject>	초기화 성공/실패 시 호출할 비동기 함수의 콜백 함수

useAsyncPoll

useAsyncPoll 인자를 true로 선언한 경우 반드시 유니티 특정 객체에서 Update 함수 혹은 코루틴 등을 활용하여 Backend.AsyncPoll 함수를 주기적으로 호출해야 비동기 함수의 콜백이 정상적으로 호출됩니다.

autoLocationToAsync

autoLocationToAsync를 true로 선언한 경우 초기화 함수 성공 응답 이후, InitializeAsync에 대한 callback은 Success로 리턴되고, 국가 정보 불러오기 함수가 호출됩니다.
autoLocationToAsync를 false 선언한 경우 초기화 함수 성공 응답 이후, 국가 정보 불러오기 함수를 호출하고 응답을 기다린 뒤, 두 개 모두 성공일 경우에 Success가 리턴됩니다.

자세한 내용은 콜백 함수 풀링 문서를 참고해 주세요.

BackendCustomSetting

Value	Type	Description	Default
packageName	string	게임의 패키지 네임	string.Empty
clientAppID	string	게임을 구분하는 게임 고유 아이디	string.Empty
signatureKey	string	게임 데이터를 서버와 주고받을 시 데이터를 암호화할 때 필요한 키	string.Empty
functionAuthKey	string	뒤끝 펑션을 사용할 때 인증을 위한 키	string.Empty
isAllPlatform	bool	Android 혹은 iOS 기기 이외의 다른 OS 허용 여부를 결정하는 값
해당 값이 false일 경우, Android 혹은 iOS 이외의 OS에서 서버로 접속을 시도하는 경우 오류가 리턴됩니다.	true
sendLogReport	bool	서버로 요청을 보낼 때 서버에 추가로 로그를 저장할지 결정하는 값입니다.	true
timeOutSec	uint	서버로 요청을 보냈을 때 설정한 시간(초) 동안 응답이 오지 않았을 경우 타임아웃 에러로 처리할 시간을 결정합니다.
default: 100초, 최소: 30초, 최대: 100초	100
useAsyncPoll	bool	비동기 함수의 콜백을 풀링 기능을 이용하여 메인 스레드에서 처리할지 여부	false
autoLocationToAsync를	bool	국가 정보 불러오기를 비동기로 호출할 것인지, 혹은 초기화 함수 후에 호출하여 국가정보 불러오기까지 응답을 함께 받을 것인지 여부	false

packageName이 string.Empty 인 경우 sdk를 초기화 할 때 Application.identifier 값을 사용합니다.

설명

뒤끝 SDK를 사용하기 위해서는 반드시 SDK 초기화를 수행해야 합니다.
초기화는 게임이 실행되는 동안 1회만 수행하면 됩니다.

초기화 함수의 인자 값으로 BackendCustomSetting을 넘길 경우 유니티 인스펙터 창에서 설정한 The Backend Settings의 값은 모두 무시하고, BackendCustomSettings에 정의된 값으로 SDK 초기화를 시도합니다.

The Backend Settings에 정의된 값과 BackendCustomSetting에 정의된 값을 혼용하여 사용할 수 없습니다.

Example

동기

using BackEnd;

void Start()
{
    // 첫 번째 방법(동기)
    var bro = Backend.Initialize(true,  true);
    if(bro.IsSuccess())
    {
        // 초기화 성공 시 로직
    }
    else
    {
        // 초기화 실패 시 로직
    } 
}

동기(SDK 설정값을 직접 선언)

using BackEnd;

void Start()
{
    // 두 번째 방법(동기)
    // SDK 설정값
    BackendCustomSetting settings = new BackendCustomSetting();
    settings.clientAppID = "클라이언트 앱 아이디";
    settings.signatureKey = "시그니처 키";
    settings.functionAuthKey = "뒤끝펑션 키";
    settings.isAllPlatform = true;
    settings.sendLogReport = true;
    settings.timeOutSec = 100;
    settings.useAsyncPoll = true;

    var bro = Backend.Initialize(settings);
    if(bro.IsSuccess())
    {
        // 초기화 성공 시 로직
    }
    else
    {
        // 초기화 실패 시 로직
    } 
}

비동기

using BackEnd;

void Start()
{
    // 세 번째 방법(비동기)

    // 외부쓰레드 응답을 메인쓰레드로 가져오는 로직을 활성화할 것인지 여부
    bool useAsyncPoll = true; 

    // 국가 정보 불러오기를 비동기로 별도 호출할 것인지 여부(false일 경우, 초기화 응답 이후 국가 정보 불러오기)
    bool autoLocationToAsync = true; 
    Backend.InitializeAsync(useAsyncPoll, autoLocationToAsync, callback => {
        if(callback.IsSuccess())
        {
            // 초기화 성공 시 로직
        }
        else
        {
            // 초기화 실패 시 로직
        }    
    });
}

비동기(SDK 설정값을 직접 선언)

using BackEnd;

void Start()
{
    // 네 번째 방법(비동기)
    // SDK 설정값
    BackendCustomSetting settings = new BackendCustomSetting();
    settings.clientAppID = "클라이언트 앱 아이디";
    settings.signatureKey = "시그니처 키";
    settings.functionAuthKey = "뒤끝펑션 키";
    settings.isAllPlatform = true;
    settings.sendLogReport = true;
    settings.timeOutSec = 100;
    settings.useAsyncPoll = true;
    settings.autoLocationToAsync = false; 

    Backend.InitializeAsync(settings, callback => {
        if(callback.IsSuccess())
        {
            // 초기화 성공 시 로직
        }
        else
        {
            // 초기화 실패 시 로직
        }    
    });
}

Return Cases

---

Success Case statusCode : 204
message : Success

추가로 유니티 디버그 콘솔 창에 Server setting success가 출력됩니다.

---

Error Case Client App ID 혹은 Signature Key가 잘못된 경우
statusCode : 404
errorCode : NotFoundException
message : game not found, game을(를) 찾을 수 없습니다

Client App ID 혹은 Signature Key가 null 혹은 string.Empty인 경우
statusCode : 400
errorCode : InitializeFail
message : Please Edit the Baceknd Settings