굵게, 기울임, 밑줄 등 툴바에 사용자 정의 버튼을 추가할 수 있습니다. 툴바영역을 벗어나는 버튼에 대해서는 MORE 버튼을 통해 숨겨지고 해당 버튼을 클릭하여, 벗어나는 버튼목록을 볼 수 있습니다.

Object tool[] 의 형태로 정의되어 집니다. (예제소스 참조)

Object tool - 툴바버튼의 객체가 정의됩니다.

icon:String - 버튼아이콘의 전체경로를 정의합니다.

text:String - 버튼이름을 정의합니다.

viewText:Boolean - toolType 변수의 값이 "icon"일 때라도 버튼이름을 보일지 여부를 정의합니다. (true 일 경우 toolType 값과 관계없이, 버튼이름도 함께 출력합니다.)

fn:Function - 버튼이 클릭했을 때의 액션을 함수로서 정의합니다.

new Minion({
	// 생략
	addTool:[
		{
			icon:"http://www.yourdomain.com/icon.gif",
			text:"홈페이지이동",
			viewText:true,
			fn:function(minion) {
				minion.printSystem("홈페이지로 이동합니다.");
				window.open("http://www.minion.kr");
			}
		},{
			// 생략
		}
	],
	// 생략
});

info 변수값 등을 활용하여, 접속유저의 닉네임을 클릭했을 때 나타나는 유저메뉴를 추가할 수 있습니다.

Object userMenu[] 형태로 배열로 등록하게 됩니다. (예제소스 참조)

Object userMenu - 하나의 메뉴에 대한 객체가 정의됩니다.

icon:String - 메뉴아이콘의 전체경로를 정의합니다.

text:String - 메뉴의 이름을 정의합니다.

viewMenu:Function - 해당메뉴가 출력되는 여부를 함수로서 정의합니다.

fn:Function - 메뉴를 클릭했을 때 액션을 함수로서 정의합니다.

new Minion({
	// 생략
	info:"http://www.memberhomepage.com,email@email.com",
	addUserMenu:[
		{
			icon:"http://www.yourdomain.com/homepage.gif",
			text:"유저홈페이지가기",
			viewMenu:function(minion,user,myinfo) {
				var info = user.info.split(","); // 여러개의 정보를 콤마(,)로 구분하여 정의하였기에 콤마(,)로 구분하여 각각의 데이터를 추출한다.
				if (info[0]) { // 홈페이지정보가 있을 때
					return true; // 이 메뉴를 보인다.
				} else {
					return false; // 정보가 없다면 메뉴를 숨긴다.
				}
			},
			fn:function(minion,user,myinfo) {
				var info = user.info.split(",");
				window.open(info[0]);
			}
		},{
			// 생략
		}
	],
	// 생략
});

해당 변수의 값이 존재할 경우, 해당회원은 채널관리자권한으로 접속하게 됩니다.

특정인에게만 관리자권한을 주기 위하여, 서버스크립트 언어의 IF문등을 활용하여, 정의합니다.

해당코드의 위변조를 통한 관리자권한획득을 방지하기 위하여, 특정규칙으로 암호화하여야 합니다.

<?php
// 관리자코드를 암호화하기 위한 함수
// $apiKey 는 채널생성시 입력한 10자리의 API키 값입니다.
// 채널생성 및 관리하기 메뉴에서 확인할 수 있습니다.
function GetAdminCode($apiKey) {
	if ($is_admin == true) { // $is_admin 값은 상황에 맞게 관리자권한을 획득할 유저를 체크
		return md5($_SERVER['HTTP_HOST'].$apiKey.$_SERVER['REMOTE_ADDR']);
	} else {
		return "";
	}
}
?>

PHP의 경우 위와 같은 방법으로 관리자코드를 생성하며 되며, 다른 언어의 경우에도 같은 방법으로 MD5($apiKey+$ip+$serverDomain); 의 형태로 정의하시면 됩니다.

특정언어에 대하여, 관리자코드를 생성하는 방법을 잘 모르실 경우, 문의게시판을 통해 문의하여 주시기 바랍니다.

관리자코드는 JavaScript나 Html으로는 만들 수 없으므로, 서버스크립트가 지원되지 않는 곳에서는 이 방법으로 관리자권한을 획득할 수 없습니다.

