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

iOS 에이전트

개요​

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

주요 기능​

  • 네이티브 iOS SDK: 간단한 API 호출로 iOS 앱 코드에 직접 통합
  • 두 가지 제어 방법: 기본 제어(진입 속도 제한)와 구간 제어(동시 사용자 관리) 중 선택
  • 전용 API: 기본 제어는 nfStart()/nfStop()을 사용하고, 구간 제어는 nfStartSection()/nfStopSection()을 사용
  • 네이티브 대기실: 사용자 정의 UI 옵션이 있는 WebView 기반 대기실 템플릿
  • 실시간 대기열 업데이트: 실시간 대기 순번, 대기 시간 및 진행 정보 수신
  • 네트워크 복구: 네트워크 문제로부터 자동 복구하여 사용자 경험 유지
  • 견고한 에러 처리: 스마트 에러 처리 전략을 갖춘 포괄적인 델리게이트 시스템
  • 경량 SDK: 네이티브 iOS 프레임워크로 최소한의 의존성
  • iOS 생명주기 통합: ViewController 생명주기 및 iOS 구성 요소와의 원활한 통합

시스템 요구 사항​

  • iOS: 12.0 이상
  • Xcode: 12.0 이상
  • Swift: 5.0 이상
  • Objective-C: 기존 Objective-C 프로젝트와 호환
  • UI 프레임워크: Storyboard (Objective-C/Swift) 또는 SwiftUI

호환 가능한 환경​

  • 네이티브 iOS 앱: 전체 SDK 통합이 있는 Swift/Objective-C 기반 iOS 애플리케이션
  • 하이브리드 앱: 네이티브 iOS 구성 요소가 있는 애플리케이션 (WebView 콘텐츠는 이 SDK로 보호되지 않음)
  • 모든 iOS 빌드 유형: 전체 최적화 지원이 있는 디버그 및 릴리스 빌드

작동 방식​

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

  1. SDK 초기화: AppDelegate에서 NetFUNNEL SDK 초기화
  2. 네이티브 통합: ViewController에서 기본 제어를 위해 nfStart() 또는 구간 제어를 위해 nfStartSection() 호출
  3. WebView 대기실: SDK가 WebView 기반 대기실 표시 (기본 템플릿 또는 사용자 정의 UI)
  4. 대기열 관리: NetFUNNEL 서버가 대기 순번 및 허용을 자동으로 처리
  5. 키 반환: 사용자가 작업을 완료하면 기본 제어를 위해 nfStop() 또는 구간 제어를 위해 nfStopSection() 호출

제어 흐름 예제​

기본 제어 흐름:

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

구간 제어 흐름:

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

중요한 제한 사항​

하이브리드 앱 제한 사항
  • WebView 콘텐츠: 이 SDK는 WebView 콘텐츠(HTML/JavaScript 페이지)를 보호하지 않습니다
  • 네이티브 구성 요소만: 트래픽 제어는 네이티브 iOS 구성 요소(ViewControllers 등)에만 적용됩니다
  • Web/JavaScript 에이전트: WebView 기반 콘텐츠의 경우 JavaScript 에이전트를 대신 사용하세요
연습 프로젝트 제공

연습할 기본 프로젝트가 필요하신가요? NetFUNNEL SDK 통합 연습을 위한 iOS 애플리케이션 (Single ViewController) 템플릿을 포함한 샘플 프로젝트를 확인하세요.