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

코드 기반 통합 - 기본 제어

Flutter 애플리케이션 코드에서 NetFUNNEL 함수를 호출하여 진입 속도를 제어합니다.

통합 방법

기본 제어는 코드 기반 통합에서 사용할 수 있는 두 가지 제어 유형 중 하나입니다. 구간 제어와 비교하고 사용 사례에 가장 적합한 접근 방식을 선택하려면 통합 방법 개요를 참조하세요.

상세 설명

기본 제어의 작동 방식, 최적 용도, 사용 사례 등에 대한 자세한 내용은 공통 가이드 문서의 "코드 기반 통합 - 기본 제어" 섹션을 참조하세요.

사전 요구사항​

세그먼트 생성​

  1. NetFUNNEL 콘솔 → Projects → Segment로 이동
  2. + 버튼을 클릭하여 새 세그먼트 생성
  3. Basic Control을 선택하고 Next 클릭
  4. 세그먼트 이름 입력 및 설정 완료

세그먼트 생성에 대한 자세한 내용은 기본 제어 세그먼트 문서를 참조하세요.

시작 함수​

함수명: nfStart

설명: 대기를 적용하고 싶은 지점에서 함수를 호출하여 키를 발급하고 대기실을 노출시킵니다.

파라미터:

파라미터타입설명
projectKeyString콘솔의 기본 제어 프로젝트 키
segmentKeyString콘솔의 기본 제어 세그먼트 키
callbackNetfunnelCallback대기실 이벤트 처리를 위한 사용자 정의 콜백 함수
contextBuildContext대기실을 적용시키는 화면의 BuildContext

예제:

import 'package:netfunnel_flutter/netfunnel_flutter.dart';
import 'package:flutter/material.dart';

class NetfunnelHandler extends NetfunnelCallback {
  @override
  void onSuccess(int statusCode, String message) {
    // 대기열 통과 시 처리할 로직
  }

  @override
  void onError(int statusCode, String message) {
    // 에러 발생 시 처리할 로직
  }

  @override
  void onNetworkError(int statusCode, String message) {
    // 네트워크 에러 발생 시 처리할 로직
  }

  @override
  void onBlock(int statusCode, String message) {
    // 사용자 진입 차단 시 처리할 로직
  }

  @override
  void onClose(int statusCode, String message) {
    // 사용자가 대기를 취소한 경우 처리할 로직
  }
}

void handleButtonPress(BuildContext context) {
  Netfunnel.instance.nfStart(
    projectKey: '{{PROJECT_KEY}}',
    segmentKey: '{{SEGMENT_KEY}}',
    callback: NetfunnelHandler(),
    context: context,
  );
}
콜백 함수 구현

콜백 함수의 구현 방법은 콜백 함수 섹션을 참조하세요.

종료 함수​

함수명: nfStop

설명: 진입을 완료한 후 키 반납을 위해 사용합니다.

종료 함수를 실행하지 않으면 세그먼트의 타임아웃 설정에 따라 자동으로 반납 처리합니다.

파라미터:

파라미터타입설명
projectKeyString콘솔의 기본 제어 프로젝트 키
segmentKeyString콘솔의 기본 제어 세그먼트 키

예제:

Netfunnel.instance.nfStop(
  projectKey: '{{PROJECT_KEY}}',
  segmentKey: '{{SEGMENT_KEY}}',
);

관련 문서​