위와 같은 경우 /login 명령어를 이용하거나, 채널회원관리에 등록된 아이디를 통해 회원권한을 획득할 수 있습니다.

new Minion({
	adminCode:"<?php echo GetAdminCode('1234567890'); ?>",
	// 이하 생략
});

유저의 접속과 접속종료 메세지를 출력하기 위한 특정 등급을 지정합니다.

ALL : 전체유저의 접속/접속종료 메세지를 출력

NICKGUEST : 닉네임을 변경한 손님 및 로그인한 유저, 채널관리자의 접속/접속종료 메세지를 출력

MEMBER : 로그인한 유저 및 채널관리자의 접속/접속종료 메세지를 출력

ADMIN : 채널관리자의 접속/접속종료 메세지를 출력

페이지이동등으로 인해 유저가 짧은시간내에 접속종료 및 재접속하였을 경우, 유저의 채널종료/참여메세지가 과하게 출력될 경우가 있습니다.

따라서 이 변수에 정의된 시간(초)내에 유저가 재접속하였을 경우에는 유저의 채널종료/참여 메세지를 보이지 않습니다.

이 변수의 값을 0 으로 설정할 경우, 채널접속/참여 메세지가 바로 보이게 되며, 0 이상일 경우 유저가 채널접속을 종료했을 때 바로 접속종료 메세지를 보이지 않고 설정한 시간(초)만큼 기다렸다가 재접속하지 않으면, 접속종료 메세지를 보입니다.

랜덤채팅은 사용자가 자신의 성별과 랜덤하게 찾을 유저의 조건을 선택한 후 서버에 접속하는 방식이나, gender 변수와 match 변수에 미리 해당정보가 정의되어있다면, autoConnect 변수를 통해 자동으로 랜덤채팅에 접속하도록 합니다.

true : 자동접속

false : 사용자입력후 접속

new Minion({
	id:"example",
	chatType:"random",
	gender:"M",
	match:"ALL",
	autoConnect:true,
	// 이하 생략
});

생성한 채널의 이름을 #을 포함하여 입력합니다.

new Minion({
	channel:"#example",
	// 이하 생략
});

미니온의 채팅동작방식을 설정합니다. 이 변수에 의하여 채널채팅 또는 랜덤채팅을 선택할 수 있습니다.

channel : 채널채팅

random : 랜덤채팅

개인채널등이나, 각종 미니온 프로그램상에서 한글이 깨진다면, 이 변수값으로 홈페이지의 인코딩셋과 맞춰줄 수 있습니다.

기본값은 UTF-8 이며, 들어갈 수 있는 값은 EUC-KR, CP494, EUC-JP 등 홈페이지에서 사용중인 기본 인코딩값을 입력하시면 됩니다.

랜덤채팅은 기본적으로 성별정보가 필요합니다.

회원정보연동등을 통하여 접속자의 성별을 미리 지정할 수 있습니다.

M : 남자

F : 여자

미니온의 세로크기를 픽셀단위로 정의합니다.

미니온4 버전부터 % 단위에 대한 지원이 중지됩니다.

반드시 정확한 픽셀수치를 입력하여 주시기 바랍니다.

new Minion({
	width:200,
	height:500,
	// 이하 생략
});

공용클래스에서 호출하기 위한 현재의 미니온객체를 가르키는 고유한 값을 지정합니다.

지정하지 않을경우, 랜덤한 값으로 자동으로 지정됩니다.

한페이지에 여러개의 미니온을 설치할 경우, 이 값은 유일하여야 합니다.

유저에게 특정한 부가정보(회원아이디, 회원홈페이지주소 등)을 정의하여, 각종이벤트에 활용할 수 있습니다.

해당정보는 User Object 의 info 라는 이름으로 정의되어 집니다.

