Group Open

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

그룹은 Push 대상의 집합을 만드는 과정입니다.
지정된 그룹에 속한 유저에게 메세지를 Broadcast로 Push하게 됩니다.

기본선언은 다음과 같습니다.

var group = client.openGroup('그룹명');
var group = client.openGroup(groupname, options, callback);
  • groupname (String) required
    임의의 그룹명
  • options (Object) optional
    DPMessage 옵션정보

    • custevent (Boolean) : 그룹에서 CUSTMER INFO 이벤트를 callback 받는 유무, 기본값 false
    • custinfo (Object) : 연결된 그룹의 CUSTOMER 정보
    • sendevent (Boolean) : 해당 그룹의 client가 send 함수를 사용가능한 유무. 기본값 false
    • authparam (String) : 인증URL 전달 파라미터
    • authcallback (Function) : 인증 후 실행될 callback함수
  • callback (Function) optional
    그룹이 생성된 후의 이벤트가 필요할 경우 선언

CUSTOMER INFO를 이용하게 되면 해당 client만의 고유한 정보를 전체 그룹에서 공유하게 됩니다. 가령 채팅방의 닉네임같은 정보입니다. CUSTOMER INFO를 사용할 경우 client의 접속, 탈퇴, 정보변경 시에 메세지를 보내기 때문에 메세지 count가 많이 증가하게 됩니다. CUSTOMER 정보관련 내용은 CUSTOMER INFO을 참조하시면 됩니다. CUSTOMER INFO를 사용하기 위해서는 PRODUCTKEY 설정에서 Customer Info 사용을 체크하셔야 합니다.
sendevent는 client에서 메세지를 보낼 수 있는 send함수의 사용 유무입니다. 채팅의 경우 기본적으로 true로 세팅하셔야 합니다. client의 send를 사용하기 위해서는 PRODUCTKEY 설정에서 클라이언트 메세지를 체크하셔야 합니다.
authparam, authcallback등 인증관련 내용은 보안/인증의 인증을 참조하시면 됩니다.

var group = client.openGroup('chat-group', {
	'custevent' : true,
	'custinfo' : {'nickname' : '홍길동'},
	'sendevent' : true,
	'authparam' : "param1=param1¶m2=param2",
	'authcallback' : authcallback
}, function(data) {
	alert(data);
});