-
public final class AegisConfigAegis Android SDK configuration. Parity with libs/web-sdk AegisConfig (libs/web-sdk/src/types/config.ts) + libs/mobile-sdk ios-sdk AegisConfig.swift.
Pre-Phase-1 the Android SDK referenced this type from Aegis.kt but the type was never defined — the SDK did not compile. Phase 1 lands it alongside the canonical cell-endpoint contract so the multi-region failover behaviour matches the web SDK.
-
-
Field Summary
Fields Modifier and Type Field Description private final StringapiHostprivate final List<CellEndpoint>cellEndpointsprivate final CellRegionpreferredRegionprivate final BooleanautoRegionDetectionprivate final StringworkspaceIdprivate final StringlocationIdprivate final IntegerbatchSizeprivate final LongbatchIntervalprivate final LongsessionTimeoutprivate final BooleanautoSessionTrackingprivate final BooleanencryptLocalStorageprivate final BooleanenableRemoteConfigprivate final BooleandebugModeprivate final List<String>blockedEvents
-
Constructor Summary
Constructors Constructor Description AegisConfig(String apiHost, List<CellEndpoint> cellEndpoints, CellRegion preferredRegion, Boolean autoRegionDetection, String workspaceId, String locationId, Integer batchSize, Long batchInterval, Long sessionTimeout, Boolean autoSessionTracking, Boolean encryptLocalStorage, Boolean enableRemoteConfig, Boolean debugMode, List<String> blockedEvents)
-
Method Summary
Modifier and Type Method Description final StringgetApiHost()Hardcoded base URL fallback when cellEndpoints is empty. final List<CellEndpoint>getCellEndpoints()Multi-region cell endpoints. final CellRegiongetPreferredRegion()Preferred region. final BooleangetAutoRegionDetection()When true, the SDK measures /health latency on every healthy cell at init and picks the lowest. final StringgetWorkspaceId()Brand-tenant identifier — stamped on every outgoing event when set. final StringgetLocationId()Outlet identifier within the brand. final IntegergetBatchSize()Batch size for the event queue uplink. final LonggetBatchInterval()Flush interval (ms) for the event queue uplink. final LonggetSessionTimeout()Session timeout in milliseconds — 30 min by default. final BooleangetAutoSessionTracking()Whether to auto-track app foreground/background session events. final BooleangetEncryptLocalStorage()Encrypt the on-disk event queue with AES/GCM via Android Keystore. final BooleangetEnableRemoteConfig()Fetch /v1/sdk/config at init and apply remote overrides. final BooleangetDebugMode()When true, the SDK prints lifecycle + selection logs. final List<String>getBlockedEvents()Names of events to drop client-side. -
-
Constructor Detail
-
AegisConfig
AegisConfig(String apiHost, List<CellEndpoint> cellEndpoints, CellRegion preferredRegion, Boolean autoRegionDetection, String workspaceId, String locationId, Integer batchSize, Long batchInterval, Long sessionTimeout, Boolean autoSessionTracking, Boolean encryptLocalStorage, Boolean enableRemoteConfig, Boolean debugMode, List<String> blockedEvents)
-
-
Method Detail
-
getApiHost
final String getApiHost()
Hardcoded base URL fallback when cellEndpoints is empty.
-
getCellEndpoints
final List<CellEndpoint> getCellEndpoints()
Multi-region cell endpoints. When at least one is provided the SDK runs the canonical selection algorithm (see CellSelector) and ignores apiHost. Empty list = single-host mode (legacy).
-
getPreferredRegion
final CellRegion getPreferredRegion()
Preferred region. When set, the SDK pins to its endpoint if healthy and skips latency probing. Falls through to auto-detection if the preferred region is unhealthy.
-
getAutoRegionDetection
final Boolean getAutoRegionDetection()
When true, the SDK measures /health latency on every healthy cell at init and picks the lowest. When false, sorts by priority.
-
getWorkspaceId
final String getWorkspaceId()
Brand-tenant identifier — stamped on every outgoing event when set.
-
getLocationId
final String getLocationId()
Outlet identifier within the brand. Optional.
-
getBatchSize
final Integer getBatchSize()
Batch size for the event queue uplink.
-
getBatchInterval
final Long getBatchInterval()
Flush interval (ms) for the event queue uplink.
-
getSessionTimeout
final Long getSessionTimeout()
Session timeout in milliseconds — 30 min by default.
-
getAutoSessionTracking
final Boolean getAutoSessionTracking()
Whether to auto-track app foreground/background session events.
-
getEncryptLocalStorage
final Boolean getEncryptLocalStorage()
Encrypt the on-disk event queue with AES/GCM via Android Keystore.
-
getEnableRemoteConfig
final Boolean getEnableRemoteConfig()
Fetch /v1/sdk/config at init and apply remote overrides.
-
getDebugMode
final Boolean getDebugMode()
When true, the SDK prints lifecycle + selection logs.
-
getBlockedEvents
final List<String> getBlockedEvents()
Names of events to drop client-side. Populated by remote config — operators can stop a noisy event from reaching the gateway without an SDK release.
-
-
-
-