new Minion({
	// 생략
	info:"http://www.memberhomepage.com,email@email.com",
	addUserMenu:[ // 유저메뉴에 사용 예
		{
			icon:"http://www.yourdomain.com/homepage.gif",
			text:"유저홈페이지가기",
			viewMenu:function(minion,user,myinfo) {
				var info = user.info.split(","); // 여러개의 정보를 콤마(,)로 구분하여 정의하였기에 콤마(,)로 구분하여 각각의 데이터를 추출한다.
				if (info[0]) { // 홈페이지정보가 있을 때
					return true; // 이 메뉴를 보인다.
				} else {
					return false; // 정보가 없다면 메뉴를 숨긴다.
				}
			},
			fn:function(minion,user,myinfo) {
				var info = user.info.split(",");
				window.open(info[0]);
			}
		},{
			// 생략
		}
	],
	listeners:{ // 이벤트리스너에서 사용 예
		onConnect:function(minion,channel,user) {
			var info = user.info;
			var temp = info.split(","); // 여러개의 정보를 콤마(,)로 구분하여 정의하였기에 콤마(,)로 구분하여 각각의 데이터를 추출한다.
			minion.printSystem(user.nickname+"님의 홈페이지인 "+temp[0]+"에도 놀러가볼까요?!");
		}
	}
});

미니온이 단일프레임 방식이 아닌 iframe 이나 기타 frameset 에 종속되어 있을 경우, true 로 지정합니다.

true 로 지정되어 있다면, 레이어로 뜨는 설정창 (닉네임변경 창 등)이 팝업창으로 나타나게 됩니다.

그 외에도 레이어로 뜨는 설정창의 크기 (가로 400픽셀, 세로 400픽셀 이하)를 미니온이 삽입된 페이지에서 표현하지 못할 경우, true 로 지정하면, 해당 설정창이 팝업창으로 나타나게 됩니다.

true로 설정할 경우, 미니온이 삽입된 객체의 상위객체의 크기에 따라 미니온의 크기가 가변적으로 변경됩니다.

HTML표준에 따라 가로 세로 100% 로 지정하고자 할 경우 모든 상위객체 HTML, BODY 등의 크기가 100%로 지정되어 있어야합니다.

<html>
<head>
<style type="text/javascript">html, body {width:100%; height:100%;}</style>
</head>
<body>
<script type="text/javascript">
new Minion({
	isFullSize:true,
	// 생략
});
</script>
</body>
</html>

language 변수를 통한 다국어를 지원합니다.

현재 가능한 언어셋의 종류는 아래와 같습니다.

한국어 : ko

영어 : en

이벤트핸들러 종류는 이벤트부분을 참고하여 주시기 바랍니다.

new Minion({
	// 생략
	listeners:{
		onConnect:function() { },
		onJoin:function() { }
	}
});

사용자의 성별에 따라 랜덤하게 찾을 유저의 조건을 설정합니다.

ALL : 성별무관매칭

M : 남성만 매칭

F : 여성만 매칭

해당 변수의 값이 존재할 경우, 해당회원은 회원권한으로 접속하게 됩니다.

특정인에게만 관리자권한을 주기 위하여, 서버스크립트 언어의 IF문등을 활용하여, 정의합니다.

해당코드의 위변조를 통한 회원권한획득을 방지하기 위하여, 특정규칙으로 암호화하여야 합니다.

// 회원코드를 암호화하기 위한 함수
// $apiKey 는 채널생성시 입력한 10자리의 API키 값입니다.
// 채널생성 및 관리하기 메뉴에서 확인할 수 있습니다.
function GetMemberCode($apiKey) {
	if ($is_member == true) { // $is_member  값은 상황에 맞게 관리자권한을 획득할 유저를 체크
		return md5($apiKey.$_SERVER['REMOTE_ADDR'].$_SERVER['HTTP_HOST']);
	} else {
		reutn false;
	}
}

PHP의 경우 위와 같은 방법으로 회원코드를 생성하게 되며, 다른 언어의 경우에도 같은 방법으로 MD5($apiKey+$ip+$serverDomain);의 형태로 정의하시면 됩니다.

특정언어에 대하여, 회원코드를 생성하는 방법을 잘 모르실 경우, 문의게시판을 통해 문의하여 주시기 바랍니다.

회원코드는 JavaScript나 Html으로는 만들 수 없으므로, 서버스크립트가 지원되지 않는 곳에서는 이 방법으로 회원권한을 획득할 수 없습니다.

위와 같은 경우 /login 명령어를 이용하거나, 채널회원관리에 등록된 아이디를 통해 회원권한을 획득할 수 있습니다.

