👁 Image
Sportronics.MauiMediaRecorderVideoLib 3.3.1

MauiMediaRecorderVideoLib

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

Nb: THIS README NEEDS AN UPDATE.

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/AthsVideoRecording

About

This library is being developed to target a sporting Photo Timing/Finish app. See djaus2/AthsVideoRecording

History

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