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

코드 기반 통합 - 구간 제어

애플리케이션의 특정 구간에서 동시 접속자 수를 일정한 값으로 유지하도록 제어하는 기능입니다. 시작 함수 호출 시 키를 발급하고, 종료 함수를 호출하기 전까지는 유저가 활동 구간에 있는 것으로 판단하여 다음 대기자를 진입시키지 않습니다. 종료 함수를 호출하면 키를 반납하고 다음 대기자가 진입하게 됩니다.

통합 방법

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

상세 설명

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

시작 함수​

함수명: nfStartSection

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

파라미터:

파라미터타입설명
projectKeyString콘솔의 구간 제어 프로젝트 키
segmentKeyString콘솔의 구간 제어 세그먼트 키
callbackFunction대기실 이벤트 처리를 위한 사용자 정의 콜백 함수

예제:

import Netfunnel from 'netfunnel-rn-agent';

Netfunnel.nfStartSection("{{PROJECT_KEY}}", "{{SEGMENT_KEY}}", function(response) {
  // TODO: response에 따라 상황에 맞는 콜백 함수를 구현합니다.
  nfCallback(response);
});
콜백 함수 구현

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

종료 함수​

함수명: nfStopSection

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

종료 함수를 실행하지 않으면 유저가 활동 구간에 계속 남아있는 것으로 간주되어 다음 대기자의 진입이 늦춰질 수 있습니다.

파라미터:

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

예제:

Netfunnel.nfStopSection("{{PROJECT_KEY}}", "{{SEGMENT_KEY}}");

관련 문서​