🏠 flutter_roomplan #

Seamlessly integrate Apple's RoomPlan SDK into your Flutter apps
Capture accurate 3D room scans using ARKit with this powerful plugin. Perfect for AR measurement, smart home, and interior design solutions.

⚠️ Requirements #

• iOS 16+
• ARKit-compatible device:
  iPhone 12 or later, or recent iPad Pro
• LiDAR Scanner required for accurate room scanning

📌 Key Features #

• 📸 Launches native RoomCaptureViewController for full-screen AR scanning
• 🪄 Captures room geometry + objects as structured JSON
• 🔗 Simple Flutter API to start scans and handle results
• 🚀 Returns complete CapturedRoom JSON specification
• 📱 Device compatibility checking
• 📦 USDZ file export support

🔍 Data Structure #

The following diagram shows the structure of the captured room data:

[RoomPlan Data Structure]

The green nodes indicate updates from WWDC 2023 (iOS 17)

🚀 Quick Start #

1️⃣ Installation #

Add to pubspec.yaml:

dependencies:
  flutter_roomplan: ^1.1.0

2️⃣ Basic Usage #

import 'package:flutter_roomplan/flutter_roomplan.dart';

// Create plugin instance
final roomPlan = FlutterRoomplan();

// Check if device supports RoomPlan
final isSupported = await roomPlan.isSupported();

// Register callback for scan results
roomPlan.onRoomCaptureFinished((resultJson) {
  print('Room scan completed: $resultJson');
});

// Start room scanning
try {
  await roomPlan.startScan();
} catch (e) {
  print('Error starting scan: $e');
}

// Get USDZ file path after scan (if available)
final usdzPath = await roomPlan.getUsdzFilePath();

3️⃣ Available Methods #

• isSupported(): Check if the device supports RoomPlan
• startScan(): Launch the room scanning interface
• onRoomCaptureFinished(): Register callback for scan results
• getUsdzFilePath(): Get path to exported USDZ file from last scan

4️⃣ Error Handling #

The plugin throws exceptions for common errors:

• Device not supported
• Required permissions not granted
• Scan initialization failures

Always wrap startScan() in a try-catch block and check device support before scanning.

📝 Example #

Check out the example app for a complete implementation showing:

• Device support checking
• Scan initiation
• Result handling
• USDZ file path retrieval
• Error management

⚠️ Limitations #

Multiple Rooms Scanning #

• Can produce inaccurate data during extended scanning sessions
• Device may experience overheating on longer scans
• Best practice: Scan one room at a time with cooling breaks between scans

Surface Shape Detection #

• Limited to rectangular and square surface detection
• Cannot accurately detect curved edges or irregular shapes
• Assumes all surfaces are planar with right angles

Phantom Object Detection #

• May occasionally detect non-existent objects
• Can produce false positives in complex lighting conditions
• Recommend verifying critical measurements manually

Object Detection Limits #

• Currently restricted to 16 types of household objects
• Limited to common furniture and fixture categories
• May not recognize specialized or custom furniture pieces

[RoomPlan Supported Objects]

📄 License #

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