UpdateRTRankTable

public BackendReturnObject UpdateRTRankTable(string tableName, string columnName, string rowInDate, long value);
public BackendReturnObject UpdateRTRankTable(string tableName, string columnName, string rowInDate, int value);

안내
  • 이 함수는 SDK 6.x.x 버전 이후부터 삭제 될 예정입니다.
  • 신버전 랭킹은 이 함수를 이용할 수 없습니다.
  • 구버전 랭킹을 사용하는 개발사는 신버전 랭킹의 이용을 권장합니다.
  • 구버전 SDK에서는 해당 기능을 정상적으로 이용할 수 있습니다.

파라미터

ValueTypeDescription
tableNamestring업데이트를 할 테이블명
rowIndatestring업데이트를 할 row의 inDate 값
columnNamestring업데이트를 할 column의 명
valuelong / int업데이트 할 정보

설명

데이터를 갱신하고, 실시간 랭킹에 등재합니다.

  • 실시간 랭킹으로 데이터를 갱신하기 전에 Backend.GameInfo.Insert 혹은 Backend.GameSchemaInfo.Insert 함수를 통해 실시간 랭킹에 사용할 테이블과 컬럼을 생성해야 합니다.
  • UpdateRTRankTable를 통해 update 된 값만 실시간 랭킹에 반영됩니다.
주의
  • UpdateRTRankTable 함수로 갱신되지 않은 데이터는 랭킹에 반영되지 않습니다.
  • 실시간 랭킹에는 Public 테이블을 사용할 수 없습니다. 반드시 Private 테이블을 사용해주세요.
  • 콘솔에서 랭킹을 생성한 후 갱신한 테이블의 정보만 해당 랭킹에 적용됩니다.
  • 실시간 랭킹이 하나도 생성되 있지 않을 때 갱신 요청을 보내면 에러가 발생합니다.
  • 반드시 한 개 이상의 실시간 랭킹을 콘솔에서 생성한 뒤 실시간 랭킹 갱신 함수를 사용해주세요.

Example

동기

// 비스키마 테이블
Backend.GameInfo.UpdateRTRankTable("테이블 명", "column 명", "rowIndate", 0);

// 스키마 테이블
Backend.GameSchemaInfo.UpdateRTRankTable("테이블 명", "column 명", "rowIndate", 0);

비동기

// 비스키마 테이블
Backend.GameInfo.UpdateRTRankTable( "테이블 명", "column 명", "rowIndate", 0, ( callback ) => 
{
    // 이후 처리
});

// 스키마 테이블
Backend.GameSchemaInfo.UpdateRTRankTable( "테이블 명", "column 명", "rowIndate", 0, ( callback ) => 
{
    // 이후 처리
});

SendQueue

// 비스키마 테이블
SendQueue.Enqueue(Backend.GameInfo.UpdateRTRankTable, "테이블 명", "column 명", "rowIndate", 0, ( callback ) => 
{
    // 이후 처리
});

// 스키마테이블
SendQueue.Enqueue(Backend.GameSchemaInfo.UpdateRTRankTable, "테이블 명", "column 명", "rowIndate", 0, ( callback ) => 
{
    // 이후 처리
});

ReturnCase

Success cases

갱신에 성공한 경우
statusCode : 204
message : Success

Error cases

콘솔에서 실시간 랭킹을 활성화 하지 않고 갱신 요청을 한 경우
statusCode : 403
errorCode : ForbiddenException

콘솔에서 실시간 랭킹을 생성하지 않고 갱신 요청을 한 경우
statusCode : 400
errorCode : BadRankData

콘솔에서 Public 테이블로 실시간 랭킹을 생성한 경우
statusCode : 400
errorCode : BadRankData

테이블 명 혹은 colum명이 존재하지 않는 경우
statusCode : 400
errorCode : BadRankData

한국시간(UTC+9) 4시 ~ 5시 사이에 실시간 랭킹 갱신 요청을 한 경우
statusCode : 428
errorCode : PreConditionError
message : ranking is being counted

퍼블릭테이블의 타인정보를 수정하고자 하였을 경우
statusCode : 403
errorCode : ForbiddenError
message : Forbidden gamer, 금지된 gamer

존재하지 않는 tableName인 경우
statusCode : 404
errorCode : NotFoundException
message : table not found, table을(를) 찾을 수 없습니다

비활성화 된 tableName인 경우
statusCode : 412
errorCode : PreconditionFailed
message : inactiveTable 사전 조건을 만족하지 않습니다.