Document DB v7: Temporal Support Feed The Machine Here

Motion Activity

Getting Started


GitHub
Downloads

Frameworks

.NET MAUI

Operating Systems

Android

iOS

Shiny provides cross-platform motion activity recognition, allowing your app to detect whether the user is walking, running, cycling, driving, or stationary.

On iOS, this uses CMMotionActivityManager from the CoreMotion framework.
On Android, this uses Google Play Services Activity Recognition API.

Setup

// Without a background delegate
services.AddMotionActivity();

// With a background delegate for processing activity changes in the background
services.AddMotionActivity<MyMotionActivityDelegate>();

Platform Permissions

iOS: Add to Info.plist:

<key>NSMotionUsageDescription</key>
<string>This app uses motion activity to detect your movement type</string>

Android: The ACTIVITY_RECOGNITION permission is required and will be requested automatically via RequestAccess().

Observing Motion Activity

Foreground (C# Event)

Subscribe to MotionActivityReadingReceived to observe activity changes in the UI. Rx has been removed from Shiny.Locations — this is a plain event EventHandler<MotionActivityReading>.

public class MyViewModel : IDisposable
{
    readonly IMotionActivityManager activityManager;

    public MyViewModel(IMotionActivityManager activityManager)
    {
        this.activityManager = activityManager;
    }

    public async Task Start()
    {
        var access = await this.activityManager.RequestAccess();
        if (access != AccessState.Available)
            return;

        await this.activityManager.StartListener();
        this.activityManager.MotionActivityReadingReceived += this.OnReading;
    }

    public async Task Stop()
    {
        this.activityManager.MotionActivityReadingReceived -= this.OnReading;
        await this.activityManager.StopListener();
    }

    void OnReading(object? sender, MotionActivityReading reading)
    {
        // reading.Activity    → MotionActivityType (Walking, Running, Cycling, etc.)
        // reading.Confidence  → MotionActivityConfidence (Low, Medium, High)
        // reading.Timestamp   → DateTimeOffset
    }

    public void Dispose()
        => this.activityManager.MotionActivityReadingReceived -= this.OnReading;
}

Background (Delegate)

Implement IMotionActivityDelegate for processing activity changes even when the app is backgrounded:

public class MyMotionActivityDelegate : IMotionActivityDelegate
{
    readonly ILogger<MyMotionActivityDelegate> logger;

    public MyMotionActivityDelegate(ILogger<MyMotionActivityDelegate> logger)
    {
        this.logger = logger;
    }

    public Task OnReading(MotionActivityReading reading)
    {
        this.logger.LogInformation(
            "Activity: {Activity}, Confidence: {Confidence}",
            reading.Activity,
            reading.Confidence
        );
        return Task.CompletedTask;
    }
}

services.AddMotionActivity<MyMotionActivityDelegate>();

API Reference

IMotionActivityManager

Member	Return Type	Description
`IsListening`	`bool`	Whether the manager is currently listening
`GetCurrentStatus()`	`AccessState`	Get current permission status without prompting
`RequestAccess()`	`Task<AccessState>`	Request permission to use motion activity
`GetLastReading()`	`Task<MotionActivityReading?>`	Get the last known reading, querying the platform if needed
`MotionActivityReadingReceived`	`event EventHandler<MotionActivityReading>`	Foreground stream of activity changes
`StartListener()`	`Task`	Start listening for activity changes
`StopListener()`	`Task`	Stop listening for activity changes

MotionActivityType

Value	Description
`Unknown`	Activity could not be determined
`Stationary`	Device is not moving
`Walking`	User is walking
`Running`	User is running
`Cycling`	User is cycling
`Automotive`	User is in a vehicle

MotionActivityConfidence

Value	Description
`Low`	Low confidence in the detected activity
`Medium`	Medium confidence
`High`	High confidence

AI Coding Assistant

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-client@shiny

Step 1 — Add the marketplace:

copilot plugin marketplace add https://github.com/shinyorg/skills

Step 2 — Install the plugin:

copilot plugin install shiny-client@shiny

View shiny-client Plugin