시작하기

뒤끝 SDK를 다운받고 설치

뒤끝 SDK는 뒤끝 서버 서비스를 이용하기 위해 필요한 기능을 담고있습니다. Assets > Import UnityPackage > CustomPackage 메뉴를 통해 다운받은 유니티 패키지를 프로젝트에 import 합니다.
다음 SDK는 뒤끝베이스, 뒤끝리얼타임을 모두 포함하고 있습니다.

  • Backend-4.5.0-dotnet4.unitypackage  [2020-05-20]
  • Backend-4.5.0-dotnet3.unitypackage  [2020-05-20]

    애플 앱스토어에 게임을 출시하는 경우 반드시 다음 문서를 참고해주세요.
    Backend-4.1.0 버전 부터 닷넷3 지원이 종료되었습니다. 추후 추가되는 신기능은 닷넷4 버전에만 제공될 예정입니다.
    기존에 지원되던 기능들은 닷넷3 버전에도 그대로 지원 할 예정입니다.

초기화

뒤끝 SDK를 사용하기 앞서서 뒤끝 SDK를 사용하기 위해 아래 구문을 스크립트 상단에 추가합니다.

using BackEnd;

뒤끝 SDK를 사용하기 위해서 우선 Client App ID, Signature Key를 설정해야 합니다.
유니티 상단 메뉴에서 The Backend > Edit Setting를 선택합니다.

뒤끝 콘솔

Inspector 탭에 있는 화면에 뒤끝 콘솔에서 얻은 Client App IDSignature Key를 각각 입력합니다.

  • Client App ID : 게임을 구분하는 게임 고유 아이디, 뒤끝 콘솔에서 생성 된 값
  • Signature Key : 게임 데이터를 서버와 주고 받을 시 데이터를 암호화 할 때 필요한 키, 뒤끝 콘솔에서 생성 된 값
  • Package Name : Unity Project의 packageName입니다.
  • Is Develop : Unity Editor에서 테스트 환경인지 확인하는 값 (true: Editor 에서 가능 / false: Android혹은 iOS 에서만 가능)
뒤끝 콘솔

뒤끝 콘솔에는 각 Package Name과, 안드로이드 빌드를 하는 경우 구글해시키를 함께 입력합니다.

뒤끝 콘솔

뒤끝 서버를 초기화 시켜줍니다.

Initialize ( Function() callback ) -> void
Initialize ( Function(BackendReturnObject) callback ) -> void

// example
void Start()
{
    // 초기화
    // [.net4][il2cpp] 사용 시 필수 사용
    Backend.Initialize(() =>
    {
        // 초기화 성공한 경우 실행
        if (Backend.IsInitialized)
        {
            // example
            // 버전체크 -> 업데이트
        }
        // 초기화 실패한 경우 실행
        else
        {

        }
    });

    // 초기화
    // [.net3] 사용시
    Backend.Initialize(BRO =>
    {
        // 초기화 성공한 경우 실행
        if (BRO.IsSuccess())
        {
            // example
            // 버전체크 -> 업데이트
        }
        // 초기화 실패한 경우 실행
        else
        {

        }
    });
}

Error cases

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