(편의상 반말체로 작성하였습니다.)
이 글은 나이트봇을 조금이라도 더 능숙하게 사용하고 싶은 매니저들을 위해 작성되었어.
이해 안되는 게 있으면 얼마든지 댓글로 물어봐!
일단 모두에게 친숙한 명령어인 !uptime을 보자.
$(twitch $(channel) "{{uptimeLength}}")
!uptime 명령어에는 2개의 변수와 1개의 인자가 사용돼.
$(twitch) 변수에 대한 설명을 보면 '특정 트위치 계정에 대한 다양한 정보를 표시할 수 있습니다.'라고 되어있어.
여기서 말하는 '다양한 정보'에는 방제(title), 카테고리(game), 구독자(subscriberCount), 시청자(viewers), 팔로워(followers) 수 등이 있어.
위의 uptimeLength(생방송 중인 시간)도 그중 하나고.
그리고 $(channel) 변수는 스트리머의 id를 반환해 줘.
예를 들어 삐라 님 채팅방에서 해당 변수를 사용하면 bbira를 반환하지.
이제 사용법을 알아보자.
$(twitch username "formatted string")
username에 트위치 id를, formatted string에 인자를 넣어주면 돼.
id는 bbira처럼 직접 입력해도 되고 id를 반환해주는 변수($(user), $(channel))를 사용해도 돼.
* $(user) 변수는 명령어를 사용한 사람의 id를 반환함.
인자는 표시할 정보의 인자를 입력하면 되는데 예를 들어 설명하자면
$(twitch $(channel) "{{displayName}} 님의 방제는 {{title}}이고 카테고리는 {{game}}입니다.")
결과 : 삐라 님의 방제는 삐 라 소 통이고 카테고리는 Talk Shows입니다.
$(twitch $(channel) "{{displayName}} 님의 구독자 수 {{subscriberCount}}명, 시청자 수 {{viewers}}명, 팔로워 수 {{followers}}명입니다.")
결과 : 삐라 님의 구독자 수 68명, 시청자 수 0명, 팔로워 수 6,397명입니다.
위와 같다.
참고로 subscriberCount 인자는 구독 기능이 활성화되어있지 않은 스트리머는 사용할 수 없고 타 스트리머의 구독자 수를 확인하기 위한 용도로 사용할 수 없어.
각각 아래와 같은 오류 메시지를 출력하거든.
Channel does not have subscriptions. / Only the current channel's subscribers count can be checked.
그리고 2번째 예의 시청자 수가 0명인 이유는 현재 방송상태가 오프라인이기 때문이야.
twitch 변수에서 사용할 수 있는 인자의 전체 목록은 여기에서 볼 수 있어.
두 번째로 볼 건 $(countdown) 변수야.
카운트다운이 뭔지 모르는 사람은 없을 테니 바로 사용법을 알아보자.
$(countdown date/time)
$(countdown time)
각각 날짜와 시간을 입력하면 되는데 형식은 아래와 같다.
MM DD YYYY HH:MM:SS AM/PM TZ
HH:MM:SS AM/PM TZ
MM 월, DD 일, YYYY 년, HH 시, MM 분, SS 초, AM 오전, PM 오후, TZ 타임존
삐라 님 생일(9월 27일)을 기준으로 설명하자면...
$(countdown 09 27 2017 12:00:00 AM Asia/Seoul)
결과 : 5 months 20 days 6 hours 8 minutes 4 seconds
타임존 목록은 여기를 보면 된다.
세 번째로 볼 건 $(time) 변수.
이 변수는 현재 시각을 반환해 줘.
그리고 반환된 값의 표시 형식을 사용자가 지정할 수 있어.
$(time timezone "formatted time")
timezone은 위에서 봤던 $(countdown) 변수의 TZ와 같은거고
formatted time에는 표시 형식을 입력하면 되는데 간단한 예로 살펴보자면
$(time America/New_York "미국 뉴욕 현지 시각은 YYYY년 MM월 DD일 HH시 mm분 ss초입니다.")
결과 : 미국 뉴욕 현지 시각은 2017년 04월 07일 02시 49분 10초입니다.
$(time Asia/Seoul "(a h시 m분)")
결과 : (pm 2시 57분)
표시 형식에 대해 자세히 알고 싶다면 여기를 참고하도록 해.
마지막은 !commands에 대한 거야.
!commands add !command_name -ul=userlevel -cd=cooldown -a=!alias command response
!command_name, command response 이 두 개는 모르는 사람이 없을 테니 넘어가고
-ul=userlevel 해당 명령어를 사용할 수 있는 사용자 레벨을 설정할 수 있어.
everyone(모두), subscriber(구독자), regular(?), moderator(매니저), owner(스트리머)
구독자 전용 명령어를 만들거나 특정 명령어의 사용을 막고자 할 때 사용하면 돼.
-cd=cooldown 재사용 대기시간(cooltime)이야.
쿨타임 모르는 사람 없지? 최솟값 5에 최댓값 300이고 단위는 초(second)야.
-a=!alias 이건 다른 명령어를 호출할 때 사용하는 건데 예를 들어서 설명해줄게.
!commands add !삐라좋아 내는 그짓말하는 사람이 제일 싫다
!commands add -a=!삐라좋아 !삐라싫어 니 내 좋은거 다 안다.
위와 같이 명령어를 추가하고 !삐라싫어를 호출하면 어떤 결과가 나올까?
결과 : 내는 그짓말하는 사람이 제일 싫다
결과를 보면 알겠지만 -a 옵션을 사용할 경우 해당 명령어의 command response는 무시되고 옵션에 의해 호출된 명령어의 것이 표시돼.
그래서 '이 옵션을 언제 사용해야 하는가?'라는 의문을 가질 수 있는데 내 경우는 command response가 동일한 명령어들을 정리하거나 기본 명령어들(!commands, !game 등)을 한글로 바꿀 때 사용하고 있어.
!commands add !추가 -ul=moderator -a=!commands add $(query)
!commands add !편집 -ul=moderator -a=!commands edit $(query)
!commands add !삭제 -ul=moderator -a=!commands delete $(query)
위와 같이 명령어를 추가하고 나면 !추가, !편집, !삭제로 명령어를 추가, 편집, 삭제할 수 있어.
* $(query) 변수에 대해서는 다음에 설명할게. 피곤하드앙...
삐라