Plugin.Maui.VoiceOrb 1.0.0

Plugin.Maui.VoiceOrb

An animated, audio-reactive voice orb control for .NET MAUI, in the style of modern voice assistants. A soft, glowing sphere that breathes at rest and deforms organically with live audio.

Renders on a fully transparent SkiaSharp canvas, so it layers over any page, gradient, image or video. Depends only on SkiaSharp — bring your own audio, or add Plugin.Maui.VoiceOrb.Audio for microphone capture.

Setup

using Plugin.Maui.VoiceOrb;

builder.UseMauiApp<App>()
       .UseVoiceOrb();   // initialises SkiaSharp

Use

<ContentPage xmlns:orb="clr-namespace:Plugin.Maui.VoiceOrb;assembly=Plugin.Maui.VoiceOrb">
    <orb:VoiceOrbView x:Name="Orb"
                      HeightRequest="320" WidthRequest="320"
                      State="Idle"
                      PrimaryColor="#9A8CFF" SecondaryColor="#5A50DC"
                      GlowColor="#7878FF"   PulseColor="White"
                      MorphStrength="1.2"   AnimationSpeed="1.0"
                      ShowGlow="True"       IsInteractive="True" />
</ContentPage>

Then feed it loudness:

Orb.SetAudioLevel(level);          // 0..1, safe to call from an audio thread
Orb.SetState(OrbState.Listening);  // Idle | Listening | Speaking | Thinking

SetAudioLevel accepts values at whatever rate your capture delivers them. The control smooths with a fast attack and slow release, so it tracks speech without strobing on every consonant, and repaints itself at 60 fps.

API

Only Listening and Speaking react to audio; Idle and Thinking ignore the level.

Bring your own audio

Implement IAudioLevelSource to drive the orb from a speech SDK, a playback engine or a network stream. SimulatedAudioLevelSource ships in the box and produces a speech-shaped envelope, which is handy for designing without a microphone.

IAudioLevelSource source = new SimulatedAudioLevelSource(Dispatcher);
source.LevelChanged += (_, level) => Orb.SetAudioLevel(level);
await source.StartAsync();

Notes

• Everything is sized relative to the view, so the orb looks identical at any DPI, and nothing is ever clipped by the view bounds.
• The animation timer starts on Loaded and stops on Unloaded, so an off-screen orb costs nothing.
• Give the view room: the halo extends to the edge of its bounds, so a square roughly twice the visual orb diameter looks best.