onButtonState handler

Responsible for handling the Alan button state change events.

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 activities in the app while the Alan button is in a specific state, you can use the ‘onButtonState’ handler to listen to the Alan button state changes.

Examples

Web (React, Angular, etc.)

var alanBtnInstance = alanBtn({
  key: "a552799e77cd7970091cb1f9fc484b652e956eca572e1d8b807a3e2338fdd0dc/stage",
  onButtonState: function (e) {
    console.info('onButtonState', e);
  },
  rootEl: document.getElementById("alan-btn"),
});

Objective-C

self.button.onButtonState = ^(AlanSDKButtonState state) {
  NSLog(@"%ld", (long)state);
};

Swift

self.button.onButtonState = { state in
  print(state.rawValue)
}

Kotlin

val alanCallback: AlanCallback = object : AlanCallback() {

  /// Handle button state
  override fun onButtonState(alanState: AlanState) {
    Log.d("AlanButton", "onButtonState: $alanState")
  }
}

Java

AlanCallback alanCallback = new AlanCallback() {

  /// Handle button state
  @Override
  public void onButtonState(AlanState alanState) {
    Log.d("AlanButton", "onButtonState: " + alanState);
  }
};

Flutter

_MyHomePageState() {

  /// Handle button state
  AlanVoice.onButtonState.add((state) {
    debugPrint("got new button state ${state.name}");
  });
}

Ionic

this.alanBtnComponent.nativeElement.addEventListener('buttonState', (data) => {
  const buttonState = (<CustomEvent>data).detail;
  this.buttonStatusSectionEl.nativeElement.innerText = this.buttonStatusSectionEl.nativeElement.innerText + buttonState + '\n';
});

React Native

import { NativeEventEmitter, NativeModules } from 'react-native';
 const { AlanManager, AlanEventEmitter } = NativeModules;
 const alanEventEmitter = new NativeEventEmitter(AlanEventEmitter);

 componentDidMount() {
   /// Handle button state
   alanEventEmitter.addListener('onButtonState', (state) => {
     console.log(`onButtonState: ${JSON.stringify(state)}`);
   });
 }
 componentWillUnmount() {
   alanEventEmitter.removeAllListeners('onButtonState');
 }