Listeners/Callbacks

MOVE Models

SDK State Listener

Triggers whenever the MoveSDKState changes.

Set an MOVE SDK State listener usingsdkStateListener(Android/iOS) API to anticipate handling the MOVE SDK State changes, start detection services when MoveSDKState is .ready or handle.error if occurred.

Android

interface StateListener {
    fun onStateChanged(sdk: MoveSdk, state: MoveSdkState)
}

iOS

typealias MoveSDKStateCallback = (_ state: MoveSDKState) -> Void

React Native

static addTripStateListener(tripStateChanged: (state: TripState) => void): ListenerSubscription;

Parameter
MoveSDKState	Latest MoveSDKState.

Auth State Update Listener

Triggers whenever the MoveAuthState changes.

Authentication Expiry

The host app is expected to monitor MoveAuthState updates via authStateUpdateListener API and handle those changes accordingly.

Check Authentication updates and expiry for more details about authentication expiry and renewal.

Android

interface AuthStateUpdateListener {
    fun onAuthStateUpdate(state: MoveAuthState)
}

iOS

typealias MoveAuthStateCallback = (_ state: MoveAuthState) -> Void

React Native

static addAuthStateListener(authStateChanged: (event: AuthStateEvent) => void): ListenerSubscription;

Parameter
MoveAuthState	Latest MoveAuthState.

Trip State Listener

Triggers whenever the MoveTripState changes.

Android

interface TripStateListener {
    fun onTripStateChanged(sdk: MoveSdk, tripState: MoveTripState)
}

iOS

typealias MoveTripStateCallback = (_ tripState: MoveTripState) -> Void

React Native

static addTripStateListener(tripStateChanged: (state: TripState) => void): ListenerSubscription;

Parameter
MoveTripState	Latest MoveTripState.

Trip Metadata Provider

Triggers whenever a trip is ending, for the host app to append metadata along with that trip if needed.

Android

interface TripMetadataProvider {
    fun provideMetadata(start: Long, end: Long): Map<String, String>
}

iOS

typealias MoveMetaDataCallback = (_ tripStart: Date, _ tripEnd: Date) -> [String: String]

Parameter
start/tripStart	Long/Date	Trip start timestamp/date.
end/tripEnd	Long/Date	Trip end timestamp/date.

Return

A String dictionary of the trip's metadata.

Device Status Callback

Triggers whenever MoveDeviceStatus changes.

iOS

typealias MoveDeviceStatusCallback = (_ status: MoveDeviceStatus) -> Void

Parameter
MoveDeviceStatus	Latest MoveDeviceStatus.

Service Failure Callback

Triggers whenever MoveServiceFailures change.

Android

interface MoveErrorListener {
    fun onMoveError(serviceFailures: List<MoveServiceFailure>)
}

iOS

public typealias MoveServiceFailureCallback = (_ permissions: [MoveServiceFailure]) -> Void

React Native

static addErrorsListener(errorsReceived: (errors: ErrorListType) => void): ListenerSubscription;

Parameter
MoveServiceFailure	List of MoveServiceFailures.

Service Warning Callback

Triggers whenever MoveServiceWarnings change.

Android

interface MoveWarningListener {
    fun onMoveWarning(serviceWarnings: List<MoveServiceWarning>)
}

iOS

public typealias MoveServiceWarningCallback = (_ permissions: [MoveServiceWarning]) -> Void

React Native

static addWarningsListener(warningsReceived: (warnings: ErrorListType) => void): ListenerSubscription;

Parameter
MoveServiceWarning	List of MoveServiceWarnings.

Initialization Listener

Represents the potential errors occurring when updating the MoveAuth.

Android

interface InitializeListener {
    fun onError(error: MoveConfigurationError)
}

iOS

public typealias MoveInitializationCallback = (_ error: MoveConfigurationError) -> Void

Parameter
error	MoveConfigurationError	An error to notify when the configuration could not be loaded from the server.

Log Callback

Triggers whenever a new log event occurs.

Android

interface MoveLogCallback {
    fun onLogReceived(eventName: String, value: String?)
}

iOS

typealias MoveLogCallback = (_ log: String, _ value: String) -> Void

Parameter
log	String	New log event.
value	String	Log value.