djaus2_MauiMediaRecorderVideoLib 3.0.2

MauiMediaRecorderVideoLib

A .NET MAUI library for Android video recording plus Audio using MediaRecorder with camera preview and stabilization features.

Now waits for the user to accept Camera before starting the camera preview.
Both Release and Debug versions of test app work.

Nb: The solution of test app plus this lib as one solution is a private repository.

Test App Repository

djaus2/MauiMediaRecorderVideoAndroidApp

About

This library is being developed to target a sporting Phototiming app. See djaus2/PhotoTimingDjaus

Features

• Full-screen camera preview
• Video recording with MediaRecorder
  • Now includes audio recording
• Image stabilization options (Standard or Locked)
• Camera rotation support (0, 90, 180, 270 degrees)
• Configurable video FPS (30, 60, or default)
• Support for pausing and resuming recording
• Proper handling of Android permissions
• Screen dimensions detection for optimal preview
• Added: Gun Button Functuionality to append start time to video filename.
• Added: Crosshairs overlay for aiming assistance
• Added: TimeFromMode property to indicate to Stitching app the method to use to determine guntime. (Appends text to video filename)

Usage with a MAUI Android Phone App

Installation

Start by creating a new .NET MAUI project or using an existing one.

Install the package via NuGet:

dotnet add package MauiMediaRecorderVideoLib

Also need to install the following NuGet package:

dotnet add package CommunityToolkit.Maui.Camera

Nb: CommunityToolkit.Maui.Camera is in the library but needs a reference in the App as it uses the Toolkit Peview.

Basic Setup

See the sample app for details. The following is a summary of the steps to get started:

1. Add the required permissions to your Android/Manifest.xaml:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO"/>

2. Add call to activate permsssions in Android/MainActivity.cs:

    public class MainActivity : MauiAppCompatActivity
  {
      protected override void OnCreate(Bundle? savedInstanceState)
      {
          base.OnCreate(savedInstanceState); // Ensure base initialization always occurs

          VideoKapture.RequestPermissionsStatic();
      }
  }

This is the point at which the app requests permissions. The method actually iterates through the permissions in the Android/Manifest file and requests them.

3. In MauiProgram.cs, add the following line to register the library:

using MauiMediaRecorderVideoLib;

Include the Toolkit:

builder
   .UseMauiApp<App>()
   .UseMauiCommunityToolkitCamera() <- Add this
   ...

In the Builder setup, add the following lines to register the camera preview handler and configure camera services:

    builder.ConfigureMauiHandlers(handlers =>
    {
        handlers.AddHandler(typeof(CameraPreviewView), typeof(MauiAndroidCameraViewLib.Platforms.Android.CameraPreviewHandler));
    });
    MauiAndroidCameraViewLib.MauiCameraServicesSetup.ConfigureCameraServices(builder);

The following is in MainPage.cs:

4. Initialize the video recorder service:

using MauiMediaRecorderVideoLib;

// Initialize the service
_VideoKapture = new VideoKapture(this, CameraPreview);

5. Submit the video filenamme to the service:

_VideoKapture.OnFilenameCompleted(filename);

6. Start Preview:

    var activity = Platform.CurrentActivity;
    await _VideoKapture.OnButton_GetReady4Recording(activity);

7. Start Recording:

    await _VideoKapture.OnButton_StartRecording_Clicked();

8. Pause Recording:

    await _VideoKapture.OnButton_PauseRecording_Clicked();

9. Continue Recording:

    await _VideoKapture.OnButton_ContinueRecording_Clicked();

10. Stop Recording:

    await _VideoKapture.OnButton_StopRecording_Clicked();

11. A button can be added to toggle visibility of the crosshairs.
    The button is added to the XAML file and the code behind is as follows:

    _VideoKapture.ViewModel.EnableCrossHairs = !_VideoKapture.ViewModel.EnableCrossHairs;

There is also code to set the framerate at 30 or 60 FPS and to enable image stabilisaztion. See the sample app.

Requirements

• .NET MAUI project targeting Android
• Android API level 21 or higher
• Requires Android device with camera