Listeners/Callbacks

Initialize Listener

Triggers if MoveConfigurationError occurs on initialization (Android/iOS).

Android

interface InitializeListener {
    fun onError(error: MoveConfigurationError)
}

iOS

typealias MoveIntializationCallback = ((_ confgError: MoveConfigurationError?) -> Void)?

Parameter
MoveConfigurationError	Potiential MoveConfigurationError on initilazation (Android/iOS).

SDK State Listener

Triggers whenever the MoveSDKState changes.

Set an SDK State listener usingsetSDKStateListener(Android/iOS) API to anticipate handling the 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

Parameter
MoveSDKState	Latest MoveSDKState.

Auth State Update Listener

Triggers whenever the MoveAuthState changes.

Authentication Expiry

The host app is expected to monitor MoveAuthState updates viaauthStateUpdateListener(Android / iOS) 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

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

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.

Log Callback

Triggers whenever a new log event occurs.

iOS

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

Parameter
log	String	New log event.