new Minion({
	memberCode:"<?php echo GetMemberCode('1234567890'); ?>",
	// 이하 생략
});

이미지닉네임의 이미지가 위치한 경로를 http:// 를 포함한 절대경로로 입력합니다.

회원시스템과의 연동이 필요없을 경우, 정의하지 않으시면 됩니다.

이미지닉네임을 2개이상 사용하거나(닉네임아이콘, 이미지닉네임), 특정아이콘과 함께 텍스트로 닉네임을 표현하고자 할경우 아래와 같이 콤마(,)로 구분하여 입력하시면 됩니다.

2가지의 이미지를 출력할 경우

new Minion({
	nickcon:"http://www.yourdomain.com/image1.gif,http://www.yourdomain.com/image2.gif",
	// 이하 생략
});

닉아이콘과 함께 텍스트로 닉네임을 출력할때

new Minion({
	nickcon:"http://www.yourdomain.com/image.gif,{nickname}",
	// 이하 생략
});

{nickname}은 고유한 키값으로 출력시 해당부분이 유저의 닉네임으로 자동으로 치환되어 표현됩니다.

기본사용방법

new Minion({
	nickname:"<?php echo $member['nickname']; ?>",
	nickcon:"http://www.yourdomain.com/<?php echo $member['user_id']; ?>.gif",
	// 이하 생략
});

해당 변수의 값이 있을 경우, 미니온 접속시 회원권한을 획득하게 됩니다.

회원시스템과의 연동이 필요없을 경우, 정의하지 않으시면 됩니다.

new Minion({
	nickname:"<?php echo $member['nickname']; ?>",
	nickcon:"http://www.yourdomain.com/<?php echo $member['user_id']; ?>.gif",
	// 이하 생략
});

partnerCode 는 미니온과의 별도의 협의를 거쳐, 애드텍(광고)출력 여부 및, 전용서버 할당을 위한 변수로 별도의 제휴신청을 통해 획득할 수 있습니다.

제휴신청을 할 때는 제휴된 서버의 아이피를 체크하므로, 특정 서버에 설치된 미니온 외에 partnerCode 를 입력한다고 해도 적용되지 않습니다.

new Minion({
	id:"example",
	partnerCode:"arzzcom",
	// 이하생략
});

개인채널의 동작방식을 1:1 채팅(여러개의 개인채널을 개설하여, 한명의 유저하고만 대화)이나 1:多채팅(한개의 개인채널을 개설하여, 여러명의 유저와 대화)중 선택할 수 있습니다.

single : 1:1채팅으로 동작

multiple : 1:多c채팅으로 동작

1:1채팅의 경우 개인채널초대시 무조건 새로운 개인채널이 개설되며, 1:多채팅의 경우 개인채널초대시 이미 자신의 개인채널이 있다면 그 채널로 초대됩니다.

미니온은 기본적으로 미니온 스크립트가 적용된 곳에 출력되나, 여러가지 이유로 미니온의 출력부분을 특정 객체로 해야하는 경우 해당 객체의 ID값을 입력하면, 그 객체안에 미니온이 출력되게 됩니다.

<div id="renderArea"></div>

new Minion({
	// 생략
	renderTo:"renderArea"
});

기본적으로 보안코드를 입력하지 않아도, API키가 노출되지 않는다면, 보안상 안전합니다.

하지만, 혹시모를 보안위험에 대비하기 위하여, 각종 보안설정(도메인 제한, 접속시간 제한 등)을 적용하기 위해서는 해당 코드가 설정되어 있어야 합니다.

보안코드의 위변조를 막기위하여 특정한 방법으로 암호화되어야 합니다.

<?php
// 보안코드를 설정하기 위한 함수
// $apiKey는 채널생성시 입력한 10자리의 API키 값입니다.
function GetSecurityCode($apiKey) {
	$thisTime = time(); // Unix Timestamp
	return md5($apiKey.$thisTime).'_'.$thisTime;
}
?>

PHP의 경우 위와 같은 방법으로 보안코드를 생성하며 되며, 다른 언어의 경우에도 같은 방법으로 MD5($apiKey+$unixTimestamp)+"_"+$unixTimestamp; 의 형태로 정의하시면 됩니다.

