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

コードベース統合 - 基本制御

FlutterアプリケーションコードでNetFUNNEL関数を呼び出して進入速度を制御します。

統合方法

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

詳細説明

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

前提条件​

セグメント作成​

  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}}',
);

関連ドキュメント​