Configuration

Launching with options

Bugsee behavior is very customizable, if default configuration is not satisfying your needs you can launch the SDK with additional parameters passed as a dictionary.

!Java

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        HashMap<String, Object> options = new HashMap<>();
        options.put(Bugsee.Option.MaxRecordingTime, 60);
        options.put(Bugsee.Option.ShakeToTrigger, false);
        Bugsee.launch(this, "<your_app_token>", options);
    }
}

!Kotlin

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        val options : HashMap<String, Any> = hashMapOf(
                Bugsee.Option.MaxRecordingTime to 60,
                Bugsee.Option.ShakeToTrigger to false
        )
        Bugsee.launch(this, "<your_app_token>", options)
    }
}

Alternatively, parameters can be passed as LaunchOptions class instance.

!Java

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        LaunchOptions options = new LaunchOptions();
        options.Video.setMaxRecordingTime(60);
        options.General.setShakeToTrigger(false);
        Bugsee.launch(this, "<your_app_token>", options);
    }
}

!Kotlin

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        val options = LaunchOptions()
        options.Video.maxRecordingTime = 60
        options.General.isShakeToTrigger = false
        Bugsee.launch(this, "<your_app_token>", options)
    }
}

Note, that not all of the following options will work in an Instant App. Specifically, NotificationBarTrigger, VideoEnabled and CaptureLogs options are always set to false for an Instant App.

Stop, Relaunch

It is also possible to relaunch Bugsee with other options later

!Java

// Relaunch with other options.
HashMap<String, Object> options = new HashMap<>();
// Set other launch options.
//...
Bugsee.relaunch(options);

!Kotlin

// Relaunch with other options.
val options : HashMap<String, Any> = hashMapOf()
// Set other launch options.
//...
Bugsee.relaunch(options)

or stop the events and video recording.

!Java

// Stop recording completely.
Bugsee.stop();

!Kotlin

// Stop recording completely.
Bugsee.stop()

Available Options

Built-in reporting UI adjustments

Alongside stylistic changes, you can also change the placeholders' texts shown in input controls within the built-in bug reporting UI

!Java

Bugsee.getAppearance().ReportSummaryPlaceholder = "What's happened? Only shortly";
Bugsee.getAppearance().ReportDescriptionPlaceholder = "Here, describe all the pains and frustrations you had. In details";
Bugsee.getAppearance().ReportEmailPlaceholder = "Identify yourself here";
Bugsee.getAppearance().ReportLabelsPlaceholder = "Labels.For.Developers. [Comma separated]";

!Kotlin

Bugsee.appearance.ReportSummaryPlaceholder = "What's happened? Only shortly"
Bugsee.appearance.ReportDescriptionPlaceholder = "Here, describe all the pains and frustrations you had. In details"
Bugsee.appearance.ReportEmailPlaceholder = "Identify yourself here"
Bugsee.appearance.ReportLabelsPlaceholder = "Labels.For.Developers. [Comma separated]"

Video modes comparison

**VideoMode.V2: Starting Android 9 it requires FOREGROUND_SERVICE permission. Starting Android 14 it requires additional FOREGROUND_SERVICE_MEDIA_PROJECTION permission. If you want to use V2 mode, your application will have to declare these permissions in manifest.

***VideoMode.V3: On Samsung devices, VideoMode.V3 will work only on Android 8 and up. Earlier versions of Android on Samsung devices are known to have issues when VideoMode.V3 is being used and hence it preemptively disabled there.