MD5로 암호화되는 $unixTimestamp 와 암호화되지 않는 $unixTimestamp 의 값은 서로 일치하여야 합니다.

특정언어에 대하여, 보안코드를 생성하는 방법을 잘 모르실 경우, 문의게시판을 통해 문의하여 주시기 바랍니다.

보안코드는 JavaScript나 Html으로는 만들 수 없으므로, 서버스크립트가 지원되지 않는 곳에서는 보안설정을 할 수 없습니다.

new Minion({
	securityCode:"<?php echo GetSecurityCode('1234567890'); ?>",
	// 이하 생략
});

미니온의 스킨코드를 정의합니다. 미니온 스킨코드는 예제미리보기 페이지에서 확인할 수 있습니다.

채팅내용에서 닉네임과 대화내용을 구분하는 문자열을 지정합니다. 이 문자열을 이용하여 채팅내용을 구분합니다.

new Minion({
	// 생략
	splitString:"님의 말 : ",
	// 생략
});

위와 같이 정의할때 닉네임님의 말 : 대화내용 이렇게 채팅내용이 출력됩니다.

미니온의 상태아이콘(온라인, 자리비움, 다른용무중 등)의 경로를 지정합니다.

해당경로에는 반드시 모든 상태에 대한 아이콘이 다음과 같은 이름으로 존재하여야 합니다.

온라인 : online.gif

오프라인 : offline.gif

자리비움 : wait.gif

바쁨 : busy.gif

다른용무중 : otherwork.gif

굵게, 기울임, 밑줄 등 툴바의 버튼의 형태를 정의합니다.

icon : 버튼의 아이콘만 표시합니다.

text : 버튼의 이름만 출력합니다. (굵게, 기울임, 밑줄 등)

icontext : 버튼의 아이콘과 함께 이름을 출력합니다.

미니온의 스킨형태를 결정합니다.

세로형은 접속자목록이 채팅내용 위에 표시되며 가로형은 접속자목록이 채팅내용 우측(또는 스킨에 따라 좌측)에 위치하게 됩니다.

H : 가로형으로 설정합니다.

V : 세로형으로 설정합니다.

new Minion({
	id:"example",
	type:"H"
	// 이하 생략
});

유저신고하기 기능 사용여부를 정의합니다.

true 일 경우 유저신고하기 메뉴가 활성화되며, 반대로 false 일 경우 유저신고하기 메뉴가 활성화되지 않습니다.

기본값은 false 입니다.

채널채팅에서 랜덤채팅에 참여할 수 있도록 툴바에 랜덤채팅 참여 버튼을 출력합니다.

해당버튼을 클릭하여, 언제 어디서든지 랜덤채팅에 참여할 수 있게 됩니다.

유저의 채널접속/접속종료 메세지를 보일 것인지 설정합니다.

기본적으로 true 로 설정되어 있으며, alertLimit 변수값에 의해 메세지를 출력할 유저의 권한을 정의합니다.

true : 채널접속/접속종료 메세지를 보임

false : alertLimit 변수와 무관하게 채널접속/접속종료 메세지를 보이지 않음

채널에 사용자가 있고, 페이지이동등으로 채널에 재접속하였을 경우, 최근에 이루어진 대화 20줄을 불러오도록 설정합니다.

단, 채널에 사용자가 아무도 없을 경우, 최근에 이루어진 대화기록은 자동으로 삭제됩니다.

new Minion({
	viewLog:true,
	// 이하생략
});

온라인, 자리비움, 다른용무중 등 미니온의 상태아이콘이 접속자목록에 나타나는 것을 설정할 수 있습니다.

true : 상태아이콘을 보임

false : 상태아이콘을 숨김

true 로 설정될 경우 접속시 기본적으로 현재 접속자목록을 출력합니다.

false 일 경우 접속시 기본적으로 현재 접속자목록이 숨겨지지만, 유저목록보기 버튼을 클릭하여, 유저목록을 보이게 할 수 있습니다.

100명 이상 접속할 경우, viewUser 값이 true 일지라도 자동적으로 접속자목록이 숨겨지게 됩니다.

유저목록을 기본적으로 출력하지 않을 경우, 시스템 성능에 따라 체감적으로 성능이 향상될 수 있습니다.

