コードベース統合 - 区間制御
アプリケーションの特定の区間で同時接続者数を一定の値に維持するように制御する機能です。開始関数呼び出し時にキーを発行し、終了関数を呼び出すまではユーザーが活動区間にあると判断して次の待機者を進入させません。 終了関数を呼び出すとキーを返却し、次の待機者が進入します。
統合方法
区間制御は、コードベース統合で使用できる2つの制御タイプの1つです。基本制御と比較し、ユースケースに最も適したアプローチを選択するには、統合方法概要を参照してください。
詳細説明
区間制御の動作方法、最適な用途、ユースケースなどの詳細については、共通ガイドドキュメントの「コードベース統合 - 区間制御」セクションを参照してください。
開始関数
関数名: nfStartSection
説明: 待機を適用したいポイントで関数を呼び出してキーを発行し、待機室を表示します。
パラメータ:
| パラメータ | 型 | 説明 |
|---|---|---|
projectKey | String | コンソールの区間制御プロジェクトキー |
segmentKey | String | コンソールの区間制御セグメントキー |
callback | Function | 待機室イベント処理のためのカスタムコールバック関数 |
例:
import Netfunnel from 'netfunnel-rn-agent';
Netfunnel.nfStartSection("{{PROJECT_KEY}}", "{{SEGMENT_KEY}}", function(response) {
// TODO: レスポンスに応じて状況に適したコールバック関数を実装します。
nfCallback(response);
});
コールバック関数の実装
nfCallback関数の実装方法については、コールバック関数セクションを参照してください。
終了関数
関数名: nfStopSection
説明: 進入が完了した後、キー返却のために使用します。
終了関数を実行しない場合、ユーザーが活動区間に継続して残っていると見なされ、次の待機者の進入が遅れる可能性があります。
パラメータ:
| パラメータ | 型 | 説明 |
|---|---|---|
projectKey | String | コンソールの区間制御プロジェクトキー |
segmentKey | String | コンソールの区間制御セグメントキー |
例:
Netfunnel.nfStopSection("{{PROJECT_KEY}}", "{{SEGMENT_KEY}}");
関連ドキュメント
- 共通ガイド: 区間制御の詳細な説明
- 基本制御: 単一段階作業用
- APIリファレンス: 完全な関数仕様
- トラブルシューティング: 一般的な問題と解決方法