メインコンテンツまでスキップ
バージョン: 4.6.1-saas

コードベース統合 - 区間制御

アプリケーションの特定の区間で同時接続者数を一定の値で維持するように制御する機能です。開始関数呼び出し時にキーを発行し、終了関数を呼び出すまではユーザーが活動区間にいると判断して次の待機者を進入させません。 終了関数を呼び出すとキーを返却し、次の待機者が進入できるようになります。

統合方法

区間制御は、コードベース統合で使用できる2つの制御タイプの1つです。基本制御と比較し、ユースケースに最も適したアプローチを選択するには、統合方法概要を参照してください。

詳細説明

区間制御の動作方法、最適な用途、ユースケースなどの詳細については、共通ガイドドキュメントの「コードベース統合 - 区間制御」セクションを参照してください。

開始関数​

関数名: nfStartSection

説明: 待機を適用したいポイントで関数を呼び出してキーを発行し、待機室を表示します。

パラメータ:

パラメータ型説明
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 handleSectionStart(BuildContext context) {
  Netfunnel.instance.nfStartSection(
    projectKey: '{{PROJECT_KEY}}',
    segmentKey: '{{SEGMENT_KEY}}',
    callback: NetfunnelHandler(),
    context: context,
  );
}
コールバック関数の実装

コールバック関数の実装方法については、コールバック関数セクションを参照してください。

終了関数​

関数名: nfStopSection

説明: 進入が完了した後、キー返却のために使用します。

終了関数を実行しない場合、ユーザーが活動区間に継続して残っていると見なされ、次の待機者の進入が遅延する可能性があります。

パラメータ:

パラメータ型説明
projectKeyStringコンソールの区間制御プロジェクトキー
segmentKeyStringコンソールの区間制御セグメントキー

例:

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

関連ドキュメント​