• 레퍼런스
  • 자습서

    • 시작하기

    요구사항

    Iris를 사용하기 위해 아래의 사항이 요구됩니다.

    • 카카오톡이 설치되어 있는 Android 기기.
    • Android 버전 및 보안 설정에 따라 카카오톡 데이터베이스 및 일부 시스템 서비스에 접근하기 위한 Root 권한.
    • Iris와 상호작용하기 위한 HTTP 서버.

    설치

    1. Github release에서 최신 버전의 Iris.apk와 iris_control을 다운로드합니다. Windows를 사용할 경우, iris_control 대신 iris_control.ps1을 다운로드합니다.
    2. adb를 사용해 Iris.apk를 Android 환경(/data/local/tmp)에 복사합니다.
    adb push Iris.apk /data/local/tmp
    1. 운영체제에 따라 적절한 방법을 택해 APK 파일을 실행합니다.
    Windows
    Mac/Linux

    아래 명령어를 사용해 Iris를 실행할 수 있습니다.

    ./iris_control.ps1 install
./iris_control.ps1 start

    iris_control을 실행가능한 상태로 만듭니다.

    chmod +x iris_control

    아래 명령어를 사용해 Iris를 실행할 수 있습니다.

    ./iris_control install
./iris_control start

    iris_control은 이외에도 status, stop, install_redroid을 제공합니다.

    구성

    http://[ANDROID_IP]:3000/dashboard에 접속해 설정을 진행합니다. 구성 옵션은 다음과 같습니다.

    Bot Namestring

    봇의 이름입니다. 봇을 식별하기 위해 사용됩니다.

    Web Server Endpointstring

    새로운 카카오톡 메시지를 수신할 웹 서버의 URL입니다. (예: http://172.17.0.2:5000/db for IrisPy)

    DB Polling Rateint · 선택적

    데이터베이스 변경 사항을 확인하는 지연 시간(밀리초; ms)입니다. (예: 200)

    주의

    값이 낮을수록 데이터베이스의 변경 사항을 더 빈번하게 확인해 CPU 사용량이 증가할 수 있습니다.

    기본값:
    Message Send Rateint · 선택적

    카카오톡 메시지 전송 간 최소 간격(밀리초; ms)입니다. (예: 100)

    기본값:
    Bot Portint

    HTTP 서버가 수신 대기할 포트 번호입니다. (예: 3000)