Elevate

public BackendReturnObject Elevate();

설명

로그인한 기존 계정을 멀티 캐릭터 계정으로 전환합니다.

• 로그인 후 Backend.NeedsElevation이 true일 때 호출합니다. 이 값은 멀티 캐릭터를 사용하지 않는 프로젝트에서도 항상 true이므로, 멀티 캐릭터 프로젝트에서만 승격 분기를 작성해 주세요.
• 전환에 성공하면 전환 전의 게이머가 계정의 첫 번째 캐릭터가 되고, 그 캐릭터를 선택한 상태로 이어집니다. 따라서 전환 직후에는 Backend.IsMultiCharacterLogin이 true인 캐릭터 컨텍스트이며, 게임 정보·리더보드 등 뒤끝 베이스 기능을 바로 사용할 수 있습니다.
• 전환 직후의 세션에는 계정 권한이 없습니다. Backend.MultiCharacter.Character의 모든 함수가 statusCode 403 Forbidden caller must be account로 거부되며, 토큰을 갱신해도 동일합니다. 로그아웃 후 다시 로그인해야 Backend.IsMultiAccountLogin이 true인 계정 컨텍스트가 되어 캐릭터를 조회·생성·선택·삭제할 수 있습니다.
• 멀티 캐릭터를 사용하지 않는 프로젝트에서는 전환할 수 없습니다.

Example

동기

if (Backend.NeedsElevation)
{
    BackendReturnObject bro = Backend.BMember.Elevate();

    if (!bro.IsSuccess() || !Backend.IsMultiCharacterLogin)
    {
        Debug.LogError(bro.ToString());
        return;
    }
}

비동기

Backend.BMember.Elevate((callback) => {
    if (!callback.IsSuccess() || !Backend.IsMultiCharacterLogin)
    {
        Debug.LogError(callback.ToString());
        return;
    }
});

SendQueue

SendQueue.Enqueue(Backend.BMember.Elevate, (callback) => {
    if (!callback.IsSuccess() || !Backend.IsMultiCharacterLogin)
    {
        Debug.LogError(callback.ToString());
        return;
    }
});

ReturnCase

Success cases

계정 전환에 성공한 경우
statusCode : 200
message : Success

Elevate는 전환 전의 게이머를 계정의 첫 번째 캐릭터로 유지하고, 그 캐릭터를 선택한 상태로 세션을 이어갑니다. 성공하면 Backend.NeedsElevation이 false, Backend.IsMultiCharacterLogin이 true로 변경됩니다.

로그아웃 후 다시 로그인하면 Backend.IsMultiAccountLogin이 true인 계정 컨텍스트가 되며, GetCharacterList를 호출하면 전환 전의 닉네임과 inDate를 그대로 가진 캐릭터가 조회됩니다.

Error cases

로그인하지 않고 호출한 경우
statusCode : 400
errorCode : BadRequestException
message : Login is yet

멀티 캐릭터를 사용하지 않는 프로젝트인 경우
statusCode : 403
errorCode : ForbiddenException
message : Forbidden elevation not available for single-mode project, 금지된 elevation not available for single-mode project

캐릭터를 선택한 상태에서 호출한 경우
statusCode : 403
errorCode : ForbiddenException
message : Forbidden UnknownError, 금지된 UnknownError

이미 멀티 캐릭터 계정으로 로그인한 경우
statusCode : 404
errorCode : NotFoundException
message : _character_ gamer not found, _character_ gamer을(를) 찾을 수 없습니다