dpush » joytune

DPUSH를 사용한 미니그룹웨어

joytune — Wed, 29 Jul 2015 07:58:41 +0000

DPUSH를 적용해서 인트라넷을 구성한 사례입니다.
사전에 해당 업체의 임직원분들의 양해를 구해서 올리는 내용입니다.
FeelCommunications 임직원분들께 감사드립니다. ^^

PC 브라우저와 안드로이드 어플에 동시에 푸시가 가능한 서비스 모델을 보여주고 있습니다.

안드로이드 채팅 샘플

joytune — Wed, 22 Apr 2015 10:31:42 +0000

안녕하세요. 오늘은 새로운 안드로이드 채팅 샘플에 대해 포스팅합니다.
앞서 소개했던 javascript 채팅과 연동되어 브라우저와 같이 채팅이 가능하며 샘플 코드임으로 약간의 버그(?)는 있을 수 있습니다.
먼저 발급받은 PRODUCTKEY 설정메뉴에서 “Customer Info사용 체크” 와 “클라이언트 메시지 체크”를 하는 것이 중요합니다. ^^
버그에 대한 부분은 제보해주시면 정말 감사하겠습니다. 기본 샘플만 있고 소스가 함께 오픈되니 알맞게 수정해서 사용하시면 됩니다.

1. DPUSH를 이용한 안드로이드 채팅 샘플 만들기

1.1 샘플 어플의 내용

본 문서는 DPUSH 기반 안드로이드 채팅앱에 대해 설명합니다.

본 채팅앱은 사용자 로그인 후, 텍스트 메시지를 교환하는 기본적인 채팅 기능을 지원합니다. 또한, Product key 변경을 통해 채팅방 변경이 가능합니다.

“디푸시안드로이드” 라는 아이디로 로그인한 상태에서 메시지를 주고 받는 기능을 제공합니다.

Product key을 설정/변경하는 기능을 제공합니다.

로그인 정보(아이디, 나이, 성별)를 입력/변경하는 기능을 제공합니다.

해당 어플은 스토어에서 DPUSH로 검색하면 받을 수 있으며 스토어 주소는 다음과 같습니다.

https://play.google.com/store/apps/details?id=kr.co.joytune.dpchat

2. Android 채팅 앱 중요 설명

2.1 앱 구조

전체 소스를 참고하시기 바라며, 기본적으로 필요한 중요한 내용만을 설명합니다.

채팅앱은 아래와 같이 3개의 Activity들로 구성됩니다.

Activity 이름	내용
DPushActivity	채팅의 메인 Activity로서 메시지를 입력받고 수신된 메시지를 보여주는 기능을 수행합니다. 실제 화면 구성 및 메시지 통신은 DPushMainFragment 클래스에서 수행합니다.
DPushProdKeyCheck	Product key를 설정/변경하는 기능을 제공합니다. 설정된 key는 다음번 앱 수행시에도 그대로 적용됩니다.
DPushLogin	로그인 정보를 받아 서버 접속을 기능을 제공합니다.

2.2 메인 액티비티 (DPushActivity)

DPushActivity는 크게 아래와 같은 기능들을 수행합니다.

번호	기능	수행 클래스
1	Product key 설정/변경 및 서버 접속	DPushMainFragment
2	Login 정보 설정 및 변경	DPushMainFragment
3	메시지 수신 및 화면 출력	DPushMainFragment
4	사용자 메시지를 서버로 전송	DPushMainFragment
5	다른 사용자의 로그인/로그아웃/정보 변경 내용을 공지	DPushMainFragment
6	채팅방에 접속된 사용자들의 목록을 출력	DPushMainFragment
7	스마트폰이 Sleep Mode일 경우에도 메시지 수신	DPushActivity

2.2.1 Product key 설정 및 변경

앱 수행시 이미 저장된 키가 있으면 그것을 사용하고 그렇지 않으면 Default값인 “LIVEDEMOPUSH” 값을 사용합니다.

public void onCreate(Bundle savedInstanceState) {
......
		// 이전에 설정된 Product key를 찾는다.
		SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE);
		mProdKey = sharedPref.getString("PRODUCT_KEY", "LIVEDEMODPUSH");
......
}

설정된 Product key를 가지고 서버에 접속합니다.

