본문으로 건너뛰기
버전: 4.6.1

Android 에이전트

개요​

Android 에이전트는 Android 애플리케이션을 위한 NetFUNNEL 트래픽 제어 기능을 제공하는 네이티브 Android SDK입니다. Android 앱 코드에 직접 통합하여 큐 관리 및 대기실 기능을 구현하고, 서버 부하를 분산하며 트래픽이 많은 기간 동안 안정적인 사용자 경험을 보장합니다.

주요 기능​

  • 네이티브 Android SDK: 간단한 API 호출로 Android 앱 코드에 직접 통합
  • 두 가지 제어 방식: 기본 제어(진입 속도 제한)와 구간 제어(동시 사용자 관리) 중 선택
  • 전용 API: 기본 제어는 nfStart()/nfStop() 사용, 구간 제어는 nfStartSection()/nfStopSection() 사용
  • 네이티브 대기실: 커스터마이징 가능한 UI 옵션을 갖춘 WebView 기반 대기실 템플릿
  • 실시간 큐 업데이트: 실시간 대기 순번, 대기 시간 및 진행 정보 수신
  • 네트워크 복구: 사용자 경험 유지를 위한 네트워크 문제 자동 복구
  • 강력한 오류 처리: 스마트 오류 처리 전략을 갖춘 포괄적인 콜백 시스템
  • 경량 SDK: Ktor 및 Kotlinx Serialization을 사용한 최소한의 의존성
  • Android 생명주기 통합: Activity 생명주기 및 Android 컴포넌트와의 원활한 통합

시스템 요구사항​

  • Android API Level: 22+ (Android 5.1 Lollipop 이상)
  • Java: 1.8 이상
  • Kotlin: 1.9.0 이상 (Kotlin 기반 프로젝트의 경우)
  • 의존성: Ktor 2.1.0+ (< 3.0.0), Kotlinx Serialization

호환 환경​

  • 네이티브 Android 앱: 전체 SDK 통합을 지원하는 Java/Kotlin 기반 Android 애플리케이션
  • 하이브리드 앱: 네이티브 Android 컴포넌트를 포함한 애플리케이션 (WebView 콘텐츠는 이 SDK로 보호되지 않음)
  • 모든 Android 빌드 유형: ProGuard/R8 지원을 포함한 디버그 및 릴리스 빌드

작동 방식​

Android SDK는 앱의 생명주기와 원활하게 통합됩니다:

  1. SDK 초기화: Application 클래스에서 NetFUNNEL SDK 초기화
  2. 네이티브 통합: Android Activities/Fragments에서 기본 제어는 nfStart(), 구간 제어는 nfStartSection() 호출
  3. WebView 대기실: SDK가 WebView 기반 대기실 표시 (기본 템플릿 또는 사용자 정의 UI)
  4. 큐 관리: NetFUNNEL 서버가 대기 순번 및 입장을 자동으로 처리
  5. 키 반환: 사용자가 작업을 완료하면 기본 제어는 nfStop(), 구간 제어는 nfStopSection() 호출

제어 흐름 예시​

기본 제어 흐름:

사용자 작업 → nfStart() → 대기실 → onSuccess() → 사용자 진행 → nfStop()

구간 제어 흐름:

사용자 작업 → nfStartSection() → 대기실 → onSuccess() → 사용자 구간 내 → nfStopSection()

중요한 제한사항​

하이브리드 앱 제한사항
  • WebView 콘텐츠: 이 SDK는 WebView 콘텐츠(HTML/JavaScript 페이지)를 보호하지 않습니다
  • 네이티브 컴포넌트만: 트래픽 제어는 네이티브 Android 컴포넌트(Activities, Fragments 등)에만 적용됩니다
  • 웹/JavaScript 에이전트: WebView 기반 콘텐츠의 경우 JavaScript 에이전트를 대신 사용하세요

시작하기​

Android 에이전트를 빠르게 시작하려면 빠른 시작 가이드를 참조하세요.

연습 프로젝트 제공

연습용 기본 프로젝트가 필요하신가요? NetFUNNEL SDK 통합 연습을 위한 Android 애플리케이션 (단일 Activity) 템플릿을 포함한 샘플 프로젝트를 확인해보세요.

문서​

핵심 문서​

구현 가이드​