gravix_effects 1.3.3
gravix_effects: ^1.3.3 copied to clipboard
Gravix Effects — real-time beauty filter, reshape, makeup and looks for Flutter livestreaming. Outputs: gravix_effects_webrtc, gravix_effects_agora.
1.3.3 - 2026-11-06 #
Effects are never switched off automatically any more. In 1.3.2 the low-end filter came on by itself on weak GPUs (for example Redmi Note 11, Infinix with Mali-G52) and on hot or slow phones, and removed reshape, lip tint, blush, teeth, under-eye and eye-brighten from every look, so most looks showed almost nothing. Now GravixLowEndFilter.auto (the default) keeps every effect, on every phone; the low-end filter runs only when your app asks for it with GravixLowEndFilter.on. Measured with the full glow look: Redmi Note 11 and Infinix X6728 both about 30 fps (preview, phone cool).
Fixed: on phones with a Mali GPU (for example Infinix X6728) a black band, repeated as nested rectangles ("tunnel"), could appear around the face.
1.3.2 - 2026-11-06 #
Forehead smoothing no longer climbs into the hair when the face is backlit (a bright window behind the person) or the head moves: the hairline finder stops on a long colour shift or when its skin reference dips and rises again, and one forehead column can no longer rise far above its neighbours.
Much less GPU work: the look's effects now run only around the face, and a small shader runs elsewhere. Same picture. On a hot Redmi Note 11 in a live room, the full look went from about 19 to 25-28 fps, and the low-end filter reached 30.
Frames are now shown in capture order, so uneven camera delivery no longer loses frames from the stream.
Low-end filter: on weak GPUs every look now runs without reshape and without lip tint, blush, teeth, under-eye and eye-brighten, processing at 480, to hold the frame rate. On stronger phones the same filter comes on automatically when the phone gets hot or cannot hold the frame rate, and goes off once after two cool minutes. GravixCamera.start(lowEndFilter: GravixLowEndFilter.off) keeps the full filter.
Camera: stays at the requested frame rate in every light. It no longer drops to 15 fps in dim rooms. Very dark rooms look darker and noisier; the fill light still lifts them.
1.3.1 - 2026-11-02 #
Licence: a renewed package removes the watermark within minutes. Nothing to call, and no new token is needed.
- While a licence is refused or expired, the SDK asks the server again every 5 minutes, and at app start if it has not asked in the last minute. Before, it asked once a day.
- In the last 10 minutes of a token, the SDK starts asking early, so renewing in time shows no watermark at all.
- Healthy apps still ask once a day.
1.3.0 - 2026-11-01 #
Automatic camera-aware picture quality (all on by default when the plugin runs the camera; nothing to call):
- Low light like TikTok: in a dark room the camera may slow to 15 fps for longer exposures (brighter, cleaner), and goes back to 30 fps in normal light. The extra brightening in the dark now follows how dark the whole camera picture is, not the face, so it is the same for every skin tone. No extra brightening in normal light.
- Auto colour balance: removes the camera's own colour cast (yellow in warm indoor light); the look's style stays. Neutral walls stay neutral whatever the look.
- Noise-aware sharpening and smoothing: each phone's camera noise is measured live; noise is never sharpened, and noisier cameras get a little more smoothing (at most +20 %).
glowlook: no longer warm-tinted (warmth 0.10 → 0). Some phones pause the camera for about half a second at the moment they switch between 30 fps and low-light mode.
1.2.1 - 2026-10-31 #
gravixEffectsPack=models(in the host'sandroid/gradle.properties): the app keeps only the small LiteRT native library and downloads the two face models (5 MB) on first use withGravixEffects.download(). Allowed on Google Play (no feature module), the same everywhere else: about 16 MB smaller installed on arm64 (10 MB less to download from Play). The default (unset) still bundles everything, unchanged.
1.2.0 - 2026-10-31 #
-
New
GravixEffectsAPI for the optional effects pack:availability(),availabilityChanges,download(onProgress:),cancelDownload(),remove(),configure(manifestUrl:, allowDirectNativeDownload:). Downloads resume after a cut connection or an app restart, every file is SHA-256 checked, and the pack is pinned inside the SDK (each SDK version accepts only its own official pack; a different pack needs a Gravix signature). Without the pack,gravixErrorsreportsE_TRACKER: not_installed: E_PACK_NOT_INSTALLED …once (never a crash). -
The face-tracking payload (face models, LiteRT native library, MediaPipe) moved from the Android SDK core into the effects pack
com.gravix:gravix-effects-pack. The plugin still includes it by default — nothing changes for existing apps.gravixEffectsPack=falsein the host'sandroid/gradle.propertiesleaves it out (~20 MB less uncompressed on arm64); face effects then stay off andstats()["trackerState"]reads"not_installed"until a pack is installed.
1.1.2 - 2026-10-26 #
- Online license refresh: once a day the SDK posts the token to Gravix Cloud (
POST /v1/effects/license). Gravix Cloud counts monthly active installs for your plan and returns a fresh token. Offline, the last token keeps working until it expires (7 days). New statuses from the server:LIMIT,REVOKED,UNKNOWN_APP; newGravixCamera.licenseStatus(). The SDK's Android manifest now declaresINTERNET.
1.1.1 - 2026-10-25 #
- Gravix Cloud production license key (kid
gfx-20261024). Tokens from the Gravix Cloud panel now verify, so the watermark goes away. Release builds no longer accept development-key tokens. - Fix:
switchCamera()on a phone with only one camera froze the picture until the next flip. It now throwsE_NO_CAMERAand the current camera keeps running; a failed rebind goes back to the previous camera.
1.1.0 - 2026-10-24 #
- Gravix Cloud license:
GravixCamera.setLicense(token)(Android:GravixLicense.set). Without a valid license the effects run with the Gravix Cloud watermark + QR (trial). - Shaders ship encrypted inside the SDK (no plain-text shaders in the AAR).
- Fix: 3D models of a look were dropped when a host applied it through the plugin.
- 3D looks (
.gfxformatVersion 7): up to 4 glTF models per look that follow the head, a head occluder, 14 face anchors, triggers (mouthOpen,blink,browRaise,headShake,smile, … withshow/hide/toggle/while), skinned / morph / clip animation. Seedocs/INTEGRATION.md§6b. - The plugin now declares
android.permission.CAMERAin its own manifest, so it is merged into the host app. Before, a host that forgot the line got a silently deniedrequestPermission()and no camera. - New look fields (
.gfxformatVersion 6):bgDenoise(soften a bright background),spotRemove(freckles / acne / spots),detailSmooth(skin fine-detail removal; < 0 = followsmoothness). The TouchUp starter look uses them. setAdjustmentsnow accepts every tone field at its full range — the TouchUp fields (meshMask, wrinkle, eyeBag, browContrast, clarity, foundation, catchLight, eyeColor) used to be clamped to 0, and any slider change dropped them from the current look.baseValues/currentValues/paramRangeslist them too.GravixBeautyPanel: the Beauty tab lists every skin / face / tone parameter in three sections.- Spot removal costs about a third of its former GPU time (ring statistics computed once per half-res texel); a Redmi Note 11 holds 29.5-30 fps with it on (27-28 before).
- CameraX 1.3.4 → 1.4.2. CameraX 1.3.4's
libimage_processing_util_jni.sois 4 KB-aligned, and Google Play rejected apps using this plugin ("does not support 16 KB memory page sizes"). No API change.
1.0.0 - 2026-09-28 #
First release for other developers (Android; iOS / web / desktop report E_UNSUPPORTED_PLATFORM).
- Camera owned by the plugin (CameraX); engine-drawn local preview (
GravixPreview). The filtered stream goes to your stack through an output package:gravix_effects_webrtc(flutter_webrtc / LiveKit track) orgravix_effects_agora(Agora custom video track); the core package depends on no streaming SDK. - Beauty: smoothing, brightness, whitening, even tone, dark circles, eye brightening, teeth, enhance, vibrance; 22 face-reshape controls; lipstick and blush with colours; LUT filters.
- Looks and stickers as
.gfxfiles — built-in, app asset, file, bytes or URL (validated, cached, offline-safe). - Ready-made beauty panel (
package:gravix_effects/beauty_ui.dart): Looks · Beauty · Reshape · Makeup · Stickers · Filters;GravixBeautyControllerkeeps and saves the user's choices. - Effects glued to the face in motion (SYNCED pairing, 250 ms fixed delay); audio/video kept in sync for viewers.
- Streaming frames as I420 for every encoder (software VP8 included) at 24–30 fps on budget phones; texture mode for hardware encoders.
- Drop-in
BeautyFiltercompatibility API for apps migrating from the legacy filter.