private void connectDPClient() {
		if (client != null) {
			client.close();
			client = null;
			gi = null;
		}

		mProdKeyChecked = false;

		DPOptions dpopts = new DPOptions();
		dpopts.setResultcallback(actionOnConnect(mHandler));

		client = new DPClient(mProdKey, dpopts) {

			public void onConnected() {
				Log.d(TAG, "onconnected................");
			}

			public void onDisconnected() {
				Log.d(TAG, "onDisconnected................");
				if (!client.isConnected()) connect();
			}
		};

		client.connect();

서버와 연결이 정상적으로 수행되면 다음번에 동일한 Product key를 사용하기 위해 Activity 저장영역에 Key를 저장합니다.

mHandler = new Handler() {
public void handleMessage(android.os.Message msg) {
	switch (msg.what) {
		case ACTION_ON_CONNECT:
			b = msg.getData();
			String errMessage = b.getString("errmessage");
			if (errMessage.isEmpty()) {
				// Product key를 store한다
			    SharedPreferences sharedPref = 
getActivity().getPreferences(Context.MODE_PRIVATE);
				SharedPreferences.Editor editor = sharedPref.edit();
				editor.putString("PRODUCT_KEY", mProdKey);
				editor.commit();

				startSignIn();
			}
		}
	};
};

2.2.2 Login 정보 설정 및 변경

	// Login 정보 설정을 위해 Login 창을 띄운다.
	private void startSignIn() {
		mUsername = "";
		Intent intent = new Intent(getActivity(), DPushLogin.class);
		intent.putExtra("requestcode", REQUEST_LOGIN);
		startActivityForResult(intent, REQUEST_LOGIN);
	}
	
	// Login 정보 변경을 위해 Login 창을 띄운다.
	private void startUpdateUserinfo() {
		Intent intent = new Intent(getActivity(), DPushLogin.class);
		intent.putExtra("username", mUsername);
		intent.putExtra("userage", "" + mUserage);
		intent.putExtra("usergender", "" + mUsergender);
		intent.putExtra("requestcode", REQUEST_UPDATE_USERINFO);
		startActivityForResult(intent, REQUEST_UPDATE_USERINFO);
	}

로그인 창 Activity인 DPushActivity를 통해 받은 로그인 정보를 사용하여 Group을 오픈합니다.

public void performOpenGroup() {
       . . . . . .
		// 그룹을 오픈한다
		else {
			GroupOptions gpopts = new GroupOptions();
			gpopts.setCustevent(true);
			gpopts.setSendevent(true);

			JSONObject cinfo = new JSONObject();
			try {
				cinfo.put("nickname", mUsername);
				cinfo.put("age", mUserage);
				if ("1".equals(mUsergender)) cinfo.put("gender", "M");
				else if ("2".equals(mUsergender)) cinfo.put("gender", "F");
				else cinfo.put("gender", "P");
			}
			catch (Exception e) {
				e.printStackTrace();
			}
			gpopts.setCustinfo(cinfo);

			gi = client.openGroup(GRP_ID, gpopts, null);
			// 메시지가 수신될때 수행되는 callback 함수 등록
			gi.onReceive(ACT_ID, action(mHandler));
			// Group 오픈 요청에 대한 결과를 처리하는 callback 함수 등록
			gi.setCallback(actionOnGroupOpened(mHandler));
			// 채팅방에 사용자가 들어올때 수행되는 callback 함수 등록
			gi.setOnUserIn(actionOnUserIn(mHandler));
			// 채팅방에서 사용자가 나갈때 수행되는 callback 함수 등록
			gi.setOnUserOut(actionOnUserOut(mHandler));
			// 채팅방내 사용자정보가 변경될때 수행되는 callback 함수 등록
			gi.setOnUserUpdated(actionOnUserUpdated(mHandler));
		}
	}

2.2.3 메시지 수신 및 화면 출력

(2)에서 메시지가 수신될 때 호출되는 “action()” callback 함수를 통해 수신된 메시지를 화면에 출력합니다.

private static Callback action(final Handler handler) {
		return new Callback() {
			@Override
			public void call(Object... args) {
				String message = (String) args[0];
				JSONObject custInfo = (JSONObject) args[2];
				String nickname;
				try {
					nickname = custInfo.getString("nickname");
				}
				catch (JSONException e) {
					return;
				}

				Message msg = Message.obtain(null, ACTION_SHOW_TEXTMESSAGE, 0, 0);
				Bundle b = new Bundle();
				b.putString("nickname", nickname);
				b.putString("message", message);
				msg.setData(b);

				if (message != null) {
					handler.sendMessage(msg);
				}
			}
		};
	}

화면 출력하는 부분은 아래와 같습니다.

public void onCreate(Bundle savedInstanceState) {
              ......
				case ACTION_SHOW_TEXTMESSAGE:
					b = msg.getData();
					addMessage(b.getString("nickname"), b.getString("message"));
					break;
				}
              ......
			};
		};

2.2.4 사용자 메시지를 서버로 전송

사용자가 메시지를 입력하고 전송 버튼을 누르면 입력된 메시지를 서버로 전송합니다.

private void attemptSend() {
		if (null == mUsername) return;
		mTyping = false;

		String message = mInputMessageView.getText().toString().trim();
		if (TextUtils.isEmpty(mInputMessageView.getText())) {
			mInputMessageView.requestFocus();
			return;
		}
		mInputMessageView.setText("");

		// 메시지를 전송한다.
		sendTextMessage(message);
	}

	public void sendTextMessage(String textMessage) {
		if (mProdKey.isEmpty()) {
			startGetProdKey("");
		}
		gi.send(ACT_ID, textMessage);
		return;
	}

2.2.5 다른 사용자의 로그인/로그아웃/정보 변경 내용을 공지

