2013년 6월 4일 화요일

Makefile 설명

개발을 진행하다보면, Makefile 을 작성하거나 수정해야 할 경우가 참 많다.
언제까지 다른 사람에게 의존할 수 없기에!
이참에 공부!!!

http://nicklib.com/library/make/Make.html

2011년 3월 31일 목요일

WorldRanking Service API Guide(LaunchWorldRanking Class)


class LaunchWorldRanking

description : 랭킹 확인을 위해 WorldRanking Application 을 구동하기 위한 클래스입니다. Object 를 생성하시는 동시에 랭킹 어플이 구동되도록 구현하였습니다.


constructors
public LaunchWorldRanking(Context context);
 ; 기본적인 생성자 입니다. 디폴트 설정은 아래와 같습니다
   내림차순, 기본모드, 기본스테이지, 1등 ~ 100등

public LaunchWorldRanking(Context context, QueryOption option);
 ; 원하시는 QueryOption 을 설정할 수 있습니다.

Usage

new LaunchWorldRanking(this);
 ; Activity 등에서 사용하시면 됩니다.

new LaunchWorldRanking(mContext);
 ;  Context 를 상속하지 않은 클래스들은 보통 맴버로 가지고 있다가 이와 같이 사용하게 됩니다.

new LaunchWorldRanking(this, option);
 ; 특정 option 을 가지고, 랭킹 app 을 구동합니다.

WorldRanking Service API Guide(QueryOption Class)



class QueryOption

description : 결과를 확인하기위한 옵션을 설정하는 Class 입니다. LaunchWorldRanking Class 와 함께 사용되어 집니다.

constructors

public QueryOption();
 ; 가장 간단한 생성자로, 자동으로 내림차순 정렬, 기본 모드, 기본 스테이지로 설정됩니다.
public QueryOption(String kind);
 ; 오름차순 내림차순을 설정하고자 할때 사용되어집니다.
public QueryOption(String kind, String mode, String stage);
 ; 특정 모드, 특정 스테이지의 순위를 확인하고자 할때 사용하시면 됩니다.
public QueryOption(String kind, String mode, String stage, String start, String end);
 ; 1등부터가 아닌, 사용자 주위의 순위를 보여주고자 할때, 시작등수와, 끝 등수를 설정 할 수 있습니다. (아직 검증중입니다.;; )

attributes


KIND_ASC ;  오름차순 정렬
KIND_DESC : 내림차순 정렬


Usage


QueryOption option = new QueryOption();
 ; 내림차순 정렬, 기본 모드("normal"), 기본스테이지("stage"), 1등~100 등까지의 결과를 요청하기 위한 옵션입니다.


QueryOption option = new QueryOption(QueryOption.KIND_ASC);
 ; 오름차순 정렬로 설정하고 나머지는 같습니다.


QueryOption option = new QueryOption(QueryOption.KIND_ASC, "hardcore", "5");
 ; 오름차순 정렬, hardcore  모드, 5 스테이지의 순위즐 1등에서 100등까지 확인하기 위한 옵션입니다.

2011년 3월 23일 수요일

WorldRanking Service API Guide(RankCallback Class)

interface RankCallback

: AddRank 를 실행하고, 이에 대한 결과로 등록된 Rank 객체와 실제 서버에서의 순위가 포함되어 전달됩니다.

Methods

public void onParserCompleted(ArrayList<Rank> ranks);
 ; AddRank 가 성공적으로 마무리 되면, ranks 객채에 Rank List 가 전달됩니다.

Sample Code

public class SampleGame extends Activity implements RankCallback {
    @Overrides
    public void onParserCompleted(ArrayList<Rank> ranks) {
        Log.e("SampleGame", "ranks count = " + ranks.size());
    }
}

WorldRanking Service API Guide(AddRank Class)

class AddRank

description ; Rank 객채를 통해서 서버에 득점( 혹은 시간등) 을 등록하는 클래스입니다.

constructors

public AddRank(Context context);
 ; Rank 를 등록하고 callback 을 받을 필요가 없을때 사용합니다. Rank 의 등록은 Async 로 동작합니다.
