Advanced Configuration & APIs

This section covers advanced UXCam iOS SDK features beyond the basic integration.

Control Recording

Start, stop, and manage session recording programmatically.

Crashes & ANRs

How UXCam captures crash reports and ANR events.

Opt In / Opt Out

Give users control over session recording for privacy compliance.

Pause & Resume Recording

Temporarily pause recording for sensitive flows without stopping the session.

Crash Symbolication

Set up dSYM upload for readable crash stack traces on the dashboard.

Integration Logging

Enable verbose SDK logs for debugging your integration.

Report Handled Exceptions

Send caught exceptions to UXCam alongside session replays.

Configuration Reference

All options are set on the UXCamConfiguration object before calling UXCam.start(with:):

let config = UXCamConfiguration(appKey: "YOUR_APP_KEY")

// Screen tagging
config.enableAutomaticScreenNameTagging = true       // default: true

// Recording behavior
config.enableMultiSessionRecord = true               // default: true
config.enableCrashHandling = true                    // default: true
config.enableAdvancedGestureRecognition = true        // default: true

// Debugging
config.enableIntegrationLogging = false              // default: false

// Network monitoring (v3.7.9+)
config.enableNetworkLogging = false                  // default: false

// Environment filtering
config.environment = .release                        // .alpha | .beta | .release

// Privacy — set occlusion at init time
config.occlusion = UXCamOcclusion(/* ... */)         // optional

UXCam.start(with: config)

📘
Deprecation Note (v3.8.0+)
optIntoSchematicRecordings() / optOutOfSchematicRecordings() are deprecated. Use optIntoVideoRecordings() / optOutOfVideoRecordings() instead. Schematic vs. video recording is now controlled exclusively from the dashboard.