(2)에서 등록한 “actionOnUserIn()”, “actionOnUserOut()”, ““actionOnUserUpdated()” callback 함수를 통해 다른 사용자의 로그인/로그아웃/정보변경 내용을 화면에 출력합니다.

private static Callback actionOnUserIn(final Handler handler) {
		return new Callback() {
			@Override
			public void call(Object... args) {

				JSONObject custInfo = (JSONObject) args[1];
				String nickname, age;
				try {
					nickname = custInfo.getString("nickname");
					age = custInfo.getString("age");
				}
				catch (JSONException e) {
					return;
				}

				Message msg = Message.obtain(null, ACTION_ON_USERIN, 0, 0);
				Bundle b = new Bundle();
				b.putString("nickname", nickname);
				b.putString("age", age);
				msg.setData(b);

				if (nickname != null && !nickname.isEmpty()) {
					handler.sendMessage(msg);
				}
			}
		};
	}

	private static Callback actionOnUserOut(final Handler handler) {
		return new Callback() {
			@Override
			public void call(Object... args) {

				JSONObject custInfo = (JSONObject) args[1];
				String nickname, age;
				try {
					nickname = custInfo.getString("nickname");
					age = custInfo.getString("age");
				}
				catch (JSONException e) {
					return;
				}

				Message msg = Message.obtain(null, ACTION_ON_USEROUT, 0, 0);
				Bundle b = new Bundle();
				b.putString("nickname", nickname);
				b.putString("age", age);
				msg.setData(b);

				if (nickname != null && !nickname.isEmpty()) {
					handler.sendMessage(msg);
				}
			}
		};
	}

	private static Callback actionOnUserUpdated(final Handler handler) {
		return new Callback() {
			@Override
			public void call(Object... args) {

				JSONObject custInfo = (JSONObject) args[1];
				String nickname, age;
				try {
					nickname = custInfo.getString("nickname");
					age = custInfo.getString("age");
				}
				catch (JSONException e) {
					return;
				}

				Message msg = Message.obtain(null, ACTION_ON_USERUPDATED, 0, 0);
				Bundle b = new Bundle();
				b.putString("nickname", nickname);
				b.putString("age", age);
				msg.setData(b);

				if (nickname != null && !nickname.isEmpty()) {
					handler.sendMessage(msg);
				}
			}
		};
	}

Callback 함수로부터 받은 메시지를 출력하는 부분은 아래와 같습니다.

public void onCreate(Bundle savedInstanceState) {
              ......
				case ACTION_ON_USERIN:
					b = msg.getData();
					addLog("'" + b.getString("nickname") + "(" + b.getString("age") + ")'님이 입장하셨습니다.");
					break;
				case ACTION_ON_USEROUT:
					b = msg.getData();
					addLog("'" + b.getString("nickname") + "(" + b.getString("age") + ")'님이 퇴장하셨습니다.");
					break;
				case ACTION_ON_USERUPDATED:
					b = msg.getData();
					addLog("'" + b.getString("nickname") + "(" + b.getString("age") + ")'님으로 대화명이 변경되었습니다.");
					break;
              ......
			};
		};

2.2.6 채팅방에 접속된 사용자들의 목록을 출력

폰의 메뉴버튼을 통해 “Show userlist” 명령이 수행되면, 현재 접속된 사용자들의 목록을 출력합니다.

// 메뉴 버튼을 처리하는 함수
	public boolean onOptionsItemSelected(MenuItem item) {
		int id = item.getItemId();
......
		else if (id == R.id.action_show_userlist) showUserList();
......
	}

	// 현재 접속된 사용자들의 목록을 화면에 출력
	private void showUserList() {
		JSONObject userList;
		userList = gi.getUserList();
		String userListResult = "";

		int i = 0;
		try {
			Iterator keys = userList.keys();
			while (keys.hasNext()) {
				String key = keys.next();
				JSONObject custInfo = userList.getJSONObject(key);
				String genderResult = "";

				if (custInfo.has("gender")) {
					Log.d("DPushMainFragment", "gender" + custInfo.getString("gender"));
					genderResult = custInfo.getString("gender");
				}

				if ("M".equals(genderResult)) genderResult = "남성";
				else if ("F".equals(genderResult)) genderResult = "여성";
				else genderResult = "";

				userListResult += "'" + custInfo.getString("nickname") + "(" + genderResult + "," + custInfo.getString("age") + ")'";
				if (i < userList.length() - 1) userListResult += ", ";
				i++;
			}
			addLog("현재 접속된 사용자는 " + userListResult + " 입니다.");
		}
		catch (JSONException e) {
			addLog("ERROR: 현재 접속된 사용자는 " + userListResult + " 입니다.");
		}
		return;
	}

2.2.7 스마트폰이 Sleep Mode일 경우에도 메시지 수신

스마트폰이 SleepMode 로 진입했을때 서버와의 연결을 유지하기 위해 PowerManager의 WakeLock을 사용합니다. 이 코드는 셈플로 실 구현시는 battery 사용에 유의하셔야 합니다

