Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md
VModal owl wearing smart glasses

VModal for Smart Glasses

Turn a first-person view into a live, reliable video experience.

Capture on the glasses. Encode on Android. Stream securely to your ingest.
Keep your product focused on the experience—not the media plumbing.

Android API 31+, Kotlin 2.2, Rust core, and SRT live transport

Smart glasses sending a live first-person video stream to a cloud ingest

Build for the point of view no phone camera can reach.

Start here

ResourceLink
💬Developer supportJoin the VModal AI Discord
🚀SDK quickstartBuild and start your first stream
🥽Android simulatorRun with Meta Mock Device Kit
🧭Developer portalExplore VModal developer resources
🌐VModal platformVisit VModal

[!NOTE] This SDK streams live camera video from Android smart glasses. For video upload, indexing, and multimodal search, use the VModal Android SDK instead.

Make presence feel immediate

VModal combines an Android-native Kotlin client with a high-throughput Rust media core. Your app owns the product experience; the SDK owns the demanding path between a wearable camera and your live ingest service.

Your smart-glass experienceVModal gives you
Remote expert supportReliable first-person video with reconnect behavior
Hands-free field workMeta DAT capture lifecycle and Android camera coordination
Live training and inspectionHardware H.264 encoding and MPEG-TS muxing
AR / VR companion experiencesA compact Kotlin API using Flow and StateFlow
Production streamingBounded queues, backpressure signals, metrics, and typed failures
Your own branded UXApp-owned authentication, permissions, registration, and controls

A clean path from glasses to ingest

flowchart LR
    G[Smart glasses] --> D[Meta DAT]
    D --> K[Android H.264]
    K --> R[Rust media core]
    R --> S[Encrypted SRT]
    S --> I[Live ingest]

    A[Your Android app] --> C[SmartGlassClient]
    B[Authenticated backend] --> T[Short-lived target]
    T --> C
    C --> K
    C --> R

The separation is deliberate:

  • Kotlin client manages the public API, Meta DAT integration, capture, MediaCodec, coroutine state, events, and lifecycle.
  • Rust core manages bounded encoded-media queues, H.264 normalization, MPEG-TS muxing, SRT transport, reconnects, and transport metrics.
  • Your app owns screens, permissions, Meta registration, foreground-service policy, authentication, and stream controls.
  • Your backend validates the user and returns a short-lived ingest target, keeping account-level provider credentials away from the device.

The Activity never needs to understand a JNI handle, SRT socket, or encoded GOP. The backend never needs to manage an Android camera session.

Build with the SDK

The implementation guide keeps the Kotlin and command-line setup in one place:

Open the Smart Glass SDK quickstart →

It covers prerequisites, local builds, SmartGlassClient creation, short-lived stream targets, state and metrics collection, and deterministic cleanup.

Engineered for wearable constraints

Bounded latency, not unbounded memory

GOP-aware backpressure and bounded queues keep a weak network from turning into ever-growing latency. The SDK can signal the Kotlin layer to drop safely or request a new keyframe when transport falls behind.

Recovery without a broken experience

SRT reconnects use configurable delays, jitter, and timeouts. When a target is expired or rejected, LiveStreamTargetProvider can fetch a fresh destination while the app continues to present one coherent stream lifecycle.

Native internals behind a Kotlin boundary

The public API does not expose Meta DAT types or Rust handles. Your host app owns the camera permission and registration experience; the SDK owns its one capture session only while streaming.

Metrics your support team can use

client.metrics exposes connection health, queue pressure, and transport behavior for a developer panel, field diagnostic screen, or support workflow.

Production integration checklist

  • Android API 31+, JDK 17, and Android compile SDK 36.
  • A compatible Meta smart-glasses registration and Meta Wearables DAT setup.
  • A user-facing camera permission and Meta registration flow in the host app.
  • A foreground service when streaming may continue outside the foreground.
  • An authenticated backend endpoint that returns a fresh LiveStreamTarget.
  • Exactly one SmartGlassClient for each active capture owner.
  • No competing camera session while SmartGlassClient is streaming.

The project provides two build flavors:

FlavorPurpose
offlineLocal lint and JVM tests without Meta artifacts or device credentials
metaReal-device integration with the Meta Wearables DAT dependencies

Keep credentials on the right side of the boundary

The app may briefly receive the SRT fields required to contribute live video. It should never contain account-level Cloudflare or live-platform credentials. After validating the app user, have your backend mint or lease a short-lived target; do not log or persist its stream ID or passphrase.

Explore the SDK


Build the view that only your user can see.

Resilient, native live video for Android smart glasses.

Talk with the VModal developer community →

关于 About

SDK for Visual Memory Search with Smart Glasses
google-glassgoogle-glassesmeta-glassessearch-imagesmart-glasssmart-glassessmart-glasses-appsmart-glasses-integrationsmart-glow-software-optimizationstreaming-analyticsstreaming-audiostreaming-videovideo-searchvideo-segmentationvideo-sharingvideo-streamvideo-streamingvisionvision-api

语言 Languages

Rust58.1%
Kotlin41.9%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
4
Total Commits
峰值: 2次/周
Less
More

核心贡献者 Contributors