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

Androidエージェント

概要​

Androidエージェントは、Androidアプリケーション向けのNetFUNNELトラフィック制御機能を提供するネイティブAndroid SDKです。Androidアプリコードに直接統合してキュー管理および待合室機能を実装し、サーバーの負荷を分散し、トラフィックが多い期間中も安定したユーザー体験を保証します。

主要機能​

  • ネイティブAndroid SDK: シンプルなAPI呼び出しでAndroidアプリコードに直接統合
  • 2つの制御方式: 基本コントロール（進入速度制限）と区間コントロール（同時ユーザー管理）から選択
  • 専用API: 基本コントロールはnfStart()/nfStop()を使用、区間コントロールはnfStartSection()/nfStopSection()を使用
  • ネイティブ待合室: カスタマイズ可能なUIオプションを備えたWebViewベースの待合室テンプレート
  • リアルタイムキュー更新: リアルタイムの待機順番、待機時間、進行情報を受信
  • ネットワーク回復: ユーザー体験を維持するためのネットワーク問題の自動回復
  • 強力なエラー処理: スマートなエラー処理戦略を備えた包括的なコールバックシステム
  • 軽量SDK: KtorおよびKotlinx Serializationを使用した最小限の依存関係
  • Androidライフサイクル統合: ActivityライフサイクルおよびAndroidコンポーネントとのシームレスな統合

システム要件​

  • Android API Level: 22+ (Android 5.1 Lollipop以上)
  • Java: 1.8以上
  • Kotlin: 1.9.0以上 (Kotlinベースプロジェクトの場合)
  • 依存関係: Ktor 2.1.0+ (< 3.0.0), Kotlinx Serialization

互換環境​

  • ネイティブAndroidアプリ: 完全なSDK統合をサポートするJava/KotlinベースのAndroidアプリケーション
  • ハイブリッドアプリ: ネイティブAndroidコンポーネントを含むアプリケーション (WebViewコンテンツはこのSDKでは保護されません)
  • すべてのAndroidビルドタイプ: ProGuard/R8サポートを含むデバッグおよびリリースビルド

動作方式​

Android SDKはアプリのライフサイクルとシームレスに統合されます:

  1. SDK初期化: ApplicationクラスでNetFUNNEL SDKを初期化
  2. ネイティブ統合: Android Activities/Fragmentsで基本コントロールはnfStart()、区間コントロールはnfStartSection()を呼び出し
  3. WebView待合室: SDKがWebViewベースの待合室を表示 (デフォルトテンプレートまたはカスタムUI)
  4. キュー管理: NetFUNNELサーバーが待機順番および入場を自動的に処理
  5. キー返却: ユーザーが作業を完了すると基本コントロールはnfStop()、区間コントロールはnfStopSection()を呼び出し

制御フロー例​

基本コントロールフロー:

ユーザー作業 → nfStart() → 待合室 → onSuccess() → ユーザー進行 → nfStop()

区間コントロールフロー:

ユーザー作業 → nfStartSection() → 待合室 → onSuccess() → ユーザー区間内 → nfStopSection()

重要な制限事項​

ハイブリッドアプリの制限事項
  • WebViewコンテンツ: このSDKはWebViewコンテンツ(HTML/JavaScriptページ)を保護しません
  • ネイティブコンポーネントのみ: トラフィック制御はネイティブAndroidコンポーネント(Activities、Fragmentsなど)にのみ適用されます
  • Web/JavaScriptエージェント: WebViewベースのコンテンツの場合はJavaScriptエージェントを代わりに使用してください

はじめに​

Androidエージェントをすぐに始めるには、クイックスタートガイドを参照してください。

練習プロジェクト提供

練習用の基本プロジェクトが必要ですか？NetFUNNEL SDK統合の練習用に**Androidアプリケーション（単一Activity）**テンプレートを含むサンプルプロジェクトを確認してください。

ドキュメント​

コアドキュメント​

実装ガイド​