@mozartec/capacitor-microphone
v6.0.0
Published
This Microphone API provides the ability to interact with the microphone and record Audio
Downloads
7,994
Maintainers
Readme
This Microphone API provides the ability to interact with the microphone and record Audio
Platform support
| | iOS | Android | Web | | ------------ |--------------------- | ------------------ | ------------------ | | Availability | :heavy_check_mark: | :heavy_check_mark: | :x: | | Encoding | kAudioFormatMPEG4AAC | MPEG_4 / AAC | :x: | | Extension | .m4a | .m4a | :x: |
Installation
Install
npm install @mozartec/capacitor-microphone
npx cap sync
Demo
iOS
iOS requires the following usage description to be added and filled out for your app in Info.plist
:
NSMicrophoneUsageDescription
(Privacy - Microphone Usage Description
)
Read about Configuring Info.plist
in the iOS Guide for more information on setting iOS permissions in Xcode.
Android
This API requires the following permission to be added to your AndroidManifest.xml
:
<uses-permission android:name="android.permission.RECORD_AUDIO" />
The RECORD_AUDIO permission is for recording audio.
Read about Setting Permissions in the Android Guide for more information on setting Android permissions.
API
checkPermissions()
checkPermissions() => Promise<PermissionStatus>
Checks microphone permission
Returns: Promise<PermissionStatus>
Since: 0.0.3
requestPermissions()
requestPermissions() => Promise<PermissionStatus>
Requests microphone permission
Returns: Promise<PermissionStatus>
Since: 0.0.3
startRecording()
startRecording() => Promise<void>
Starts recoding session if no session is in progress
Since: 0.0.3
stopRecording()
stopRecording() => Promise<AudioRecording>
Stops recoding session if one is in progress
Returns: Promise<AudioRecording>
Since: 0.0.3
Interfaces
PermissionStatus
| Prop | Type |
| ---------------- | ------------------------------------------------------------------------------- |
| microphone
| MicrophonePermissionState |
AudioRecording
| Prop | Type | Description | Since |
| ------------------ | ------------------- | --------------------------------------------------------------------------------------------------------------- | ----- |
| base64String
| string | The base64 encoded string representation of the audio file. | 0.0.3 |
| dataUrl
| string | The url starting with 'data:audio/aac;base64,' and the base64 encoded string representation of the audio file. | 0.0.3 |
| path
| string | platform-specific file URL that can be read later using the Filesystem API. | 0.0.3 |
| webPath
| string | webPath returns a path that can be used to set the src attribute of an audio element can be useful for testing. | 0.0.3 |
| duration
| number | recoding duration in milliseconds | 0.0.3 |
| format
| string | file extension (only .m4a supported on this version) | 0.0.3 |
| mimeType
| string | file encoding "audio/aac" (kAudioFormatMPEG4AAC for iOS) (MPEG_4 / AAC for Android) | 0.0.3 |
Type Aliases
MicrophonePermissionState
PermissionState | 'limited'
PermissionState
'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'