PowerManager powerManager;
	PowerManager.WakeLock wakeLock;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		powerManager = (PowerManager) getSystemService(POWER_SERVICE);
		wakeLock = powerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "DPushChatWakelockTag");
		wakeLock.acquire();
	}

	@Override
	protected void onDestroy() {
		super.onDestroy();
		wakeLock.release();
	}

2.3 Product key 설정 액티비티 (DPushProdKeyCheck)

Product key를 입력 받는 액티비티이며, 메인(DPushMainFragment) Activity로부터 이전 Product key를 받고, 변경 key를 전달합니다.

public class DPushProdKeyCheck extends Activity {

	private EditText mProdKeyView;
	private String mProdKey;
	private boolean mIsBound = false;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_prodkeycheck);

		mProdKeyView = (EditText) findViewById(R.id.prodkey_input);

		Button prodKeyInButton = (Button) findViewById(R.id.prodkey_in_button);
		prodKeyInButton.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View view) {
				setProdKey();
			}
		});
		mProdKey = getIntent().getStringExtra("prodkey");
		mProdKeyView.setText(getIntent().getStringExtra("prodkey"));

		if (!getIntent().getStringExtra("errmessage").isEmpty()) 
mProdKeyView.setError(getIntent().getStringExtra("errmessage"));
	}

	private void setProdKey() {
		mProdKeyView.setError(null);
		String prodkey = mProdKeyView.getText().toString().trim();

		// 유저아이디가 적합한지를 체크한다.
		if (TextUtils.isEmpty(prodkey)) {
			mProdKeyView.setError(getString(R.string.error_field_required));
			mProdKeyView.requestFocus();
			return;
		}
		Intent intent = new Intent();
		intent.putExtra("prodkey", prodkey);
		setResult(RESULT_OK, intent);
		finish();
	}
}

2.4 로그인 설정 액티비티 (DPushLogin)

로그인 정보를 설정/변경하는 입력 받는 Activity이며, 메인(DPushMainFragment) Activity로부터 이전 로그인 정보를 받고, 변경된 로그인 정보를 전달합니다.

public class DPushLogin extends Activity {

	private EditText mUsernameView;
	private EditText mUserageView;
	private String mUsername;
	private int mUserage;
	private int mUsergender = 1; // 1: 남성(기본), 2: 여성
	private boolean mIsBound = false;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_login);

		// 로그인 폼을 설정한다.
		mUsernameView = (EditText) findViewById(R.id.username_input);
		mUserageView = (EditText) findViewById(R.id.userage_input);

		Button signInButton = (Button) findViewById(R.id.sign_in_button);
		signInButton.setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View view) {
				attemptLogin();
			}
		});

		int requestCode = getIntent().getIntExtra("requestcode", -1);
		if (requestCode == DPushMainFragment.REQUEST_UPDATE_USERINFO) {
			mUsernameView.setText(getIntent().getStringExtra("username"));
			mUserageView.setText(getIntent().getStringExtra("userage"));

			String usergender = getIntent().getStringExtra("usergender");
			RadioButton rbMale = (RadioButton) findViewById(R.id.radio_male);
			RadioButton rbFemale = (RadioButton) findViewById(R.id.radio_female);

			if ("1".equals(usergender)) rbMale.setChecked(true);
			else if ("2".equals(usergender)) rbFemale.setChecked(true);
		}
	}

	public void onRadioButtonClicked(View view) {
		boolean checked = ((RadioButton) view).isChecked();

		switch (view.getId()) {
		case R.id.radio_male:
			if (checked) mUsergender = 1;
			break;
		case R.id.radio_female:
			if (checked) mUsergender = 2;
			break;
		}
	}

	private void attemptLogin() {
		mUsernameView.setError(null);
		String username = mUsernameView.getText().toString().trim();

		// 유저아이디가 적합한지를 체크한다.
		if (TextUtils.isEmpty(username)) {
			mUsernameView.setError(getString(R.string.error_field_required));
			mUsernameView.requestFocus();
			return;
		}

		String userage = mUserageView.getText().toString().trim();
		if (TextUtils.isEmpty(userage)) {
			mUserageView.setError(getString(R.string.error_field_required));
			mUserageView.requestFocus();
			return;
		}

		try {
			mUserage = Integer.parseInt(userage);
		}
		catch (Exception e) {
			mUserageView.setError(getString(R.string.error_age_number_required));
			mUserageView.requestFocus();
			return;
		}
		mUsername = username;
		Intent intent = new Intent();
		intent.putExtra("username", mUsername);
		intent.putExtra("userage", "" + mUserage);
		intent.putExtra("usergender", "" + mUsergender);
		setResult(RESULT_OK, intent);
		finish();
	}

	@Override
	protected void onDestroy() {
		super.onDestroy();
	}
}

2.5 안드로이드 Manifest

이제 위와 같은 기능을 사용하기 위해 Andorid Manifest file 을 수정합니다.

먼저 2.1에서 설명한 3개의 Activity를 명시합니다.

또한, 정의된 안드로이드 기능을 사용하기 위한 권한정보를 추가합니다

* 자신만의 채팅방을 만드려면?