public AddRank(Context context, RankCallback callback);
 ; Rank 를 등록하고, 등록여부와 Ranking 을 확인하기 위해 callback 을 등록합니다.
public AddRank(Context context, RankCallback callback, boolean dialog);
 ; Async 로 동작하는 등록 절차동안 Dialog 를 띄워서 사용자에게 알려줍니다.

Methods

public int run(Rank rank);
 ; 인자로 전달된 rank 객채의 정보를 서버로 전송합니다. 기본적으로 위치 정보를 획득하여 함께 전송합니다.
public int run(Rank rank, boolean use_loc);
 ; 위치 정보 사용 여부를 설정 할 수 있습니다. 가급적 위치 정보를 사용하기를 권장합니다.

Return Values

Rank.ERROR_NONE(0) ; 정상적입니다.
Rank.ERROR_LOCATION_SERVICE_DISABLED(-1) ; 위치정보가 비활성화 되어 정보 전송이 실패했습니다. 사용자에게 위치정보를 사용하도록 유도하거나, 위치정보를 사용하지 않도록 하여 재 전송합니다.
Rank.ERROR_VALUE_IS_NOT_DEFINED(-2) ; 전달된 Rank 객채에 Value 가 정상적으로 설정되지 않은 경우입니다.
Rank.ERROR_VALUE_RANK_IS_NULL(-3) ; Rank 객체가 전달되지 않은 경우입니다.

WorldRanking Service API Guide(Rank Class)

class Rank

description : 순위 정보를 포함하는 Class 입니다.

constructors

public Rank();
 ; 사용하지 마세요 ^^;;
public Rank(String name, String value);
 ; 가장 간단한 생성자로, 이름과 값만을 설정합니다.
public Rank(String name, String value, String kind);
 ; 이름과 값과, 해당 값이 오름차순으로 정렬되는지, 내림차순으로 정렬되는지 설정합니다.
public Rank(String name, String value, String kind, String mode, String stage);
 ; 복잡한 게임의 경우, 모드에 따른 랭킹, 스테지별 랭킹을 지원하기 위한 생성자 입니다.

Method

public String getRanking();
 ; AddRank 의 RankCallback 등을 통해 얻은 Rank 에서 해당 Rank 의 Ranking 을 얻기 위해 사용됩니다. 즉, Rank 를 등록하고 난 후 Ranking 을 사용자에게 보여주려 할때 사용됩니다.


attributes

KIND_ASC ;  오름차순 정렬
KIND_DESC : 내림차순 정렬

Usage

Rank rank = new Rank("홍길동" ,"1023");
 ; 기본모드(normal) 기본스테이지(stage) 에서 "홍길동"이 1023점을 기록했습니다. Callback 으로 넘어오는 순위는 내림차순을 사용합니다.

Rank rank = new Rank("홍길동", "1023", Rank.ASC);
 ; 위와 같지만, Callback 으로 넘어오는 순위는 오름차순을 사용합니다.


Rank rank = new Rank("홍길동", "1011", Rank.DESC, "easy", "1");
 ; 특정 모드와, 스테이지 정보를 추가합니다. 

WorldRanking Service

안녕하세요.  DOTOne 입니다.

World Ranking 뿐 아니라 각 Ranker 들의 실제 위치를 알려주는 기능을 포함하고 있는 WorldRanking 서비스 입니다.

본 서비스는 평생 무료로 제공되며, 현재는 별도의 등록절차 없이, Library 를 마음껏 사용 하실 수 있습니다!

WorldRanking Service 를 사용하는 방법입니다.( Sample Code 받기 )

1. Library 를 Project 에 첨부합니다. ( 라이브러리 다운로드 )

2. Rank 정보를 서버로 전송합니다.

3. WorldRanking App 을 구동하여 Ranking 을 확인합니다.


Rank 정보를 서버로 전송하는 Sample 코드는 아래와 같습니다.

Rank rank = new Rank( "name" , "score" );
AddRank add = new AddRank(context, callback);
add.run(rank);

WorldRanking App 을 구동하는 Sample 코드는 아래와 같습니다.


new LaunchWorldRanking(context);

자세한 API 설명은 차차 추가하도록 하겠습니다!

많은 이용 바랍니다!