Capacitor plugin to take screenshot for iOS and Android devices.
The main goal of this plugin is to be able to take a screenshot of the application exactly as you see it. Even if there are playing videos, an iframe with some content, a cross-origin CSS...etc.
This plugin uses the takeSnapshot method of the WKWebView for iOS : https://developer.apple.com/documentation/webkit/wkwebview/2873260-takesnapshot.
And for Android, the MediaProjection API : https://developer.android.com/reference/android/media/projection/MediaProjection.
For the web, MediaDevices is use to cast the browser tab : https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia.
npm install @intuiface/capacitor-plugin-screenshot
npx cap syncgetScreenshot(options: ScreenshotOptions) => Promise<ScreenshotValue | null>Function to take a screenshot
| Param | Type | Description |
|---|---|---|
options |
ScreenshotOptions |
: options with quality desired for the screenshot |
Returns: Promise<ScreenshotValue | null>
| Prop | Type | Description |
|---|---|---|
base64 |
string |
The base64 string of the screenshot. Can be null |
URI |
string |
The file uri where the image is saved Can be null |
| Prop | Type | Description |
|---|---|---|
size |
number |
The desired size (here width) of the screenshot |
quality |
number |
The quality of the screenshot between 0-100 |
name |
string |
The name of the file to save |
iOS version 11+ is supported.
Nothing more to do, it should work by calling the getScreenshot function.
Android Version 6+ is supported.
To be able to take screenshot on Android, you have to declare a foreground service in the AndroidManifest.xml in the application tag :
<service android:enabled="true" android:foregroundServiceType="mediaProjection" android:name="com.intuiface.plugins.screenshot.ScreenCaptureService" />The foreground service will ask you to cast your screen and this is mandatory to take screenshot with the MediaProjection API.
The scripts and documentation in this project are released under the MIT License