tauri-plugin-camera-kessdev 0.1.1-beta.3 → 0.1.1-beta.4

package/README.md

@@ -128,7 +128,10 @@ import {
   stopRecording,
   flipCamera,
   setFlash,
+  isFlashAvailable,
   setZoom,
+  getZoom,
+  getZoomRange,
   saveToGallery,
   checkPermissions,
   requestPermissions,
@@ -168,8 +171,23 @@ await startRecording()
 // ... user records ...
 const video = await stopRecording()
 // video: { path, duration } (mobile) | { duration, blob, url } (desktop)
+
+// Optionally request a base64 JPEG thumbnail of the recording:
+const withThumbnail = await stopRecording({ thumbnail: true })
+// withThumbnail.thumbnail: string | undefined
 ```
 
+### Video thumbnail
+
+Pass `{ thumbnail: true }` to `stopRecording()` to include a base64-encoded JPEG
+poster frame in the `Video` result. It is opt-in because it costs a frame decode
+and encode. When it cannot be generated the field is omitted (the recording still
+succeeds).
+
+- **Android**: extracted with `MediaMetadataRetriever` on the recording executor.
+- **iOS**: extracted with `AVAssetImageGenerator` at ~0.1 s (avoids a black first frame).
+- **Desktop**: captured from the live preview stream at stop time.
+
 ### Recording progress (telemetry)
 
 Pass an `onProgress` channel to `startRecording()` to receive live telemetry while
@@ -214,14 +232,27 @@ ends. Telemetry is never emitted after `stopRecording()` resolves.
 await flipCamera()
 await setFlash('on') // 'on' | 'off' | 'auto'
 await setZoom(2.0)
+
+// Query the active camera (mobile). Desktop has no zoom/flash control:
+const zoom = await getZoom()                       // number
+const range = await getZoomRange()                 // { min, max, current }
+const hasFlash = await isFlashAvailable()          // boolean (false on desktop)
 ```
 
+On desktop `getZoom()` and `getZoomRange()` reject with a descriptive error
+(consistent with `setZoom`), while `isFlashAvailable()` resolves to `false`.
+
 ### Gallery
 
 ```ts
-await saveToGallery(photo.path) // mobile only
+await saveToGallery(photo.path)                 // image
+await saveToGallery(video.path)                 // video
+await saveToGallery(media.path, { type: 'video' }) // forced type override
 ```
 
+Mobile only. The media type is inferred from the file extension (mp4, mov, m4v,
+webm, 3gp, mkv are treated as video); pass `{ type }` to force it.
+
 ### Permissions
 
 ```ts
@@ -360,11 +391,15 @@ destination from the generated Xcode project (`src-tauri/gen/apple`).
 | `capture(options?)` | ✓ `ImageCapture` / `AVCapturePhotoOutput` | ✓ canvas |
 | `flipCamera()` | ✓ | ✗ (throws) |
 | `setFlash(mode)` | ✓ | ✗ (throws) |
+| `isFlashAvailable()` | ✓ | `false` |
 | `setZoom(factor)` | ✓ | ✗ (throws) |
+| `getZoom()` | ✓ | ✗ (throws) |
+| `getZoomRange()` | ✓ | ✗ (throws) |
 | `startRecording(options?)` | ✓ `VideoCapture` / `AVCaptureMovieFileOutput` | ✓ `MediaRecorder` |
-| `stopRecording()` | ✓ | ✓ |
+| `stopRecording(options?)` | ✓ | ✓ |
 | `RecordingProgress` telemetry (`onProgress` channel) | ✓ | ✓ |
-| `saveToGallery(path)` | ✓ | ✗ (throws) |
+| `Video.thumbnail` (`stopRecording({ thumbnail: true })`) | ✓ | ✓ |
+| `saveToGallery(path, options?)` | ✓ image & video | ✗ (throws) |
 | `checkPermissions()` | ✓ | ✓ |
 | `requestPermissions()` | ✓ | ✓ |
 | `openAppSettings()` | ✓ | ✗ (throws) |

package/dist-js/index.cjs

@@ -181,6 +181,31 @@ async function setZoom(factor) {
     }
     throw new Error('setZoom is not supported on desktop.');
 }
+/** Gets the current camera zoom factor (mobile). */
+async function getZoom() {
+    if (isMobile()) {
+        return await core.invoke('plugin:camera-kessdev|get_zoom');
+    }
+    throw new Error('getZoom is not supported on desktop.');
+}
+/** Gets the supported zoom range of the active camera (mobile). */
+async function getZoomRange() {
+    if (isMobile()) {
+        return await core.invoke('plugin:camera-kessdev|get_zoom_range');
+    }
+    throw new Error('getZoomRange is not supported on desktop.');
+}
+/**
+ * Returns whether the active camera has a flash unit.
+ *
+ * On desktop this always resolves to `false` (no flash control).
+ */
+async function isFlashAvailable() {
+    if (isMobile()) {
+        return await core.invoke('plugin:camera-kessdev|is_flash_available');
+    }
+    return false;
+}
 // ---------------------------------------------------------------------------
 // Video recording
 // ---------------------------------------------------------------------------
@@ -228,14 +253,15 @@ async function startRecording(options) {
     }
 }
 /** Stops video recording and returns the recorded media. */
-async function stopRecording() {
+async function stopRecording(options) {
     if (isMobile()) {
-        return await core.invoke('plugin:camera-kessdev|stop_recording');
+        return await core.invoke('plugin:camera-kessdev|stop_recording', { ...options });
     }
     if (!mediaRecorder) {
         throw new Error('Recording is not active. Call startRecording() first.');
     }
     const duration = (performance.now() - recordingStartedAt) / 1000;
+    const thumbnail = options?.thumbnail ? captureDesktopThumbnail() : undefined;
     stopProgressTimer();
     return await new Promise((resolve, reject) => {
         mediaRecorder.onstop = () => {
@@ -245,23 +271,48 @@ async function stopRecording() {
             recordedChunks = [];
             recordedBytes = 0;
             mediaRecorder = null;
-            resolve({ duration, blob, url });
+            const result = { duration, blob, url };
+            if (thumbnail)
+                result.thumbnail = thumbnail;
+            resolve(result);
         };
         mediaRecorder.onerror = () => reject(new Error('Video recording failed.'));
         mediaRecorder.stop();
     });
 }
+/** Captures the current desktop preview frame as a base64 JPEG thumbnail. */
+function captureDesktopThumbnail() {
+    if (!activeVideo || !activeVideo.videoWidth || !activeVideo.videoHeight) {
+        return undefined;
+    }
+    try {
+        const canvas = document.createElement('canvas');
+        canvas.width = activeVideo.videoWidth;
+        canvas.height = activeVideo.videoHeight;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            return undefined;
+        ctx.drawImage(activeVideo, 0, 0, canvas.width, canvas.height);
+        return canvas.toDataURL('image/jpeg');
+    }
+    catch {
+        return undefined;
+    }
+}
 // ---------------------------------------------------------------------------
 // Gallery
 // ---------------------------------------------------------------------------
 /**
- * Saves a captured image to the device photo gallery (mobile).
+ * Saves a captured photo or video to the device gallery (mobile).
+ *
+ * The media type is inferred from the file extension; pass `options.type` to
+ * force it. On desktop this is not supported.
  *
- * @param path Absolute path to the image file.
+ * @param path Absolute path to the media file.
  */
-async function saveToGallery(path) {
+async function saveToGallery(path, options) {
     if (isMobile()) {
-        await core.invoke('plugin:camera-kessdev|save_to_gallery', { path });
+        await core.invoke('plugin:camera-kessdev|save_to_gallery', { path, ...options });
         return;
     }
     throw new Error('saveToGallery is not supported on desktop.');
@@ -313,6 +364,9 @@ exports.capture = capture;
 exports.checkPermissions = checkPermissions;
 exports.flipCamera = flipCamera;
 exports.getPreviewStream = getPreviewStream;
+exports.getZoom = getZoom;
+exports.getZoomRange = getZoomRange;
+exports.isFlashAvailable = isFlashAvailable;
 exports.openAppSettings = openAppSettings;
 exports.requestPermissions = requestPermissions;
 exports.saveToGallery = saveToGallery;

package/dist-js/index.d.ts

@@ -34,6 +34,14 @@ export interface Video {
     blob?: Blob;
     /** Object URL for the recorded video (desktop). */
     url?: string;
+    /** Optional base64-encoded thumbnail, when requested via `stopRecording`. */
+    thumbnail?: string;
+}
+/** Supported zoom range of the active camera. */
+export interface ZoomRange {
+    min: number;
+    max: number;
+    current: number;
 }
 /**
  * Live telemetry emitted while a video recording is in progress.
@@ -54,6 +62,14 @@ export interface StartRecordingOptions {
     /** Receives live recording telemetry while the recording is active. */
     onProgress?: Channel<RecordingProgress>;
 }
+export interface StopRecordingOptions {
+    /** When true, the result includes a base64-encoded `thumbnail`. */
+    thumbnail?: boolean;
+}
+export interface SaveToGalleryOptions {
+    /** Force the media type instead of inferring it from the file. */
+    type?: 'image' | 'video';
+}
 /**
  * Starts the camera preview.
  *
@@ -85,16 +101,29 @@ export declare function flipCamera(): Promise<void>;
 export declare function setFlash(mode: FlashMode): Promise<void>;
 /** Sets the camera zoom factor (mobile). */
 export declare function setZoom(factor: number): Promise<void>;
+/** Gets the current camera zoom factor (mobile). */
+export declare function getZoom(): Promise<number>;
+/** Gets the supported zoom range of the active camera (mobile). */
+export declare function getZoomRange(): Promise<ZoomRange>;
+/**
+ * Returns whether the active camera has a flash unit.
+ *
+ * On desktop this always resolves to `false` (no flash control).
+ */
+export declare function isFlashAvailable(): Promise<boolean>;
 /** Starts video recording (with audio). */
 export declare function startRecording(options?: StartRecordingOptions): Promise<void>;
 /** Stops video recording and returns the recorded media. */
-export declare function stopRecording(): Promise<Video>;
+export declare function stopRecording(options?: StopRecordingOptions): Promise<Video>;
 /**
- * Saves a captured image to the device photo gallery (mobile).
+ * Saves a captured photo or video to the device gallery (mobile).
+ *
+ * The media type is inferred from the file extension; pass `options.type` to
+ * force it. On desktop this is not supported.
  *
- * @param path Absolute path to the image file.
+ * @param path Absolute path to the media file.
  */
-export declare function saveToGallery(path: string): Promise<void>;
+export declare function saveToGallery(path: string, options?: SaveToGalleryOptions): Promise<void>;
 /** Gets the current camera permission state. */
 export declare function checkPermissions(): Promise<PermissionState>;
 /** Requests camera permission. */

package/dist-js/index.js

@@ -180,6 +180,31 @@ async function setZoom(factor) {
     }
     throw new Error('setZoom is not supported on desktop.');
 }
+/** Gets the current camera zoom factor (mobile). */
+async function getZoom() {
+    if (isMobile()) {
+        return await invoke('plugin:camera-kessdev|get_zoom');
+    }
+    throw new Error('getZoom is not supported on desktop.');
+}
+/** Gets the supported zoom range of the active camera (mobile). */
+async function getZoomRange() {
+    if (isMobile()) {
+        return await invoke('plugin:camera-kessdev|get_zoom_range');
+    }
+    throw new Error('getZoomRange is not supported on desktop.');
+}
+/**
+ * Returns whether the active camera has a flash unit.
+ *
+ * On desktop this always resolves to `false` (no flash control).
+ */
+async function isFlashAvailable() {
+    if (isMobile()) {
+        return await invoke('plugin:camera-kessdev|is_flash_available');
+    }
+    return false;
+}
 // ---------------------------------------------------------------------------
 // Video recording
 // ---------------------------------------------------------------------------
@@ -227,14 +252,15 @@ async function startRecording(options) {
     }
 }
 /** Stops video recording and returns the recorded media. */
-async function stopRecording() {
+async function stopRecording(options) {
     if (isMobile()) {
-        return await invoke('plugin:camera-kessdev|stop_recording');
+        return await invoke('plugin:camera-kessdev|stop_recording', { ...options });
     }
     if (!mediaRecorder) {
         throw new Error('Recording is not active. Call startRecording() first.');
     }
     const duration = (performance.now() - recordingStartedAt) / 1000;
+    const thumbnail = options?.thumbnail ? captureDesktopThumbnail() : undefined;
     stopProgressTimer();
     return await new Promise((resolve, reject) => {
         mediaRecorder.onstop = () => {
@@ -244,23 +270,48 @@ async function stopRecording() {
             recordedChunks = [];
             recordedBytes = 0;
             mediaRecorder = null;
-            resolve({ duration, blob, url });
+            const result = { duration, blob, url };
+            if (thumbnail)
+                result.thumbnail = thumbnail;
+            resolve(result);
         };
         mediaRecorder.onerror = () => reject(new Error('Video recording failed.'));
         mediaRecorder.stop();
     });
 }
+/** Captures the current desktop preview frame as a base64 JPEG thumbnail. */
+function captureDesktopThumbnail() {
+    if (!activeVideo || !activeVideo.videoWidth || !activeVideo.videoHeight) {
+        return undefined;
+    }
+    try {
+        const canvas = document.createElement('canvas');
+        canvas.width = activeVideo.videoWidth;
+        canvas.height = activeVideo.videoHeight;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            return undefined;
+        ctx.drawImage(activeVideo, 0, 0, canvas.width, canvas.height);
+        return canvas.toDataURL('image/jpeg');
+    }
+    catch {
+        return undefined;
+    }
+}
 // ---------------------------------------------------------------------------
 // Gallery
 // ---------------------------------------------------------------------------
 /**
- * Saves a captured image to the device photo gallery (mobile).
+ * Saves a captured photo or video to the device gallery (mobile).
+ *
+ * The media type is inferred from the file extension; pass `options.type` to
+ * force it. On desktop this is not supported.
  *
- * @param path Absolute path to the image file.
+ * @param path Absolute path to the media file.
  */
-async function saveToGallery(path) {
+async function saveToGallery(path, options) {
     if (isMobile()) {
-        await invoke('plugin:camera-kessdev|save_to_gallery', { path });
+        await invoke('plugin:camera-kessdev|save_to_gallery', { path, ...options });
         return;
     }
     throw new Error('saveToGallery is not supported on desktop.');
@@ -304,4 +355,4 @@ async function openAppSettings() {
     throw new Error('openAppSettings is not supported on desktop.');
 }
 
-export { capture, checkPermissions, flipCamera, getPreviewStream, openAppSettings, requestPermissions, saveToGallery, setFlash, setZoom, startPreview, startRecording, stopPreview, stopRecording };
+export { capture, checkPermissions, flipCamera, getPreviewStream, getZoom, getZoomRange, isFlashAvailable, openAppSettings, requestPermissions, saveToGallery, setFlash, setZoom, startPreview, startRecording, stopPreview, stopRecording };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-plugin-camera-kessdev",
-  "version": "0.1.1-beta.3",
+  "version": "0.1.1-beta.4",
   "author": "kess",
   "description": "Camera plugin for Tauri v2: photo capture, video recording and preview on Android, iOS and desktop.",
   "license": "MIT",