Change Log - Guardian SDK

Version 2026.08.31

Stable

💥 Breaking Changes

  • LiveStreamClient.stopRecording now takes onSaved: (Int) -> Unit and reports how many clips were saved. Recordings are written straight into the device gallery, so File handles are no longer returned.
  • WebRtcRecorder.stopRecording now yields a list of SensorOutput instead of a list of File, and SensorOutput.outputFile is nullable — a SensorOutput now needs either an outputFile or an outputDescriptor.
  • FaceService.uploadFaceAngles now reports both the thumbnail path and the uploaded zip file name, so its onSuccess takes two arguments.
  • Removed the BOTTOM, TOP, SLIGHTLY_LEFT and SLIGHTLY_RIGHT values from FaceAngles.
  • Removed the Global service, including InstaVision.globalServices, getAmazonListing() and the AmazonListing models.
  • Species gained a type field, positioned before probability.
  • Removed productId from DataPass.

🚀 Features

  • Added support for realtime events — subscribe to live updates, observe the connection state, and fetch missed events from history.
  • Added lullaby control for cameras that support it — play, pause, resume, stop, and configure the playback mode and timer.
  • Added support for signing in with Google, and for checking whether password authentication is available for an account.
  • Added an API to email the user a desktop access link.
  • Added live view connection prewarming, so a stream can be started ahead of time and opened almost instantly.
  • Added setTelecomOwnsAudio for apps that manage calls through their own Telecom integration.
  • Added a scope to products and subscriptions, along with the SubscriptionScope enum.
  • Added trialPeriod to plans so trial lengths can be displayed without an extra call.
  • Added the SpeciesType enum and support for child species on detections.
  • Added the name of the uploaded zip file to the update face request.

🛠 Improvements & Optimizations

  • The microphone is now only held while it is actually in use, and is released while the app is in the background. Report foreground changes with InstaVision.setAppInForeground(...).
  • Live view recordings are now muxed directly into the gallery, removing a main-thread copy when saving.
  • Reused GL vertex buffers while recording instead of allocating a new buffer per frame.
  • Password reset and email verification now fall back to the InstaVision backend when Firebase fails.
  • Logout now clears the stored token after the backend logout request completes (isLoggedIn() still flips to false immediately).
  • Failures on a stream now surface as a FAILED status instead of crashing the app.

🐞 Bug Fixes

  • Fixed a crash caused by a race condition during Firebase initialization.
  • Fixed timezone handling for zones without a daylight saving transition.
  • Removed the parameters that were incorrectly sent with the lullaby play request.

Version 2026.07.12

Stable

🚀 Features

  • Added support for Baby Monitoring — manage baby profiles, activities, and growth data.
  • Added support for Face detection — manage face profiles and tag faces on events.
  • Added support for embargo schedules and hunting mode.
  • Added support for setting the camera location.
  • Added dual-lens (multi-track) support for live view and SD card playback.
  • Added support for recording cropped videos.
  • Added support for v4 firmware.
  • Added support for provisioning 4G SIM by SIM ID.
  • Added support for leaving a space.
  • Added video on/off commands for two-way cameras.
  • Added night light, activity zone, and audio step cluster settings.
  • Added payment retry for subscriptions.
  • Added support for Android 17.
  • Made pet age optional and deprecated the pet Sleeping activity in favor of Resting.

🛠 Improvements & Optimizations

  • Enforced TLS 1.3 and added SSL pinning (gated behind a feature flag).
  • Introduced typed API error codes via enums.
  • Updated the image upload API.
  • Fixed main-thread work causing ANRs during SDK initialization.
  • Improved live view connection stability.

🐞 Bug Fixes

  • Fixed two-way camera not loading and a crash on two-way calls.
  • Fixed multi-live playback for single streams.
  • Replaced the deprecated device snapshot URL.
  • Fixed timezone handling for IDs ending with an offset.
  • Fixed an issue with event downloads.

