Anyline Tire Tread Flutter Plugin

This Flutter plugin provides an interface to the Anyline Tire Tread SDK, allowing you to integrate tire tread scanning capabilities into your Flutter applications.

Requirements

In order to use the Anyline Tire Tread SDK Flutter Plugin, please see to it that the following requirements are met:

Android

• Android 8.0 - Oreo - or newer (API level 26+)
• Decent camera functionality (recommended: ≥ 720p and adequate auto focus)
• 'Flash' capability
• Stable internet connection

iOS

• iOS Version >= 16.4
• Stable internet connection
• 'Flash' capability

Anyline Tire Tread Flutter Plugin Guide

In this guide, we want to show you how you can make the most out of Anyline Tire Tread using our Flutter plugin. Feel free to contact us if you feel that it is incomplete or particular sections need elaboration.

Get an Anyline License

To be able to use the Flutter plugin you will have to get a license key by following the steps detailed in our documentation.

Install the Anyline Tire Tread Plugin

Add the following dependency to your pubspec.yaml :

anyline_tire_tread_plugin: ^x.y.z  

Add the Anyline Tire Tread SDK as dependency

To integrate the Anyline Tire Tread SDK into your Android project, follow these steps:

• Open your project in Android Studio.
• Locate the build.gradle file of your project. This file is typically found in the root directory of your project.
• Add the Anyline Maven registry to your repositories section. This allows your project to access the Anyline Tire Tread SDK from the specified Maven repository. Update your repositories block to include the Anyline Maven registry URL:

repositories {
    // ... your other repositories ...
    mavenCentral()
    // Anyline Maven registry
    maven { url "https://europe-maven.pkg.dev/anyline-ttr-sdk/maven" }
}

NOTE: Find more inforamtion about adding Anyline Tire Tread SDK as dependency here.

Install via pub.dev

Install the package dependencies from the command line:
bash flutter pub get
Alternatively, your IDE might support flutter pub get. Check their documentation to learn more.

Import Anyline into your Flutter project

Now in your Dart code, bring in Anyline with the following import:

import 'package:anyline_tire_tread_plugin/anyline_tire_tread_plugin.dart';   

With this import, you can use the TireTreadPlugin class to call methods accessing the SDK and scanning functionality. Proceed by creating an object of this class:

var tireTreadPlugin = TireTreadPlugin();  

Initialize the SDK

During app startup, before calling any other plugin method, initialize the Anyline Tire Tread SDK by calling the plugin object’s initialize method, providing it with your license key:

try {
    await tireTreadPlugin.initialize(licenseKey);
} catch (error) {    
    print("error initializing Anyline Tire Tread SDK: $error");
}  

Start scanning

With an instance of TireTreadPlugin, call scan on it with the config options:

scanWithAnyline() async {  
 tireTreadPlugin.scan(options: ScanOptions());
}  

Audio Feedback

The Tire Tread Plugin can provide audio feedback to guide users through the scan process.

To make use of these audio feedbacks, your application needs to provide the audio files inside the below folders.

1. path_to_plugin_root_folder/example/ios/Resources for iOS
2. path_to_plugin_root_folder/example/android/app/src/main/assets for Android

The audio feedbacks (with their respective files names) on iOS/Android are played on:

Focus Point Found

tiretread_focuspoint_found.wav

Scan Started

tiretread_sound_start.wav

Scan Stopped

tiretread_sound_stop.wav

Phone too close to the Tire

tiretread_sound_beep_too_close.wav

Phone too distant from the Tire

tiretread_sound_beep_too_far.wav

The SDK only supports these file names, and the .wav extension.

Configuring the scanning behavior

You can customize how the scanning behavior works by passing in a ScanOptions object to the scan call:

tireTreadPlugin.scan(options: ScanOptions());

A ScanOptions object, constructed without parameters, contains sensible defaults to help you get quickly started.

If you wish, you can also specify the scan speed (fast or slow), and measurement system (metric or imperial units) in this way:

var scanOptions = ScanOptions(measurementSystem: MeasurementSystem.Imperial, scanSpeed: ScanSpeed.Fast);
tireTreadPlugin.scan(options: scanOptions);

Alternatively, you can provide a string containing the SDK's Tire Tread ScanView configuration JSON to the ScanOptions object, for example:

const configJSON = '{
  "scanSpeed": "Fast",
  "measurementSystem": "Metric",
  ...
}';

tireTreadPlugin.scan(options: ScanOptions(configFileContent: configJSON));

More information about the JSON configuration can be found here: https://documentation.anyline.com/tiretreadsdk-component/latest/scanconfiguration.html

Handling the SDK’s events

Handling SDK's events with an instance of TireTreadPlugin call onScanningEvent.

 tireTreadPlugin.onScanningEvent.listen((event) { 
   switch (event) {
     case ScanAborted(): 
       debugPrint('measurementUUID : ${event.measurementUUID}');
     case UploadAborted(): 
       debugPrint('measurementUUID : ${event.measurementUUID}'); 
     case UploadCompleted(): 
       debugPrint('measurementUUID : ${event.measurementUUID}'); 
       setState(() => _uuid = event.measurementUUID ?? ''); 
     case UploadFailed(): 
       debugPrint('measurementUUID : ${event.error}');
   }
 });  

Results

Obtaining the Measurement Results

After the upload of your scanned frames is completed (that is, the UploadCompletedEvent ), your measurement results may still take a few seconds to become available. To fetch the results, call the function getResult(measurementUuid):

String result = await tireTreadPlugin.getResult(measurementUUID:measurementUUID);  

Analytics

Heatmap

After the upload of your scanned frames is completed (that is, the UploadCompletedEvent ), your heatmap result may still take a few seconds to become available. To fetch the heatmap, call the function getHeatMap(measurementUuid):

String heatmap = await tireTreadPlugin.getHeatMap(measurementUUID:measurementUUID);