InstaVision Android SDK

The Guardian SDK (ai.instavision:guardian) is the Kotlin library behind the InstaVision app. Drop it into your own Android app and you get the same camera platform — accounts, Bluetooth pairing, WebRTC live view over Kinesis Video Streams, SD-card playback, the event feed, realtime events and professional monitoring — without writing a line of signalling code.

One SDK covers every InstaVision product line. The platform APIs are shared; each product adds the features its cameras have:


Home Security	Professional monitoring, siren and lights, doorbell, face recognition
Baby	Nursery monitor: cry, temperature and humidity alerts, lullaby player, growth and care logs
Pet	Pet profiles, recognition, activity insights
Bird	Feeder camera with species identification
Trail	Outdoor wildlife camera: hunting mode, GPS, timelapse, cellular data

Read the platform pages once; then read the section for the product you are building.

Requirements


Namespace	`ai.instavision.guardian.sdk`
minSdk	26
Language	Kotlin
Distribution	Maven (`nexus.instavision.ai`)

Get started

How it fits together

InstaVision.initialize(context, InstaVisionConfig(...))
        │
        ├── InstaVision.userServices ──── sign in, profile, push tokens
        │
        └── after sign-in
             │
             ├── InstaVision.spaceServices ─── spaces, members, invites
             │        │
             │        └── spaceId ──────────► every other call
             │
             ├── InstaVision.deviceServices ── settings, clusters, firmware, PTZ, lullaby
             ├── InstaVision.eventServices / timelapseService / realtimeEventService
             ├── InstaVision.subscriptionServices / securityServices
             ├── InstaVision.faceServices / babyService / petService / birdService   (product features)
             │
             ├── InstaVision.bleService ─────── pair a new camera
             └── LiveStreamClient / SDCardPlaybackClient ── live view and playback

Most service calls take onSuccess and onError callbacks; session state, BLE and realtime delivery use StateFlows and callbacks, and streaming clients expose their state as StateFlows.

Where to go next

If you want to…	Start at
Install and initialise the SDK	Getting Started
Sign a user in	Accounts & Users
Pair a camera	Pairing a Camera
Show live video	Live View
Play back from the SD card	SD Card Playback
List and filter events	Events
Receive events as they happen	Realtime Events
Build for one product line	Home Security · Baby · Pet · Bird · Trail
Look up an enum or cluster id	Types Reference
See what changed	Change Log