Flutter Agent
📄️ 빠른 시작
이 빠른 시작 가이드로 5-10분 안에 NetFUNNEL 4 Flutter Agent를 시작하세요.
📄️ 설치 및 초기화
NetFUNNEL Flutter 에이전트 설치 및 초기화 가이드입니다.
🗃️ 통합 방법
2 항목
📄️ 초기화 설정
이 문서는 Netfunnel.instance.initialize() 함수에서 사용할 수 있는 모든 초기화 설정을 설명합니다.
📄️ API 참조
NetFUNNEL Flutter Agent 함수, 콜백 및 응답 형식에 대한 완전한 참조입니다.
📄️ 문제 해결
NetFUNNEL Flutter Agent 통합에 대한 일반적인 문제, 해결 방법 및 자주 묻는 질문입니다.
개요
Flutter Agent는 Flutter 애플리케이션에서 NetFUNNEL 4 트래픽 제어 기능을 제공하는 클라이언트 측 SDK입니다.
주요 기능
- 클라이언트 측 SDK: Flutter 애플리케이션에 직접 통합
- 코드 기반 통합: 버튼 클릭, API 호출 등 정확한 제어
- 네이티브 대기실: WebView 기반 대기실 템플릿
- 실시간 대기열 업데이트: 대기 위치, 대기 시간, 진행률 정보 제공
- 네트워크 복구: 네트워크 문제 시 자동 복구
- 강력한 오류 처리: 포괄적인 콜백 시스템
- 경량 SDK: 최소한의 의존성
시스템 요구사항
- Flutter: 3.0.0 이상
- Dart: 3.0.0 이상
호환 환경
- Flutter 애플리케이션: iOS 및 Android 네이티브 앱
- 하이브리드 앱: Flutter 기반 하이브리드 애플리케이션
작동 방식
- SDK 초기화: NetFUNNEL을 초기화하고 설정 구성
- 코드 기반 통합:
nfStart및nfStop함수를 사용하여 트래픽 제어 - 대기실 표시: WebView 기반 대기실이 자동으로 표시됨
에이전트 동작 흐름
대기 전: 페이지 로드 → 에이전트 초기화 → 트리거 규칙 매치
대기 중: 넷퍼넬 서버 요청 → 넷퍼넬 키 발급 → 대기실 페이지로 이동
대기 후: 서비스 페이지 진입 → 넷퍼넬 키 반납
통합 방법
코드 기반 통합
코드 기반 통합은 두 가지 제어 유형을 지원합니다:
- 기본 제어: 진입 속도 제어
- 구간 제어: 특정 구간에서 동시 사용자 수 유지
통합 방법 선택
기본 제어와 구간 제어를 비교하고 사용 사례에 가장 적합한 접근 방식을 선택하려면 통합 방법 개요를 참조하세요.
제한 사항
URL-Triggered 통합 미지원
Flutter Agent는 URL-Triggered 통합을 지원하지 않습니다. 코드 기반 통합만 사용할 수 있습니다.
빠른 시작
Flutter Agent를 빠르게 시작하려면 빠른 시작 가이드를 참조하세요.
샘플 프로젝트
연습용 기본 프로젝트가 필요하신가요? 샘플 프로젝트를 확인하세요.
문서
핵심 문서
- 빠른 시작: 기본 예제로 5-10분 안에 시작하기
- 설치 및 초기화: 의존성 및 설정에 대한 상세 가이드
- 통합 방법: 기본 제어와 구간 제어 비교
- API 참조: 완전한 함수 사양, 콜백 및 응답 형식
- 초기화 설정: 모든 초기화 매개변수 및 사용법
- 문제 해결: 일반적인 문제, 해결 방법 및 FAQ
구현 가이드
관련 콘텐츠
- Android Agent: Android SDK 통합 가이드
- iOS Agent: iOS SDK 통합 가이드
- 샘플 프로젝트: 바로 사용할 수 있는 프로젝트 템플릿