flutter_ai_indoor_navigation

This plugin is a wrapper for the Combain Indoor AI Navigation SDK. It provides a simple way to integrate the SDK into your Flutter app.

Getting Started

This is all the code needed to start receiving indoor location updates from the Combain Indoor AI Navigation SDK.

Future<void> initIndoorNavigationSDK() async {
  var config = FlutterIndoorNavigationSDKConfig(
      apiKey: Secrets.apiKey,
      syncingInterval: SyncingInterval(interval: 0),
      routingConfig: FlutterRoutingConfig(
          routableNodesOptions:
              FlutterRoutableNodesOptions.allExceptDefaultName));

  val aiIndoorNavigationSDK = await FlutterIndoorNavigationSDK.create(config);
  await aiIndoorNavigationSDK.start();
}

Demo

For a demo project see gitlab.combain.com/Hugo-Persson/flutter-ai-navigation-demo

Setup

Android

For proper permission handling, your MainActivity must extend FlutterFragmentActivity instead of the default FlutterActivity. This is required because the SDK needs access to ComponentActivity features for permission management.

In your android/app/src/main/kotlin/.../MainActivity.kt:

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity: FlutterFragmentActivity()

Note: If your MainActivity currently extends FlutterActivity, simply change it to FlutterFragmentActivity and update the import statement.

Required Permissions in AndroidManifest.xml

Add the following permissions to your android/app/src/main/AndroidManifest.xml file:

<!-- Required permissions for Bluetooth and location services -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />

Note: These permissions are required for the SDK to function properly, especially for Bluetooth beacon detection and location services. The neverForLocation flag on BLUETOOTH_SCAN indicates that Bluetooth scanning is not used for location purposes.

Permissions

iOS

The following values needs to be specified in the info.plist

NSMotionUsageDescription
NSLocationWhenInUseUsageDescription

And this needs ot be added to Podfile:

target.build_configurations.each do |config|
      # You can remove unused permissions here
      # for more information: https://github.com/BaseflowIT/flutter-permission-handler/blob/master/permission_handler/ios/Classes/PermissionHandlerEnums.h
      # e.g. when you don't need camera permission, just add 'PERMISSION_CAMERA=0'
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',


        ## The 'PERMISSION_LOCATION' macro enables the `locationWhenInUse` and `locationAlways` permission. If
        ## the application only requires `locationWhenInUse`, only specify the `PERMISSION_LOCATION_WHENINUSE`
        ## macro.
        ##
        ## dart: [PermissionGroup.location, PermissionGroup.locationAlways, PermissionGroup.locationWhenInUse]
        'PERMISSION_LOCATION_WHENINUSE=1',
        'PERMISSION_SENSORS=1',
      ]

    end

see https://github.com/Baseflow/flutter-permission-handler/tree/main/permission_handler#setup

Combain Indoor AI Navigation Plugin