new Minion({
	viewUser:true,
	// 이하생략
});

미니온의 가로크기를 픽셀단위로 정의합니다.

미니온4 버전부터 % 단위에 대한 지원이 중지됩니다.

반드시 정확한 픽셀수치를 입력하여 주시기 바랍니다.

new Minion({
	width:200,
	height:500,
	// 이하 생략
});

String sound 에 지정된 호출음을 재생합니다.

new Minion({
	listeners:{
		onConnect:function(minion) {
			minion.playSound("IRCCALL");
		}
	},
	// 생략
});

정의되어 있는 호출음은 아래와 같습니다. 해당 텍스트를 클릭하면 소리를 미리 들어볼 수 있으며, 버전업데이트에 따라 다양한 호출음이 지원될 예정입니다.

IRCCALL

IRCQUERY

MESSAGE

/notice 명령어를 통해, 공지사항이 전달되었을 때 나타나는 레이어를 사용자의 정의에 의해 표시할 수 있습니다.

new Minion({
	id:"example",
	listeners:{
		onConnect:function(minion) {
			minion.printNotice("미니온 채널에 접속하신 것을 환영합니다.");
		}
	}
});

이벤트리스너나 특정상황에서 채팅창에 시스템메세지를 출력해야할 경우 사용합니다.

var minion = new Minion({
	id:"example",
	// 이하 생략
});

minion.printSystem("출력할 메세지");
// 또는 공용클래스를 이용하여,
MinionComponent.get("example").printSystem("출력할 메세지");

미니온 서버로 유저가 마치 대화를 하는 것처럼, 메세지를 보낼 수 있습니다. message 변수가 비어있을 경우, 대화내용입력란의 메세지가 전송됩니다.

var minion = new Minion({
	id:"example",
	// 생략
});

minion.sendMessage("서버로 전송할 메세지");
// 또는 공용클래스를 이용하여
MinionComponent.get("example").sendMessage("서버로 전송할 메세지");

new Minion({
	id:"example",
	// 생략
});

function localFunction() {
	var Minion = MinionComponent.get("example");
	Minion.printSystem("메세지"); // Minion 객체의 모든 Property, Method 를 호출할 수 있습니다.
}

해당 이벤트리스너의 값이 true 일 경우 메세지를 전송하며, false 일 경우 메세지를 전송하지 않습니다.

아래의 예제소스를 참고하시기 바랍니다.

Minion this : 이벤트가 발생한 객체

String msg : 유저가 입력한 메세지

new Minion({
	// 생략
	listeners:{
		beforeSend:function(minion,msg) {
			if (msg == "바보") {
				alert("욕설은 입력할 수 없습니다.");
				return false; // 메세지를 서버로 전송하지 않음
			} else {
				return true; // 메세지를 서버로 전송함
			}
		}
	}
});

Minion this : 이벤트가 발생한 객체

String nickname : 호출한 사람의 닉네임

new Minion({
	// 생략
	listeners:{
		onCall:function(minion,nickname) {
			alert(nickname+"님이 호출하였습니다.");
			// onCall 이벤트의 경우 기본적으로 호출음이 재생되어 집니다만, 이벤트를 재정의 할 경우 기본 호출음이 들리지 않습니다.
			minion.playSound("IRCCALL");
		}
	}
});

Minion this : 이벤트가 발생한 객체

String channel : 참여한 채널명

Object user : 참여한 유저객체

user.nickname:String - 유저의 닉네임

user.nickcon:String - 유저의 닉이미지경로

user.status:String - 유저의 상태

user.info:String - 유저의 부가정보

new Minion({
	// 생략
	listeners:{onConnect:function(minion,channel,user) {
		minion.printSystem(user.nickname+"님! "+channel+"채널에 참여하신 것을 환영합니다.");
	}}
});

Minion this : 이벤트가 발생한 객체

String nickname : 개인채널에 초대한 사람의 닉네임

new Minion({
	// 생략
	listeners:{
		onCall:function(minion,nickname) {
			alert(nickname+"님이 개인채널에 초대하였습니다.");
			// onInvite 이벤트의 경우 기본적으로 호출음이 재생되어 집니다만, 이벤트를 재정의 할 경우 기본 호출음이 들리지 않습니다.
			minion.playSound("IRCQUERY");
		}
	}
});

