이 트위터 봇은 Node.js로 돌아갑니다. 멘션을 하면 한화로 바꿔 답해줍니다. 기본적으로는 Free Currency Converter(FCC)의 API를 사용하고 있지만, 후술할 특정 형식을 갖춘 환율 API라면 무엇이든지 사용이 가능합니다.
1시간마다 헤더 이미지도 현재 환율로 업데이트해 줍니다. ImageMagick이 설치되어 있어야 합니다.
아직 코드가 정리되어 있지 않습니다.
프로젝트 루트에 .env 파일을 만들어서 아래 정보를 입력해주세요. 전부 필수입니다. (파일명이 그냥 .env입니다)
BOT_SCREEN_NAME= (봇의 트위터 계정 이름, @을 제외하고)
CONSUMER_KEY= (트위터 API 소비자 키)
CONSUMER_SECRET= (트위터 API 소비자 비밀번호)
ACCESS_TOKEN_KEY= (트위터 API 접근 키)
ACCESS_TOKEN_SECRET= (트위터 API 접근 비밀번호)
HEADER_TEMPLATE_FILE_NAME= (헤더 템플릿 이미지 이름)
HEADER_TEMPLATE_FONT_NAME= (헤더 템플릿에 사용될 폰트 이름)봇을 한 번 실행하면 /modules/auto_xchange/config.json이 자동 생성됩니다. "default" 부분을 수정해 지원하는 화폐를 추가, 수정, 삭제할 수 있습니다.
{
"code": "USD",
"criteria": ["usd", "dollar", "달러", "딸라", "$", "사달라", "사딸라"],
"name": "달러",
"screen": "달러는",
"prefix": "💵",
"psuedo": false,
"material": false,
"endpoint": "fcc"
}code: 화폐 코드. FCC 혹은 Korbit에서 환전을 하는 데 쓰입니다.criteria: 환전 조건 문자열. 이 문자열이 들어가 있는 멘션은 이 화폐를 환전하라는 것으로 생각합니다.name: 화폐 이름.screen: 답글 트윗에 보이게 될 문맥에 맞는 화폐 이름.prefix: 답글 트윗 앞에 붙일 문자열. 꼭 이모지가 아니어도 괜찮습니다만 이미지를 첨부하는 것보다야 이모지 하나가 더 나을 수도 있습니다.psuedo:true면 환전을 한 이후에 미리 정해진 조건에 따라 계산을 합니다.false면 그냥 환전만 합니다. 보통 게임 내 가상 재화를 처리할 때true로 설정합니다.material:true면 물질으로 취급합니다.false면 통화로 취급합니다.true로 설정할 경우 g, kg 등의 단위를 인식하며, 출력되는 메시지가 조금 다릅니다endpoint: 사용할 API. 후술할"endpoints"에서 관리할 수 있습니다.
{
"code": "STAR_JEWEL",
"criteria": ["쥬얼", "주얼", "ジュエル"],
"name": "스타 쥬얼",
"screen": "데레스테 스타 쥬얼은",
"prefix": "🌟",
"psuedo": true,
"material": false,
"original_code": "JPY",
"origin": "아이돌마스터 신데렐라 걸즈 스타라이트 스테이지",
"origin_short": "데레스테",
"origin_aliases": ["데레스테"],
"calculate": "if (value < 360) { value / 0.5 * 1.1 } else if (value < 760) { value / 0.75 * 1.1 } else if (value < 1300) { value / 0.79 * 1.1 } else if (value < 2650) { value / 0.81 * 1.1 } else if (value < 4200) { value / 0.83 * 1.1 } else if (value < 8400) { value / 0.84 * 1.1 } else { value / 0.86 * 1.1 }",
"endpoint": "fcc"
}original_code: 게임 내 가상 재화 등의 기반 화폐 코드.origin: 출처가 되는 게임의 정식 명칭.origin_short: 출처가 되는 게임의 대표 약칭.origin_aliases: 출처가 되는 게임의 약칭들.calculate: 가상 재화 계산 식.value가 가상 재화의 개수입니다. 사칙연산뿐만 아니라 함수도 쓸 수 있습니다. 복잡한 코드를 짜는 것도 가능합니다.
criteria의 검사 순서는 긴 조건부터 짧은 조건으로입니다. config 내에서의 순서는 중요하지 않습니다.
"endpoints" 부분을 사용해 사용하고 싶은 환율 API 엔드포인트를 추가, 수정, 삭제할 수 있습니다. 단, "default"에서 선언된 화폐 코드들을 읽을 수 있는 API여야 히고, JSON을 반환해야 합니다. 예를 들어, fcc API는 미국 달러로 usd를 인식합니다.
{
"code": "fcc",
"url": "http://free.currencyconverterapi.com/api/v3/convert?q=$from_$to&compact=y",
"value": "exchangeData[Object.keys(exchangeData)[0]].val"
}code: API alias. 여기에서 선언된 alias는"default"에서 쓸 수 있습니다.url: API 엔드포인트.$from부분이 출발할 화폐 코드,$to부분이 도착할 화폐 코드가 들어가는 곳입니다.value: 반환된 JSON에서 환율의 위치. 반환된 JSON의 변수명이exchangeData라고 할 때 환율에 액세스할 수 있는 JS 코드를 작성합니다.