개발자이신 경우 직접 PRODUCTKEY를 받아서 소스상에서 수정하시면 됩니다.

먼저 간단한 가입을 통해 PRODUCTKEY를 받습니다.

DPUSH PRODUCTKEY 받기

기본적인 안드로이드 환경에 대한 설정은 사이트를 확인하세요.

사이트 Document 확인

생성한 Android 프로젝트의 libs 폴더에 JavaLibrary 를 첨부합니다.

필요한 라이브러리는 “Java-WebSocket-1.3.0.jar” 와 “dpush-v0.x.jar” 입니다

사이트 Download

가입 후에 채팅을 위해서는 두가지 세팅이 필요합니다.

“Customer Info사용 체크” 와 “클라이언트 메시지 체크” 입니다.

설정방법 가이드 보기

안드로이드채팅 2.43 MB

Download

안드로이드 푸시 (오늘의명언)

joytune — Tue, 07 Apr 2015 04:04:42 +0000

1. DPUSH를 이용한 안드로이드 푸시 샘플 만들기

1.1 시작 전에 필요한 작업들

먼저 간단한 가입을 통해 PRODUCTKEY를 받습니다.

DPUSH PRODUCTKEY 받기

기본적인 안드로이드 환경에 대한 설정은 사이트를 확인하세요.

사이트 Document 확인

생성한 Android 프로젝트의 libs 폴더에 JavaLibrary 를 첨부합니다.

필요한 라이브러리는 “Java-WebSocket-1.3.0.jar” 와 “dpush-v0.x.jar” 입니다

사이트 Download

1.2 샘플 어플의 내용

DPUSH 를 통해 최초 작업된 안드로이드 앱은 “오늘의 명언”이라는 어플입니다.

이 어플은 간단히 서버에서 전송되는 메시지를 Notification영역에 표시하고, 선택시 노출하는 기능만을 구현합니다.

서버에서 특정 메세지를 보낼 경우 안드로이드 폰에 상단 Notification 영역에 메세지가 왔음을 알립니다.

해당 어플은 스토어에서 DPUSH로 검색하면 받을 수 있으며 스토어 주소는 다음과 같습니다.

https://play.google.com/store/apps/details?id=kr.co.joytune.dpush

2. Android APP(오늘의명언) 중요 설명

2.1 안드로이드 Service

전체 소스를 참고하시고 기본적으로 필요한 중요한 내용만을 설명합니다.

필요한 기능으로 정의된 내용은 아래와 같습니다.

서버에서 메시지를 전송받을 수 있는 Client
메시지 수신시 Notification 영역에 받은 메시지를 알림
알림 확인시 화면에 해당 내용을 노출
어플 종료 또는 스마트폰 시작시 자동으로 어플을 실행시킬수 있는 기능
스마트폰이 Sleep Mode일때도 메시지를 수신 할 수 있는 기능

우선 서버와의 접속을 위한 dpclient 는 서비스영역에 정의합니다.

private DPClient dpm;

	// GRP_ID(그룹명) 와 ACT_ID(액션명) 는 property에서 읽어서 가져옵니다.

	private void connect() {
		// 기 정의된 dpclient 가 없으면 생성한다
		if (this.client == null) {
			this.client = new DPClient('발급받은 PRODUCTKEY') {

				public void onConnected() {
					Log.d(TAG, "onconnect................");
				}

				public void onDisconnected() {
					Log.d(TAG, "ondisconnect................");
					// 종료시 재접속 요청(30초후)
					mHandler.sendEmptyMessageDelayed(0x8999, 30 * 1000);
				}

				public void onHeartbeat() {
					mHandler.sendEmptyMessage(0x7000);
				}
			};
		}

		// 서버와의 접속을 시도한다
		if (!client.isConnected()) {
			client.connect();
		}

		// 오픈된 그룹이면 정의된 ActionID 에 해당하는 callback만을 재정의한다 
		if (client.isOpened(GRP_ID)) {
			Log.d(TAG, "is opened....");
			gi = client.getOpenedGroup(GRP_ID);
			gi.onReceive(ACT_ID, action(mHandler));
		}
		// 그룹을 오픈한다
		else {
			Log.d(TAG, "is not opened....");
			gi = client.openGroup(GRP_ID);
			gi.onReceive(ACT_ID, action(mHandler));
		}
	}

메시지 도착시 Notification 영역에 노출하기 위한 기능을 추가합니다

