5.1.메신저봇r의 Api 설명

이번 강좌에서는 메신저봇r의 Api들에 대해 알아보겠습니다.

 

우선 표를 통해 어떤 것들이 있는지 알아봅시다.

이름	설명
Api.getContext()	앱의 컨텍스트를 가져옵니다. (전 단 1번도 써본적이 없네요.)
Api.reload("스크립트이름.js") 또는 Api.compile("스크립트이름.js")	해당 스크립트를 컴파일합니다. 참고로 소괄호 안을 비워놓을 시 모든 스크립트들을 컴파일합니다.
Api.prepare("스크립트이름.js")	해당 스크립트가 단 한번도 컴파일 된 적 없을 경우에만 컴파일합니다. 컴파일 중 에러가 발생하면 에러를 던지고, 해당 이름의 스크립트가 존재하지 않을 시 0을, 컴파일에 성공하면 1을 반환하며, 해당 스크립트가 이미 컴파일 된 적이 있을시엔 2를 반환합니다.
Api.unload("스크립트이름.js")	해당 스크립트를 컴파일되지 않은 상태로 만듭니다.
Api.off("스크립트이름.js")	해당 스크립트의 전원을 끕니다. 소괄호 안을 비울 시 모든 스크립트의 전원을 끕니다.
Api.on("스크립트이름.js")	해당 스크립트의 전원을 켭니다. 소괄호 안을 비울 시 모든 스크립트의 전원을 켭니다.
Api.isOn("스크립트이름.js")	해당 스크립트의 전원이 켜져 있는지 확인하여 반환합니다. 켜져 있다면 true 를, 꺼져 있다면 false 를 반환합니다.
Api.isCompiled("스크립트이름.js")	해당 스크립트의 컴파일 상태를 확인하여 반환합니다. 켜져있다면 true 를, 꺼져있다면 false 를 반환합니다.
Api.isCompiling("스크립트이름.js")	해당 스크립트가 컴파일 중인지 그 여부를 반환합니다. 컴파일 중이라면 true 를, 아니라면 false 를 반환합니다.
Api.getScriptNames()	모든 스크립트들의 이름을 반환합니다.
Api.replyRoom("방이름","내용")	해당 방에 내용을 전송합니다. 사실 그냥 replier.reply("방이름","내용") 을 쓰는 걸 추천합니다. (안정성 문제)
Api.canReply("방이름")	해당 방에 메시지를 보낼 수 있는지 확인하여 가능하다면 true 를, 불가능하다면 false를 반환합니다.
Api.showToast("제목","내용")	화면에 토스트 메시지를 띄웁니다.
Api.makeNoti("제목","내용",id값)	알림창에 알림을 띄웁니다. id값을 안 쓰고 그냥 Api.makeNoti("제목","내용") 만 해도 상관없지만, id값이 게속 달라지게 하면 새 알림이 이전의 알림을 대체하지 않고, 여러개가 같이 나타납니다.
Api.papagoTranslate("번역할 언어코드","번역결과의 언어코드","내용")	파파고 번역을 합니다. 모든 메신저봇 유저들의 총합 사용횟수가 10000회로 제한되어 있기에 남발하는 것은 심한 민폐입니다. 언어코드에 관해서는 https://developers.naver.com/docs/papago/papago-nmt-api-reference.md 을 참고하시면 되겠습니다.
Api.gc()	가비지 컬렉팅을 강제로 시작합니다.

(개수는 많지만 사실 특정 몇 개만 자주 쓰인다는 사실은 안 비밀)

(스크립트 이름 뒤에 .js 는 생략해도 상관없습니다.)

 

설명은 이 정도면 충분할 테고, 사용법 자체도 보통 아래와 같습니다.

if(조건){
  Api.이름();
}

라고 던지고 도망가면 양심없으니 다음 강좌에선 메신저봇의 Api들의 예제로 찾아뵙겠습니다.

 

모두 건강하시기 바랍니다.

감사합니다.