gdagitrep / native_screenshot_ext

Other
1 stars 4 forks source link

native_screenshot

This plugin aims to be a simple one that implements taking screenshot natively to capture scenes like camera preview or AR views. This cannot be done easily in plain Flutter, at least I cannot make it work using RenderRepaintBoundary and similar techniques.

The main difference with another packages is that they shows a share dialog. This plugin saves the image and returns the path to it. On Android also launch an updating request (internally) to reload the media library.

Instalation

Add

native_screenshot: ^<latest_version>

to your pubspec.yaml file.

Android

If you are calling takeScreenshotImage method, you don't need to add anything.

If you want to call takeScreenshot method, you must add

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

to your AndroidManifest.xml inside android/src/main/ directory.

Also you need to add a property to application tag to fix an issue with permissions writing to EXTERNAL_STORAGE:

android:requestLegacyExternalStorage="true"

iOS

If you are calling takeScreenshotImage method, you don't need to add anything.

If don't add and call takeScreenshot method

<key>NSPhotoLibraryAddUsageDescription</key>
<string>Take pretty screenshots and save it to the PhotoLibrary.</string>

to your info.plist file inside ios/Runner directory, the application will crash.

Use

Import the library:

import 'package:native_screenshot_ext/native_screenshot_ext.dart';

and take a screenshot:

String path = await NativeScreenshot.takeScreenshot()

You can choose to let the function return the image Int array, instead of making it save (in which case, you may not need to add android:requestLegacyExternalStorage="true"/<key>NSPhotoLibraryAddUsageDescription</key> to android/iOS

Uint8List pngData = await NativeScreenshot.takeScreenshotImage(50) as Uint8List; 

In error case the function returns null and the screenshot path if success.

Acknowledgments

This is based on screenshot_share_image and capture_and_share packages. Thanks to @toonztudio for pointing me out replying in Github.