Minion this : 이벤트가 발생한 객체

Object user : 메세지를 전송한 유저객체

user.nickname:String - 유저의 닉네임

user.nickcon:String - 유저의 닉이미지경로

user.status:string - 유저의 상태

user.info:String - 유저의 부가정보

String msg : 전송되어진 메세지

DateTime time : 메세지가 전송된 시각 (YYYY.MM.DD HH:II:SS)

new Minion({
	// 생략
	listeners:{
		onMessage:function(minion,user,msg,time) {
			minion.playSound("MESSAGE"); // 소리재생
		}
	}
});

Minion this : 이벤트가 발생한 객체

Object user : 메세지를 전송한 유저객체

user.nickname:String - 유저의 닉네임

user.nickcon:String - 유저의 닉이미지경로

user.status:string - 유저의 상태

user.info:String - 유저의 부가정보

String msg : 전송되어진 메세지

DateTime time : 메세지가 전송된 시각 (YYYY.MM.DD HH:II:SS)

new Minion({
	// 생략
	listeners:{
		onPrivMessage:function(minion,user,msg,time) {
			minion.playSound("IRCQUERY"); // 소리재생
		}
	}
});

유저가 메세지를 작성하여 서버로 성공적으로 전송하였을 때 발생합니다. 대화내용 및 유저의 정보를 변수로 받아 이용할 수 있습니다.

new Minion({
	// 생략
	listeners:{
		onSend:function(minion,message,myinfo) {
			if (message == "!나는누구?") {
				minion.sendMessage("나는 "+myinfo.nickname+"입니다.");
			}
		}
	},
	// 생략
});

미니온 최초접속시 서버정보를 불러오는 setup.xml 파일의 경로를 찾을 수 없어 발생하는 에러입니다.

해결방법

소스다운로드 쿠폰을 통한 직접설치의 경우

minion.conf.php 파일을 열어 setup.xml 경로를 재설정합니다.

미니온 API 이용자의 경우

일시적인 서비스 장애입니다. 잠시후 다시 시도해보세요.

해결방법

소스다운로드 쿠폰을 통한 직접설치의 경우

미니온 서버가 정상적으로 구동되고 있는지, 미니온서버의 포트가 방화벽등으로 인해 막혀있지않은지 확인해보세요.

미니온 API 이용자의 경우

일시적인 서비스 장애이거나, 사용자 컴퓨터의 방화벽등으로 인해 미니온 서버에 접속할 수 없는 상황입니다.

미니온 서비스현황에서 서버가 DEAD상태가 아닌지 확인하고, 만약 DEAD가 아니라면 사용자 컴퓨터에서 PING 명령어등을 통해 서버에 응답이 오는지 확인합니다.

또한 미니온은 843 포트와 3121~3129 포트를 사용하므로 해당 포트가 막혀있지 않은지 확인합니다.

해결방법

소스다운로드 쿠폰을 통한 직접설치의 경우

미니온 서버가 정상적으로 구동되고 있는지 확인합니다.

미니온 API 이용자의 경우

일시적으로 사용자가 많이 몰릴경우 발생할 수 있습니다. 잠시후 다시 시도해보세요.

해결방법

소스다운로드 쿠폰을 통한 직접설치의 경우

미니온 서버가 정상적으로 구동되고 있는지, 서버의 843 포트가 활성화되어 있는지 확인해보세요.

미니온 API 이용자의 경우

일시적인 서비스 장애이거나, 사용자 컴퓨터의 방화벽등으로 인해 843포트가 막혀있는지 확인합니다.

해결방법

소스다운로드 쿠폰을 통한 직접설치의 경우

해당에러는 발생하지 않습니다.

미니온 API 이용자의 경우

일시적인 서비스 장애이거나, 서비스 점검등으로 인해 미니온의 모든 서버가 다운된 상태입니다.

공지사항을 참고하여 잠시후 다시 시도해주세요.

해결방법

소스다운로드 쿠폰을 통한 직접설치의 경우

minion.conf.php 에서 채널당 동접자수를 높여주세요.

미니온 API 이용자의 경우