README.md

NatCorder With OpenCVForUnity Example

• An example of a video recording app by using NatCorder and OpenCVForUnity.
• An example of native sharing and save to the camera roll using NatShare API.

Environment

• Anddroid (Pixel 3a) / iOS (iPhoneSE2)
• Unity >= 2020.3.31f1+
• Scripting backend MONO / IL2CPP
• NatCorder - Video Recording API 1.8.2+
• NatShare - Mobile Sharing API 1.2.6+
• OpenCV for Unity 2.4.7+

Demo

• Android NatCorderWithOpenCVForUnityExample.apk

Note

• Using HEIF or HEVC media on Apple devices

Setup

1. Download the latest release unitypackage. NatCorderWithOpenCVForUnityExample.unitypackage
2. Create a new project. (NatCorderWithOpenCVForUnityExample)
   • Enable "Allow 'unsafe' Code" option in the "Player Settings > Other Settings" Inspector.
3. Import NatCorder.
4. Import NatShare. (NatShare should be installed using the Unity Package Manager. See README)
5. Import OpenCVForUnity.
   • Setup the OpenCVForUnity. (Tools > OpenCV for Unity > Set Plugin Import Settings)
   • Select MenuItem[Tools/OpenCV for Unity/Use Unsafe Code].
6. Import the NatCorderWithOpenCVForUnityExample.unitypackage.
7. Change the "Minimum API Level" to 24 or higher in the "Player Settings (Androd)" Inspector.
8. Change the "Target minimum iOS Version" to 13 or higher in the "Player Settings (iOS)" Inspector.
   • Set the reason for accessing the camera in "cameraUsageDescription".
   • Set the reason for accessing the microphone in "microphoneUsageDescription".
9. Add the "Assets/NatCorderWithOpenCVForUnityExample/*.unity" files to the "Scenes In Build" list in the "Build Settings" window.
10. Build and Deploy to Android and iOS.

Android Instructions

Build requires Android SDK Platform 29 or higher.

iOS Instructions

After building an Xcode project from Unity, add the following keys to the Info.plist file with a good description:

• NSPhotoLibraryUsageDescription
• NSPhotoLibraryAddUsageDescription

ScreenShot