/**
	 * 서버에서 메시지가 수신되었을때의 callback을 정의한다
	 * @param handler
	 * @return
	 */
	private static Callback action(final Handler handler) {
		return new Callback() {
			@Override
			public void call(Object... args) {
				String message = (String) args[0];
				if (message != null && !"".equals(message)) {
					handler.sendMessage(handler.obtainMessage(ACTION_SHOW_NOTIFICATION, message));
				}
			}
		};
	}

	public static final int		NOTIFICATION_ID				= 0x1234;
	private static final int	ACTION_SHOW_NOTIFICATION	= 0x5001;

	/**
	 * 알림영역에 Notification 을 노출한다
	 * @param title
	 * @param text
	 */
	private void showNotification(CharSequence title, CharSequence text) {

		// 알림 도착시 실행하고자 하는 작업(Intent)을 설정 
		Intent intent = new Intent(DPushService.this.getApplicationContext(), DPushAlarm.class);
		// - 필요한 parameter 설정
		intent.putExtra("NM", title.toString());
		intent.putExtra("MG", text.toString());
		// - 기존에 호출된 Intent 가 있으면 제거한다
		intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
		// - 새로운 Activity를 생성하도록 한다
		intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

		// PendingIntent 초기화
		PendingIntent contentIntent = PendingIntent.getActivity(getApplicationContext(), 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);

		// 메시지 도착을 알리기 위해 Notification을 사용한다
		// Notification Builder 객체생성
		NotificationCompat.Builder notibuilder = new NotificationCompat.Builder(getApplicationContext());
		// - 상태표시줄에 나타낼 아이콘
		notibuilder.setSmallIcon(R.drawable.dpush_logo);
		// - Notification 을 표시할 시각
		notibuilder.setWhen(System.currentTimeMillis());
		// - 상태표시줄에 나타낼 제목
		notibuilder.setContentTitle(title);
		// - 상태표시줄에 나타낼 내용
		notibuilder.setContentText(Html.fromHtml(text.toString()));
		// - 알림항목을 눌렀을때 해당 알림을 자동으로 해제시키도록 설정
		notibuilder.setAutoCancel(true);
		// - 알림항목을 눌렀을때 실행할 작업(Intent)
		notibuilder.setContentIntent(contentIntent);
		// - builder 를 통해 Notification 생성
		Notification notification = notibuilder.build();

		// - 알림도착시 소리
		notification.defaults |= Notification.DEFAULT_SOUND;

		// NotificationManager 객체 호출
		NotificationManager mNM = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
		// - 고유아이디를가지는 notification 을 표시
		mNM.notify(DPUSH_NOTIFICATION_ID, notification);
	}

메시지 도착시 Notification 영역에 노출하기 위한 기능을 추가합니다

시스템에 의해 서비스가 강제 종료 되었을때 앱을 재시작 시키기 위한 Alarm을 등록/해제 하는 기능을 추가합니다


	@Override
	public void onCreate() {
		super.onCreate();
		// 등록된 알람은 제거
		unregisterRestartAlarm();
	}

	@Override
	public void onDestroy() {
		...
		// 알람 등록
		registerRestartAlarm();

		super.onDestroy();
	}

	/**
	 * 서비스가 시스템에 의해서 또는 강제적으로 종료되었을 때 호출되어
	 * 알람을 등록해서 15초 후에 서비스가 실행되도록 한다.
	 */
	private void registerRestartAlarm() {
		Intent intent = new Intent(DPushService.this, DPushReceiver.class);
		intent.setAction(DPushReceiver.ACTION_DPUSH_RESTART);
		PendingIntent sender = PendingIntent.getBroadcast(DPushService.this, 0, intent, 0);

		long firstTime = SystemClock.elapsedRealtime();
		firstTime += 15 * 1000; // 15초 후에 알람이벤트 발생

		AlarmManager am = (AlarmManager) getSystemService(ALARM_SERVICE);
		am.setRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP, firstTime, 60 * 1000, sender);
	}

	/**
	 * 기존 등록되어있는 알람을 해제한다.
	 */
	private void unregisterRestartAlarm() {
		Intent intent = new Intent(DPushService.this, DPushReceiver.class);
		intent.setAction(DPushReceiver.ACTION_DPUSH_RESTART);
		PendingIntent sender = PendingIntent.getBroadcast(DPushService.this, 0, intent, 0);

		AlarmManager am = (AlarmManager) getSystemService(ALARM_SERVICE);
		am.cancel(sender);
	}


	private BroadcastReceiver screenoff;

	@Override
	public void onCreate() {

		super.onCreate();
		...

		screenoff = new BroadcastReceiver() {

			@Override
			public void onReceive(Context context, Intent intent) {
				// 스마트폰 화면이 켜졌을때
				if (Intent.ACTION_SCREEN_ON.equals(intent.getAction())) {
					WakeLocker.releaseWakeLock();
				}
				// 스마트폰 화면이 꺼졌을때
				else if (Intent.ACTION_SCREEN_OFF.equals(intent.getAction())) {
					WakeLocker.acquireWakeLock(context);
				}
			}
		};
		// Screen Off Receiver 를 등록
		IntentFilter offfilter = new IntentFilter(Intent.ACTION_SCREEN_OFF);
		offfilter.addAction(Intent.ACTION_SCREEN_ON);
		registerReceiver(screenoff, offfilter);
		...
	}

	@Override
	public void onDestroy() {
		...
		// Screen Off Receiver 를 해제
		unregisterReceiver(screenoff);

		super.onDestroy();
	}

	static class WakeLocker {

		private static PowerManager.WakeLock sCpuWakeLock;

		/**
		 * PowerManager.WakeLock 시작
		 * @param context
		 */
		static void acquireWakeLock(Context context) {
			PowerManager pm = (PowerManager) context.getSystemService(Context.POWER_SERVICE);
			if (!pm.isScreenOn()) {
				sCpuWakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, context.getClass().getSimpleName());
				sCpuWakeLock.acquire();
			}
		}

		/**
		 * PowerManager.WakeLock 해제
		 */
		static void releaseWakeLock() {
			if (sCpuWakeLock != null && sCpuWakeLock.isHeld()) {
				sCpuWakeLock.release();
			}
		}
	}

