Showing Luciq

This section covers how to set the user action that initializes Luciq, as well as how to customize what appears to your app users after the SDK is shown for Android apps.

By default, Luciq is shown when the device is shaken. This can be customized to several other modes that show the SDK. You can also show the SDK manually from a custom gesture or a button you add to your app.

Invocation Events

You can set the SDK to be shown when your users do one or more of the following actions:

• Shake device

• Take a normal screenshot

• Tap on a floating button shown above your app's UI

• Do a two-finger swipe from right to left

• None (manual showing)

You have the option to set one or multiple invocation events. To customize the invocation event, pass one of the values of the LuciqInvocationEvent enum when starting the SDK.

Kotlin

Luciq.Builder(this, "APP_TOKEN")
            .setInvocationEvents(LuciqInvocationEvent.SHAKE, LuciqInvocationEvent.FLOATING_BUTTON)
            .build()

Java

You can find the possible invocation events below.

Android

NONE
SHAKE
FLOATING_BUTTON
SCREENSHOT
TWO_FINGER_SWIPE_LEFT

None

Use the "none" event if you want to show the SDK manually in order to prevent the SDK from being invoked through the other events.

Recommendation

If you set the event to "NONE" and you're showing Luciq manually from your app's UI, we recommend that you set up custom categories. Typically, while using the other gestures, the user can invoke Luciq from any screen in the app once they spot an issue which allows the SDK to capture the current screen and attach it to the report. However, when you limit invoking Luciq to a specific screen (help or settings for example), the current screen that the SDK captures won't necessarily be relevant to the issue. The recommended alternative is that you set up a list of custom categories that match the main features or views in your app and let the user choose one of them.

Floating Button

If you are using the floating button, you can set its default position as explained here.

Shaking Threshold

If you are using the shaking gesture as your invocation event, you can set how sensitive the device should be to the shaking. The default value is 650. The higher the value, the less sensitive the device will be to shaking.

Kotlin

BugReporting.setShakingThreshold(800)

Java

Changing the Invocation Event

If you want to change the invocation event to any of the other supported events, you can do so at runtime​ as shown below.

Kotlin

BugReporting.setInvocationEvents(LuciqInvocationEvent.SHAKE, LuciqInvocationEvent.SCREENSHOT)

Java

Manual Showing

If you want to show the SDK manually, use the show method.

Kotlin

Luciq.show()

Java

Recommendation

When you limit invoking Luciq to a specific screen (help or settings for example), the current screen that the SDK captures won't necessarily be relevant to the issue. To help you gain more context, it is recommended that you set up a list of custom categories that match the main features or views in your app and let the user choose one of them. You can find more details here.

Showing Specific Modes

By default, when the Luciq SDK is shown, a popup appears to your app users with options for them to report a bug ("Report a bug"), share feedback ("Suggest an improvement"), or ask you a question ("Ask a question").

The Prompt Options menu appears when Luciq is shown in your app.

Instead of showing this Prompt Options menu that lets your users choose what they want to do, you can skip this step and take users directly to the bug, feedback, or question reporting flow.

Show Bug Form

This API will show users a form they can use to submit new bug reports.

Kotlin

BugReporting.show(BugReporting.ReportType.BUG)

Java

Show Feedback Form

This API will show users a form they can use to submit new feedback and suggestions.

Kotlin

BugReporting.show(BugReporting.ReportType.FEEDBACK)

Java

Show Question Form

This API will show users a form they can use to submit a new question.

Kotlin

BugReporting.show(BugReporting.ReportType.QUESTION)

Java

Show Replies Page

This API will show users a page where they can see all their ongoing chats. If the user has no ongoing chats, this API won't have an effect.

Kotlin

Replies.show()

Java

Enable/Disable Luciq

Sometimes, you might need to disable or enable Luciq if, for example, the user would like to opt out of collecting any sort of logs, bugs, crashes, or survey responses. This can be done using the API below:

Kotlin

//Enable
Luciq.enable()
//Disable
Luciq.disable()

Java

Alternatively, Luciq can be disabled during Initialization, if required, through the builder method:

Kotlin

Luciq.Builder(this, "APP_TOKEN")
            .setInvocationEvents(LuciqInvocationEvent.SHAKE, LuciqInvocationEvent.FLOATING_BUTTON)
            .build(Feature.State.DISABLED)

Java

Disabling Luciq

If Luciq is disabled, all user data and attributes are deleted from the device. Answered surveys will be stored in case Luciq is enabled again in order to not show the survey once more. Storing user attributes will not be available while Luciq is disabled.