IFP Detector Plugin #

A Flutter plugin to detect whether a device is an Interactive Flat Panel (IFP) or a regular tablet. This plugin is useful for applications that need to distinguish between these device types for licensing, feature availability, or UI adaptation purposes.

Features #

• Accurate Detection: Uses multiple hardware and software indicators to determine device type
• Confidence Scoring: Provides a confidence score (0.0 to 1.0) for the detection result
• Detailed Analysis: Returns comprehensive information about device characteristics
• Simple API: Easy-to-use methods for both detailed and simple detection

Detection Logic #

The plugin analyzes several device characteristics:

• Screen Size: Devices with screens ≥20" are typically IFPs
• Known IFP Brands: Promethean, Newline, ViewSonic, BenQ, CleverTouch, Smart, etc.
• Hardware Features: HDMI CEC support, Android TV Leanback features
• Input Capabilities: Stylus/pen support detection
• Display Properties: Screen size buckets and reliability

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  ifp_detector:
    path: ../ifp_detector  # or your plugin path

Usage #

Simple Detection #

import 'package:ifp_detector/ifp_detector.dart';

// Simple boolean check
bool isIFP = await IfpDetector.isIfp();
if (isIFP) {
  print('This is an Interactive Flat Panel');
} else {
  print('This is a regular tablet');
}

Detailed Detection #

import 'package:ifp_detector/ifp_detector.dart';

// Get detailed detection results
IfpDetectionResult result = await IfpDetector.detectIfp();

print('Device Type: ${result.isIFP ? "IFP" : "Tablet"}');
print('Confidence: ${result.confidenceLevel} (${(result.confidenceScore * 100).toStringAsFixed(1)}%)');
print('Screen Size: ${result.screenInches.toStringAsFixed(2)}" inches');
print('Screen Bucket: ${result.screenBucket}');
print('Known IFP Brand: ${result.matchedKnownIFPBrand}');
print('HDMI CEC: ${result.hasHdmiCec}');
print('Leanback UI: ${result.hasLeanback}');
print('Stylus Support: ${result.hasStylus}');
print('Screen Size Reliable: ${result.screenSizeReliable}');

Error Handling #

try {
  final result = await IfpDetector.detectIfp();
  // Use result
} on PlatformException catch (e) {
  print('Detection failed: ${e.message}');
} catch (e) {
  print('Unexpected error: $e');
}

API Reference #

IfpDetector #

Main class for IFP detection.

Methods

• static Future<IfpDetectionResult> detectIfp()

  • Returns detailed detection results
  • Throws PlatformException on failure

• static Future<bool> isIfp()

  • Returns simple boolean result
  • Throws PlatformException on failure

IfpDetectionResult #

Contains detailed information about the detection.

Properties

• bool isIFP - Whether the device is detected as an IFP
• double screenInches - Screen size in inches (diagonal)
• String screenBucket - Screen size bucket (small, normal, large, xlarge)
• bool matchedKnownIFPBrand - Whether device matches known IFP brand patterns
• bool hasHdmiCec - Whether device supports HDMI CEC
• bool hasLeanback - Whether device has Android TV Leanback features
• bool hasStylus - Whether device supports stylus/pen input
• bool screenSizeReliable - Whether screen size calculation is reliable
• double confidenceScore - Confidence score (0.0 to 1.0)

Methods

• String get confidenceLevel - Human-readable confidence level
• Map<String, dynamic> toMap() - Convert to map
• factory IfpDetectionResult.fromMap(Map<String, dynamic> map) - Create from map

Platform Support #

• ✅ Android
• ❌ iOS (not implemented)
• ❌ Web (not applicable)
• ❌ Desktop (not implemented)

Example App #

The plugin includes an example app that demonstrates both simple and detailed detection. Run it with:

flutter run

Use Cases #

• Software Licensing: Different licensing models for IFPs vs tablets
• Feature Availability: Enable/disable features based on device type
• UI Adaptation: Optimize interface for large displays
• Analytics: Track usage across different device types

Known IFP Brands #

The plugin recognizes these IFP manufacturers:

• Promethean
• Newline
• ViewSonic
• BenQ
• CleverTouch
• Smart Technologies
• Epson
• Hitachi
• Panasonic
• LG
• Samsung
• Sharp
• Ricoh
• Mimio
• QOMO
• Avocor
• TouchIT
• Boxlight
• Triumph Board
• Interactive Technologies

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License - see the LICENSE file for details.

Developed by Wriety - Enhancing educational technology solutions.