Version 2026.02.21

Stable

🚀 Features

  • No longer need to wake up the device.
  • Updated sdk methods to accept device object.
  • Added Support for pet cameras.
  • Added support for 4g cameras.
  • Moved to private nexus server. Please check getting started for the integration.

Version 2025.08.21

🚀 Features

  • Added custom ffmpeg to conform with LGPL.
  • Added support for Stream type in live view and SD card playback.

Version 2025.08.18

Experimental

🚀 Features

  • Removed video scaling option from live view and SD card playback.
  • Added support for Stream type in live view and SD card playback.

Version 2025.08.14

Experimental

🚀 Features

  • Exposed method to get the downloaded file in the cache directory when downloading event.

Version 2025.08.11

Experimental

🚀 Features

  • Added support for video resolution scaling.

Version 2025.08.06.1

🚀 Features

  • Added support for NVRs.

🛠 Improvements & Optimizations

  • Exposed Coroutines in SDK methods to allow for better asynchronous handling.
  • Improved SD Card Playback with support V3 of the SD Card Playback API.

🐞 Bug Fixes

  • Fixed issue with live view sending multiple failed events. only the first event is now sent.

Version 2025.07.12.1

🚀 Features

  • Migrated WebRTCSurfaceViewRenderer to TextureViewRenderer for live view.

Version 2025.07.11.1

🚀 Features

  • Added support for EdgeAI Clusters.
  • Added support for Motion Detection Clusters.

🛠 Improvements & Optimizations

  • Added support for XML view for LiveViewTextureViewRenderer and SdCardTextureViewRenderer.

Version 2025.07.10

🚀 Features

  • Added support for RSSI and Manual Siren Clusters.

🛠 Improvements & Optimizations

  • Improved support for FeatureList by exposing map extensions.

Version 2025.07.08

💥 Breaking Changes

  • Migrated TextureViewRenderer to TextureViewRenderer for live view.

🛠 Improvements & Optimizations

  • Improved support for FeatureList.

Version 2025.06.18

🚀 Features

  • Added support for managing event settings.
  • Added support for managing notification settings.
  • Added support for BLE Pairing.

🛠 Improvements & Optimizations

  • Improved support for FeatureList.
  • Exposed extensions for checking if a device supports a feature.
  • Exposed extensions for getting cluster values.

Version 2025.06.16

🚀 Features

  • Added support for feature list.

Version 2025.04.03

💥 Breaking Changes

  • Migrated WebRTC from instavision.webrtc to instavision.webrtc.

🚀 Features

  • Added support for TZ timezone.

🛠 Improvements & Optimizations

  • Improved java interoperability.
  • Updated payload for subscriptions.
  • Added charging state for battery cameras.

🐞 Bug Fixes

  • Fixed issue with event duration not being optional.

Version 2025.03.20

🚀 Features

  • Added support for NVR.

🐞 Bug Fixes

  • Fixed issue with event durations sending 30 instead of 35 seconds.

🛠 Improvements & Optimizations

  • Added support to handle bulk download of events

Version 2025.03.12

🚀 Features

  • Added support for third party login.

🛠 Improvements & Optimizations

  • Updated event types to handle doorbell events.

Version 2025.03.05

🚀 Features

  • Added support for Doorbell Cameras.
  • Added support for Battery Cameras.

🛠 Improvements & Optimizations

  • Improved LiveView streaming performance.

Version 2025.02.20

🚀 Features

  • Core functionality for InstaVision Home Security SDK.
  • Features included
    • User Services
    • Space Services
    • Device Services
    • Event Services
    • Monitoring Services
    • Live View Streaming
    • SD Card Playback
    • Event Playback
  • Fully documented API with sample usage.

🛠 Improvements & Optimizations

  • Enabled transitive dependencies for third party libraries.

🐞 Known Issues

  • None
This site uses Just the Docs, a documentation theme for Jekyll.