2.2 안드로이드 Receiver

위와 같은 서비스를 생성한 이후, 부팅완료, 네트웍 변경등의 상황 발생시 서비스를 재시작하기 위한 Receiver 를 생성합니다

public class DPushReceiver extends BroadcastReceiver {

	private static final String TAG = DPushReceiver.class.getSimpleName();

	public static final String ACTION_DPUSH_RESTART = "kr.co.joytune.dpush.restart";

	@Override
	public void onReceive(Context context, Intent intent) {
		String action = intent.getAction();

		/* 서비스 재시작 */
		if (action.equals(DPushReceiver.ACTION_DPUSH_RESTART)) {
			Log.d(TAG, "Service dead, but resurrection");
			Intent i = new Intent(context, DPushService.class);
			context.startService(i);
		}

		/* 스마트폰 부팅완료 */
		if (action.equals(Intent.ACTION_BOOT_COMPLETED)) {
			Log.d(TAG, "ACTION_BOOT_COMPLETED");
			Intent i = new Intent(context, DPushService.class);
			context.startService(i);
		}

		/* 네트웍 변경 */
		if (action.equals(ConnectivityManager.CONNECTIVITY_ACTION)) {
			try {
				ConnectivityManager connectivityManager = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
				NetworkInfo activeNetInfo = connectivityManager.getActiveNetworkInfo();
				if (activeNetInfo != null) {
					Intent i = new Intent(context, DPushService.class);
					context.startService(i);
				}
			}
			catch (Exception e) {
			}
		}
	}
}

2.3 안드로이드 Manifest

이제 위와 같은 기능을 사용하기 위해 Andorid Manifest file 을 수정합니다

생성된 위 Service와 Receiver 를 manifest 에 추가합니다.

또한, 정의된 안드로이드 기능을 사용하기 위한 권한정보를 추가합니다

3. Server API 연동

3.1 시작 전에 필요한 작업들

Server API의 경우 PHP를 기본으로 설명합니다.

서버에 대한 부분은 BUSINESS SERVER API에서 ‘DPServer의 선언’과 ‘send’를 참고하시면 됩니다.

사이트 Document 확인

Download의 Server API(Business Server)에서 PHP를 다운받아서 설치합니다.

사이트 Download

3.2 오늘의 명언 보내기

서버 API에서의 작업은 간단합니다.

발급받은 PRODUCTKEY를 넣고 send를 호출하면 됩니다.

