onReceive & Send

* Client 튜토리얼은 javascript를 기준으로 설명합니다. android, ios 도 같은 함수명으로 API를 참조하시면 됩니다.

메세지 수신과 송신은 ActionName으로 구분됩니다. Action 은 Push되는 그룹에서 해당 데이터의 행위를 정의하는 내용입니다.

• onReceive

Action을 onReceive 하면 해당 Action에 대한 Push Message가 해당 Action의 callback 함수로 전달됩니다.
기본선언은 다음과 같습니다.

group.onReceive('액션명', callback함수);
group.onReceive (actionname, userid, callback);
  • actionname (String) required
    임의의 액션명
  • callback (Function) requried
    메세지를 전달 받는 callback함수
  • data (String) : 전달된 Push 메세지
  • userid (String) : 접속한 그룹의 개인 Qnique한 ID값 (시스템값)
  • custinfo (Object) : Push 메세지를 보낸 그룹의 개인 정보
group.onReceive('chat-action', function(data, userid, custinfo) {
	alert(data);
	alert(userid);
	alert(custinfo);
});

• Send

Send Action은 소속되어 있는 Group에 해당 메세지를 보내는 행위입니다. Client 에서 Send Action을 사용하고 싶은 경우 먼저 “마이페이지”의 해당 PRODUCTKEY설정에서 클라이언트 메시지의 전송가능을 체크하셔야 하고 Client소스 코딩에서 opengroup 시에 sendevent를 true로 정의하셔야 합니다. 기본은 false로 정의되어 있습니다.
Action명, 데이터 내용을 파라미터로 Push를 하면 Group에 소속되어 있는 Client에게 Push 메세지가 전달되고 해당 Client 중에서 Action명으로 receiver 되어 있는 함수로 데이터가 전달 됩니다.
기본선언은 다음과 같습니다.

group.send('액션명', '데이터');
group.send(actionname, pushdata);
  • actionname (String) required
    임의의 액션명
  • pushdata (String) required
    전달할 데이터의 내용
group.send('chat-action', 'Hello World!');