Alan Flutter Framework

Integrating with Alan

To integrate a Flutter app with Alan:

1. In the pubspec.yaml file of your Flutter project, add the Alan voice dependency:

   //pubspec.yaml file
   ...
   dependencies:
     flutter:
       sdk: flutter
       ...
   
     alan_voice: 2.0.14

2. Open the main.dart file and at the top of it, add the alan_voice package dependency:

   //main.dart file
   ...
   import 'package:alan_voice/alan_voice.dart';

3. In the _MyHomePageState class, add the method for initializing the Alan button:

   //main.dart file
   ...
   class _MyHomePageState extends State<MyHomePage> {
   ...
   	_MyHomePageState() {
   		//init Alan with sample project id
   		AlanVoice.addButton(
   			"",
   			buttonAlign: AlanVoice.BUTTON_ALIGN_LEFT);
   	}
   ...

4. In Alan Studio, go to Integrations, copy the value from the Alan SDK Key field and insert this value in the quotes.

   //main.dart file
   ...
   class _MyHomePageState extends State<MyHomePage> {
   ...
   	_MyHomePageState() {
   		//init Alan with sample project id
   		AlanVoice.addButton(
   			"314203787ccd9370974f1bf6b6929c1b2e956eca572e1d8b807a3e2338fdd0dc/prod",
   			buttonAlign: AlanVoice.BUTTON_ALIGN_LEFT);
   	}
   ...

That's it. Now you can run the app, tap the Alan button and start interacting with Alan.

Listening to the Alan button states

When the user launches an app with the Alan button, Alan connects to the project in the Alan Cloud, and the Alan button transitions through several states:

• CONNECTING: Alan is connecting to your voice assistant project in the Alan Cloud
• ONLINE: a connection to the project is established
• LISTEN: Alan is listening to the user input
• PROCESS: Alan is processing the user input
• REPLY: Alan is replying to the user
• OFFLINE: no connection to the Internet; the connection to the Alan Studio project cannot be established

If you need to perform some activities in the app while the Alan button is in a specific state, you can add a handler that will be listening to the Alan button state changes. In the example below, once the Alan button state changes, the state name is logged to the console.

_MyHomePageState() {
    // Initializing Alan with a sample project id
    AlanVoice.addButton(
        "a5a1c514d84c9c127d43485dbc3cb44a2e956eca572e1d8b807a3e2338fdd0dc/stage"
    );

    // Listening to the Alan button state changes
    AlanVoice.eventCallbacks.add((event) {
       debugPrint("Got new event ${event.name} from Alan");
    });
  }

Changing the logging level

By default, Alan does not log its system events such as change of the Alan button state to the IDE console. If you want to see messages from Alan, switch to the all logging level:

AlanVoice.setLogLevel("all");

To disable logs, either remove the line above or switch to the none logging level:

AlanVoice.setLogLevel("none");

Trying Alan sample apps

In our GitHub repository, you can find sample Flutter apps already integrated with Alan. Download these apps to get an idea of how you can voice-enable your app and synchronize your GUI with the voice UX.

• Alan simple app: an example demonstrating how to integrate Alan with a Flutter app
• Flutter Shrine app: a shopping app with a voice interface synchronized with the app visual elements