# @studiokloek/capacitor-plugin-mediacapture

> test

Latest version **6.0.4** (published 2025-06-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @studiokloek/capacitor-plugin-mediacapture
pnpm add @studiokloek/capacitor-plugin-mediacapture
yarn add @studiokloek/capacitor-plugin-mediacapture
bun add @studiokloek/capacitor-plugin-mediacapture
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 6.0.4 |
| Published | 2025-06-10 |
| First published | 2021-10-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 103.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Martijn Swart |
| Maintainers | martijnswart |
| Keywords | capacitor, plugin, native |

## Links

- npm: https://www.npmjs.com/package/@studiokloek/capacitor-plugin-mediacapture
- Repository: https://github.com/studiokloek/capacitor-plugin-mediacapture
- Issues: https://github.com/studiokloek/capacitor-plugin-mediacapture/issues
- npm.io page: https://npm.io/package/@studiokloek/capacitor-plugin-mediacapture

## Recent versions

- 6.0.4 (latest) — 2025-06-10
- 6.0.3 — 2025-06-10
- 6.0.2 — 2024-07-18
- 6.0.1 — 2024-07-15
- 6.0.0 — 2024-07-15
- 4.0.3 — 2023-02-23
- 4.0.2 — 2023-02-23
- 4.0.1 — 2023-02-23
- 4.0.0 — 2023-02-22
- 1.0.1 — 2021-10-01

## README

# @studiokloek/capacitor-plugin-mediacapture

This capacitor plugin allows iOS applications to capture media from the camera and microphone.

## Install

```bash
yarn add @studiokloek/capacitor-plugin-mediacapture
npx cap sync
```

## API

<docgen-index>

* [`checkPermissions()`](#checkpermissions)
* [`requestPermissions(...)`](#requestpermissions)
* [`startCameraSession(...)`](#startcamerasession)
* [`stopCameraSession()`](#stopcamerasession)
* [`showCameraPreview(...)`](#showcamerapreview)
* [`hideCameraPreview(...)`](#hidecamerapreview)
* [`startCameraRecording(...)`](#startcamerarecording)
* [`stopCameraRecording()`](#stopcamerarecording)
* [`grabCameraImage(...)`](#grabcameraimage)
* [`startMicrophoneSession(...)`](#startmicrophonesession)
* [`stopMicrophoneSession()`](#stopmicrophonesession)
* [`startMicrophoneRecording(...)`](#startmicrophonerecording)
* [`stopMicrophoneRecording()`](#stopmicrophonerecording)
* [Interfaces](#interfaces)
* [Type Aliases](#type-aliases)

</docgen-index>

<docgen-api>
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

### checkPermissions()

```typescript
checkPermissions() => Promise<PermissionStatus>
```

**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>

--------------------


### requestPermissions(...)

```typescript
requestPermissions(permissions?: MediaCapturePluginPermissions | undefined) => Promise<PermissionStatus>
```

| Param             | Type                                                                                    |
| ----------------- | --------------------------------------------------------------------------------------- |
| **`permissions`** | <code><a href="#mediacapturepluginpermissions">MediaCapturePluginPermissions</a></code> |

**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>

--------------------


### startCameraSession(...)

```typescript
startCameraSession(options: CameraSessionOptions) => Promise<boolean>
```

| Param         | Type                                                                  |
| ------------- | --------------------------------------------------------------------- |
| **`options`** | <code><a href="#camerasessionoptions">CameraSessionOptions</a></code> |

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### stopCameraSession()

```typescript
stopCameraSession() => Promise<boolean>
```

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### showCameraPreview(...)

```typescript
showCameraPreview(options: CameraPreviewShowOptions) => Promise<boolean>
```

| Param         | Type                                                                          |
| ------------- | ----------------------------------------------------------------------------- |
| **`options`** | <code><a href="#camerapreviewshowoptions">CameraPreviewShowOptions</a></code> |

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### hideCameraPreview(...)

```typescript
hideCameraPreview(options: CameraPreviewHideOptions) => Promise<boolean>
```

| Param         | Type                                                                          |
| ------------- | ----------------------------------------------------------------------------- |
| **`options`** | <code><a href="#camerapreviewhideoptions">CameraPreviewHideOptions</a></code> |

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### startCameraRecording(...)

```typescript
startCameraRecording(options: StartCameraRecordingOptions) => Promise<boolean>
```

| Param         | Type                                                                                |
| ------------- | ----------------------------------------------------------------------------------- |
| **`options`** | <code><a href="#startcamerarecordingoptions">StartCameraRecordingOptions</a></code> |

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### stopCameraRecording()

```typescript
stopCameraRecording() => Promise<undefined | CameraRecordingResult>
```

**Returns:** <code>Promise&lt;<a href="#camerarecordingresult">CameraRecordingResult</a>&gt;</code>

--------------------


### grabCameraImage(...)

```typescript
grabCameraImage(options: GrabCameraImageOptions) => Promise<undefined | GrabCameraImageResult>
```

| Param         | Type                                                                      |
| ------------- | ------------------------------------------------------------------------- |
| **`options`** | <code><a href="#grabcameraimageoptions">GrabCameraImageOptions</a></code> |

**Returns:** <code>Promise&lt;<a href="#grabcameraimageresult">GrabCameraImageResult</a>&gt;</code>

--------------------


### startMicrophoneSession(...)

```typescript
startMicrophoneSession(options: MicrophoneSessionOptions) => Promise<boolean>
```

| Param         | Type                                                                          |
| ------------- | ----------------------------------------------------------------------------- |
| **`options`** | <code><a href="#microphonesessionoptions">MicrophoneSessionOptions</a></code> |

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### stopMicrophoneSession()

```typescript
stopMicrophoneSession() => Promise<boolean>
```

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### startMicrophoneRecording(...)

```typescript
startMicrophoneRecording(options: StartMicrophoneRecordingOptions) => Promise<boolean>
```

| Param         | Type                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------- |
| **`options`** | <code><a href="#startmicrophonerecordingoptions">StartMicrophoneRecordingOptions</a></code> |

**Returns:** <code>Promise&lt;boolean&gt;</code>

--------------------


### stopMicrophoneRecording()

```typescript
stopMicrophoneRecording() => Promise<undefined | MicrophoneRecordingResult>
```

**Returns:** <code>Promise&lt;<a href="#microphonerecordingresult">MicrophoneRecordingResult</a>&gt;</code>

--------------------


### Interfaces


#### PermissionStatus

| Prop             | Type                                                                                |
| ---------------- | ----------------------------------------------------------------------------------- |
| **`camera`**     | <code><a href="#mediacapturepermissionstate">MediaCapturePermissionState</a></code> |
| **`photos`**     | <code><a href="#mediacapturepermissionstate">MediaCapturePermissionState</a></code> |
| **`microphone`** | <code><a href="#mediacapturepermissionstate">MediaCapturePermissionState</a></code> |


#### MediaCapturePluginPermissions

| Prop              | Type                                      |
| ----------------- | ----------------------------------------- |
| **`permissions`** | <code>MediaCapturePermissionType[]</code> |


#### CameraSessionOptions

| Prop                  | Type                 |
| --------------------- | -------------------- |
| **`audio`**           | <code>boolean</code> |
| **`video`**           | <code>boolean</code> |
| **`photo`**           | <code>boolean</code> |
| **`preset`**          | <code>string</code>  |
| **`position`**        | <code>string</code>  |
| **`fullFramePhotos`** | <code>boolean</code> |


#### CameraPreviewShowOptions

| Prop                       | Type                                                                  |
| -------------------------- | --------------------------------------------------------------------- |
| **`frame`**                | <code>{ x: number; y: number; width: number; height: number; }</code> |
| **`gravity`**              | <code>string</code>                                                   |
| **`fadeDuration`**         | <code>number</code>                                                   |
| **`useDeviceOrientation`** | <code>boolean</code>                                                  |


#### CameraPreviewHideOptions

| Prop               | Type                |
| ------------------ | ------------------- |
| **`fadeDuration`** | <code>number</code> |


#### StartCameraRecordingOptions

| Prop                       | Type                 |
| -------------------------- | -------------------- |
| **`autoSave`**             | <code>boolean</code> |
| **`duration`**             | <code>number</code>  |
| **`useDeviceOrientation`** | <code>boolean</code> |


#### CameraRecordingResult

| Prop      | Type                |
| --------- | ------------------- |
| **`url`** | <code>string</code> |


#### GrabCameraImageResult

| Prop      | Type                |
| --------- | ------------------- |
| **`url`** | <code>string</code> |


#### GrabCameraImageOptions

| Prop                       | Type                 |
| -------------------------- | -------------------- |
| **`autoSave`**             | <code>boolean</code> |
| **`useDeviceOrientation`** | <code>boolean</code> |
| **`autoAdjust`**           | <code>boolean</code> |


#### MicrophoneSessionOptions

| Prop                | Type                 |
| ------------------- | -------------------- |
| **`sampleRate`**    | <code>number</code>  |
| **`reuseRecorder`** | <code>boolean</code> |
| **`numChannels`**   | <code>number</code>  |


#### StartMicrophoneRecordingOptions

| Prop           | Type                |
| -------------- | ------------------- |
| **`duration`** | <code>number</code> |


#### MicrophoneRecordingResult

| Prop      | Type                |
| --------- | ------------------- |
| **`url`** | <code>string</code> |


### Type Aliases


#### MediaCapturePermissionState

<code><a href="#permissionstate">PermissionState</a> | 'limited'</code>


#### PermissionState

<code>'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'</code>


#### MediaCapturePermissionType

<code>'camera' | 'photos' | 'microphone'</code>

</docgen-api>

---
_Source: https://npm.io/package/@studiokloek/capacitor-plugin-mediacapture · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._