Audio Recorder Pro Mobile - Instructions
1. Recorder elementAdd the Audio Recorder Pro element to your Bubble Mobile page. This element is headless and invisible. It does not render buttons or UI. You control it with Bubble workflows and can design your own Record, Pause, Resume, Stop, and Reset buttons.
2. Recorder fieldsMax file size MBUse this to limit the maximum recording file size in MB. Leave empty or set to 0 for no file size limit.
Limit in secondsUse this to limit the recording duration. Leave empty or set to 0 for no duration limit.
Permission on loadWhen yes, the plugin requests microphone permission when the recorder element mounts.
Save to Bubble storageWhen yes, the plugin uploads the final audio file to Bubble storage. When no, the plugin publishes the local recorded file URI.
App nameYour Bubble app name or domain. Examples: myapp, myapp.bubbleapps.io, or
https://mycustomdomain.com.
App versionUse
test or live. Test uploads to /version-test/fileupload. Live uploads to /fileupload.
3. Recorder actionsRecordStarts a new recording. If the recording is paused, calling Record continues the paused recording.
PausePauses the current recording.
ResumeContinues the paused recording from where it stopped.
StopStops the recording, publishes the final duration and file size, updates recording states, and prepares or uploads the final file.
ResetClears the current recording and resets the recorder states.
Request microphone permissionRequests microphone permission. If permission remains denied, the plugin attempts to open the app/device settings so the user can allow microphone access manually.
4. Recorder statesFileThe final audio file URL when saved to Bubble storage, or the local file URI when storage upload is disabled.
DurationRecording duration in seconds.
Is recordingYes when the recorder is actively recording.
Is pausedYes when the current recording is paused.
Is stoppedYes when the recorder is stopped.
ErrorThe latest error message, if any.
Microphone permissionYes when microphone permission is granted.
File sizeThe final file size in MB.
Upload progressUpload progress number. Useful when saving to Bubble storage.
5. Recorder eventsIs recordingTriggered when recording starts or resumes.
Is pausedTriggered when recording pauses.
Is stoppedTriggered when recording stops.
File is availableTriggered when the final file URL or URI is available.
Microfone permission is grantedTriggered when microphone permission is granted.
6. Saving recordings to Bubble storageTo save files to Bubble storage, set Save to Bubble storage to yes and configure App name and App version. The plugin uploads the recording as Base64 to Bubble’s native fileupload endpoint and publishes the returned URL to the File state.
7. Wave Sound elementThe plugin also includes a Wave Sound visual element. Add it to the page when you want to display live microphone waveform bars. The element requests microphone permission and fills the width and height defined in Bubble.
8. Wave Sound fieldsBg colorBackground color of the Wave Sound element. Example: #0b1020.
Wave colorColor of the animated waveform bars. Example: #38bdf8.
Border styleCan be None, Solid, Dotted, or Dashed. If different from None, the border is shown with 1px width.
Border radiusBorder radius number. Empty uses 6.
Border colorBorder color. If empty, the plugin uses the Wave color.
9. Recommended workflow setup1. Add the Recorder element to the page.
2. Optional: set Permission on lod to yes.
3. Create a Record button and run the Record action.
4. Create a Pause button and run the Pause action.
5. Create a Resume button and run the Resume action.
6. Create a Stop button and run the Stop action.
7. Use File is available to save or display the final audio file.
8. Use Error for user-facing error handling.
9. Add the Wave Sound element if you want a live microphone visualizer.
10. Important notesThis plugin is designed for Bubble Mobile and native mobile behavior. It does not use HTML audio, DOM access, jQuery, document, or browser-only APIs inside the mobile component. For best results, test microphone permission, recording, pause/resume, stop, upload, and the Wave Sound element on a real iOS or Android device using BubbleGO or a built mobile app.
Built on Bubble