send('twise','tnoti',"A great secret of success is to go through life as a man who never gets used up.
성공의 커다란 비결은 결코 지치지 않는 인간으로 인생을 살아가는 것이다.
알버트 슈바이처");
?>

오늘의명언 1.31 MB

Download

DPUSH로 만드는 JAVASCRIPT 채팅

joytune — Wed, 01 Apr 2015 07:04:51 +0000

1. 간단한 채팅 만들기
1.1 시작 전에 필요한 작업들
먼저 간단한 가입을 통해 PRODUCTKEY를 받습니다.
DPUSH PRODUCTKEY 받기

가입 후에 채팅을 위해서는 두가지 세팅이 필요합니다.
“Customer Info사용 체크” 와 “클라이언트 메시지 체크” 입니다.
설정방법 가이드 보기

1.2 채팅 화면 HTML

위와 같이 간단히 메세지를 입력했을때 받을수 있는 간단한 채팅창을 만들어 보도록 하겠습니다.

위와 같은 간단한 html 을 작성합니다.

1.3 JAVASCRIPT
소스안에 다음의 JAVASCRIPT를 추가하시면 됩니다.

var client = new DPClient(‘발급받은 PRODUCTKEY’);
이 부분에 가입시 발급받은 PRODUCTKEY를 입력합니다.

client.openGroup(‘chat-group’,{‘sendevent':true});
client의 openGroup에서 sendevent를 true로 설정하셔야 client에서 메세지를 전송할 수 있게 됩니다.

1.4 FULL SOURCE

2. CUSTOMER INFO 추가 (닉네임등의 개인정보 추가)
2.1 CUSTOMER INFO
CUSTOMER INFO는 참여한 그룹에 Client 개인 정보입니다. DPMessage 에서 고객의 Business를 적용 할 수 있는 유일한 수단입니다. 앞에서 간단한 채팅 예제 경우 완성도를 높이기 위해서 채팅에 관련된 nickname이 필요할 수 있습니다. 이러한 데이터를 DPMessage Server에 보내서 다른 Client와 Sync를 맞추는 작업이 필요합니다. 또한 Client가 챗방에 접속하거나 접속이 끊겼을 경우 해당 이벤트에 대한 내용도 Client들에게 전달해야 합니다.

자세한 CUSTOMER INFO의 내용은 사이트의 문서를 참고 하시면 됩니다.
CUSTOMER INFO DOCUMENT 보기

2.2 사용자 정보를 추가한 HTML 화면

간단한 챗창에서 유저목록을 추가하여 화면을 구성하도록 하겠습니다.











			
Enter Your NickName!
 

					
						NickName : 
					
					
						
					

					
						Age : 
					
					
						
					
					
						gender : 
					
					
						male female

2.3 JAVASCRIPT
소스 안에 JAVASCRIPT는 다음과 같습니다.

소스 라인이 많이 길어지긴 하지만 대부분 화면 처리와 쿠키값 처리를 위한 부분입니다.
수정된 부분은 openGroup에서 custevent 를 true 설정해서 사용자 개인정보를 전달받도록 수정했으며 openGroup의 3번째 파라미터인 callback 함수를 등록하여 최초 접속 시에 writeUsers 란 함수에서 해당 유저의 목록을 보여주도록 변경되어 있습니다.

중요한 내용은 3가지의 event 함수를 등록하셔야 합니다.
 group.onUserIn : 사용자가 접속했을때 발생되는 이벤트
 group.onUserOut : 사용자가 접속 끊었을 때 발생되는 이벤트
 group.onUserUpdated : 사용자가 개인정보를 변경했을 때 발생되는 이벤트
3종류 이벤트 함수 DOCUMENT 보기

NickName등의 개인 정보가 변경 되었을 경우 group.updateUser(custinfo); 를 호출하여 해당 내용은 전체 챗방에 접속한 Client들의 onUserUpdated 함수를 호출하게 됩니다.

FULL SOURCE는 다운 받으신 custinfochat.html을 참고하시면 됩니다.

3. 채팅의 서버공지 추가
3.1 BUSINESS SERVER
앞에서 나온 내용으로도 괜찮은(?) 간단한 채팅 어플이 완료되었습니다. 조금 더 심도있는 내용으로 BUSINESS SERVER 를 활용하는 공지메세지를 보내보도록 하겠습니다.
BUSINESS SERVER 는 간단하게 DPUSH SERVER API를 이용해서 직접 메세지를 보낼 수 있는 간단한 서버라고 생각하시면 됩니다.
BUSINESS SERVER DOCUMENT 보기

현 튜토리얼에서는 서버언어가 PHP로 가정해서 진행하도록 하겠습니다.
DPUSH 사이트의 DOWNLOAD에서 Server API의 PHP 라이브러리를 다운받아서 서버에 업로드 합니다.

PHP로 간단한 공지의 소스는 다음과 같습니다.

include "[라이브러리위치]/dpmessage.php";
$dpmessage = new DPServer("발급받은 PRODUCTKEY");
$dpmessage->send('chat-group','chat-action-notice', "Hello World!");

위에 소스는 간단한 예로 실제로 html의 input box에서 입력받도록 만들수도 있습니다.

3.2 JAVASCRIPT
추가되는 JAVASCRIPT는 간단합니다.
그룹 선언 이후에 다음의 onReceive 함수만 추가해 주면 됩니다.

group.onReceive('chat-action-notice', function(data, userid, custinfo) { 
// 서버 공지에 대한 내용을 받는다.
	writeChat('[공지] : ' + data + '');
});

그룹은 메세지를 받는 전체 단위입니다. 즉 같은 그룹명으로 오픈된 전체 client는 send 메세지를 통해서 메세지를 전달 받게 됩니다. 여기서 action명을 통해서 해당 메세지를 받아서 처리하는 내용을 구분하게 됩니다. 예로 앞서서 chat-action과 chat-notice-action이 둘다 onReceive 함수로 등록되어 있는 경우 일반채팅과 공지를 둘 다 받아서 처리할 수 있습니다. chat-action만 등록되어 있는 경우 공지메세지를 받긴 하지만 처리하는 receive함수가 없기 때문에 푸시 메세지를 받기만 할 뿐 아무런 동작을 하지 않습니다.
onReceive & Send DOCUMENT 보기

FULL SOURCE는 다운 받으신 noticechat.html을 참고하시면 됩니다.

문서와 소스 받기

채팅 TUTORIAL 378.36 KB

Download

DPUSH 오픈 베타를 시작합니다.

joytune — Tue, 20 Jan 2015 13:52:05 +0000

그동안 서비스 오픈을 위해 많은 시간을 준비했던 DPUSH 서비스가 오픈베타를 시작합니다.

DPUSH는 다음과 같은 서비스 특징을 가지고 있습니다.
“쉽고 빠르다”, “다양한 매체 지원”, “간단한 절차”, “서버로그 NO”, “쉬운 프로그램”

베타 테스트 기간동안 무료로 가입하셔서 사용하실 수 있습니다.

차후 정식오픈은 따로 공지해 드리도록 하겠습니다.

최선의 노력과 서비스를 약속드리는 JOYTUNE이 되겠습니다.