시작하기

뒤끝 SDK를 다운받고 설치

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

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

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

뒤끝 1대1 문의 플러그인 설치하기

뒤끝 1대1 문의 플러그인은 뒤끝에서 자체 제작한 웹뷰로 게임 내에서 1대1문의창을 생성하여 유저들의 문의를 관리할 수 있는 기능을 담고 있습니다.

초기화

뒤끝 SDK를 사용하기 위해서 우선 Client App IDSignature Key를 설정해야 합니다.

Client App IDSignature Key는 뒤끝 콘솔에서 발급 받을 수 있습니다.
안드로이드, iOS 환경에서 게임을 실행시키기 위해서는 각 OS에 맞는 스토어 인증정보를 기입해야 합니다.
스토어 인증 정보 설정에 대해서는 개발자문서를 참고해주세요.

뒤끝 콘솔

뒤끝 콘솔에서 Client App ID와 Signauter Key를 발급받았으면 유니티로 돌아옵니다.
상단 링크에서 뒤끝 SDK를 정상적으로 설치했다면 유니티 상단 메뉴에 The Backend 메뉴가 추가되었을 것 입니다.
유니티 상단 메뉴에서 The Backend > Edit Setting를 선택합니다.

유니티 설정1

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

유니티 설정2
  • Client App ID : 게임을 구분하는 게임 고유 아이디.
  • Signature Key : 게임 데이터를 서버와 주고 받을 시 데이터를 암호화 할 때 필요한 키
  • Package Name : Unity Project의 packageName입니다.
  • Is All Platform : 해당 설정값은 Android 혹은 iOS 기기 이외의 다른 OS 허용여부를 결정하는 값입니다.
    해당 값이 체크되어 있지 않은 경우, Android 혹은 iOS 이외의 OS에서 접속하는 경우 서버에서 오류를 리턴합니다.

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

using BackEnd;

뒤끝 서버를 초기화 시켜줍니다.
초기화는 게임이 실행되는 동안 1회만 수행하면 됩니다.

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을(를) 찾을 수 없습니다