Interfaċċa Audio Recorder.
Interfaċċa Audio Recorder.
← Il-gwidi nattivi kollha

Xodera Plugins · Bubble Native

Xodera Audio Recorder Native

Ħalli lin-nies jirrekordjaw nota tal-vuċi, jisimgħuha qabel jibagħtuha u jżommu abbozz lokali. Ittella’ r-reġistrazzjoni biss meta jagħżlu li jibagħtuha.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Dokumentazzjoni riveduta 6 Novembru 2026

Eżempji prattiċi

Isma' qabel tibgħat messaġġ tal-vuċi mhux kunfidenzjali

L-utenti jeħtieġu opportunità biex jisimgħu reġistrazzjoni u jibdluha qabel issir attachment.

`title = the app’s conversation label`; issettja `max_duration_seconds` u `max_upload_bytes` għall-politika tal-messaġġ tiegħek.

Start recording → Stop recording → stenna għal `recording_ready` → Play preview. Offri Seek preview u Set preview speed. Biss Send esplicitu jinvoka Upload to Bubble fuq l-endpoint tal-upload tal-app proprja aċċettata.

Biss meta jseħħ `upload_succeeded`, oħloq ir-rekord Message tiegħek u ssettja l-qasam tal-awdjo tiegħu għal `uploaded_file`. Ir-recorder innifsu ma joħloqx il-messaġġ.

Meta l-mikrofonu jiġi miċħud uri `permission_status`; meta l-upload jonqos żomm ir-rekord lokali. Iċċekkja r-riżultat ta' upload mhux magħruf qabel terġa' tipprova biex Send ma jistax joħloq attachments/messaġġi duplikati.

L-upload ta’ Bubble joħloq fajl tal-awdjo pubbliku. Tużax dan l-upload għal reġistrazzjonijiet kunfidenzjali.

Prattika tal-pronunzja mingħajr upload immedjat

Min qed jitgħallem irid iqabbel it-tweġiba tiegħu bil-vuċi ma’ lezzjoni qabel jiddeċiedi jekk jissottomettihiex.

`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; risposta ta' eżerċizzju tibqa' rekord tal-app.

Record → Stop → Play preview. Ħalli lil min qed jitgħallem imur għal punt ieħor fir-reġistrazzjoni, inaqqas il-veloċità tal-preview jew jikkanċella u jirrekordja tentattiv ieħor. Uża Save locally biss meta jagħżel li jżomm l-abbozz.

`duration`, `local_uri`, `mime_type` u `draft_id` jiddeskrivu t-tentattiva. L-app tiegħek tiddeċiedi jekk tibqa' lokali jew tiġi sottomessa aktar tard permezz tal-workflow tal-upload li għażilt.

Meta jseħħ `preview_error`, żomm l-abbozz u uri `error_code`. Tqisx preview jew abbozz issejvjat bħala Answer sottomess qabel ma jirnexxi l-fluss tax-xogħol tas-sottomissjoni tal-app.

L-upload ta’ Bubble joħloq fajl tal-awdjo pubbliku. Tużax dan l-upload għal reġistrazzjonijiet kunfidenzjali.

Żomm draft tal-vuċi lokali u għamel Send esplicitu

Ħaddiem fuq il-post jista’ jiġi interrott qabel itemm nota u m’għandux għalfejn itellagħha biss biex iżommha.

`saved_draft_id = the draft ID stored by your app for this device and account`; `title = the selected non-sensitive task label`.

Start/Stop recording → Save locally. Aħżen id-`draft_id` mogħti fi stat marbut ma’ dak l-apparat u dak il-kont. Uża Restore local draft għal dak l-istess ID, imbagħad Play preview qabel tiddeċiedi jekk ittellax ir-reġistrazzjoni.

Meta jseħħ `local_saved` jew `local_restored`, iċċekkja `is_saved_locally`, `local_uri` u `duration`. Ħassar l-abbozz issejvjat biss wara għażla espliċita tal-utent jew skont politika taż-żamma kkonfermata separatament.

Jekk ir‑restore jonqos, uri `error_code` u żomm l-ID għall-dijanjostik; tgħaddix rekord vuot jew differenti bħala rrestaurat. Qatt ma tagħmel auto‑upload fuq reconnect.

L-upload ta’ Bubble joħloq fajl tal-awdjo pubbliku. Tużax dan l-upload għal reġistrazzjonijiet kunfidenzjali.

X'jaħdem issa

Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.

Ibni l-fluss tax-xogħol

Uża l-azzjonijiet beta disponibbli hawn taħt u ittestja r-riżultat fuq l-apparati fil-mira tiegħek.

Dawn l-eżempji jużaw reġistri tal-app bħal Lesson, Message u Order. Ibdelhom bi tipi ta' data u ismijiet ta' elementi tiegħek. Indirizzi tal-midja tal-eżempju għandhom jiġu mibdula b'fajls tiegħek.

  1. Żid l-element li jirrekordja. Issettja document_context = Current User's unique id u is_active skont jekk il-veduta tar-reġistrazzjoni hijiex miftuħa.

  2. Start recording jitlob permess għall-mikrofonu. Pause u Resume iżommu l-istess teħid. Stop recording itemmu; stenna recording_ready qabel toffri s-smigħ jew l-upload.

  3. Uża l-kontrolli tal-preview biex tisma'. Save locally iżomm skizz fuq din is-device; wara local_saved, żomm draft_id għal Restore local draft.

  4. Spjega li meta tintbagħat ir-reġistrazzjoni jinħoloq fajl pubbliku. Issettja bubble_upload_url għall-indirizz korrett tal-upload tal-fajls tal-app Bubble tiegħek, f’Development jew Live. Ħaddem Upload to Bubble biss meta l-utent jagħżel Send; meta jseħħ upload_succeeded, issejvja uploaded_file fir-rekord tiegħek.

Dijagramma tal-fluss tax-xogħol — mhux screenshot tal-app

Ikkonfigura darba waħda

Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f’BestPlugins → Dashboard → Plugins. Agħżel Xodera Audio Recorder Native, ikkopja l-key tiegħu, imbagħad iftaħ Bubble → Plugins → Xodera Audio Recorder Native u poġġiha f’licensing_api_key. Issejvja darba; imbagħad uża l-azzjonijiet hawn taħt. Kull plugin f’kull proġett għandu l-key tiegħu.

Staqsi permess għall-mikrofon meta l-utent jibda jirrekordja. Agħżel kif l-app se tħażen l-iskizzi. Bubble upload jaħżen fajl pubbliku, għalhekk uża dan biss għal awdjo xieraq għall-ħażna pubblika.

Ikkonfigura darba waħda
  1. Oħloq jew agħżel il-proġett tal-app Bubble tiegħek f'BestPlugins → Dashboard → Plugins.
  2. Agħżel din il-plugin u ikkopja l-key tal-proġett tagħha.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Żid l-element, agħżel id-data tal-app tiegħek u ibni l-fluss tax-xogħol hawn taħt.
  5. In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
Installazzjoni u abbonament

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Issejvja r-riżultat fl-app tiegħek

Wara upload_succeeded, issettja VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration u mime_type = Recorder's mime_type. draft_id jirrestawra skizz fuq din is-device; mhuwiex fajl awdjo online.

Falliment, ikkanċellament u rkupru

Jekk l-aċċess għall-mikrofonu jiġi miċħud, spjega kif tippermettih fis-settings tal-apparat. Cancel recording jarmi t-teħid li għadu ma ġiex issejvjat; l-abbozzi ssejvjati jibqgħu. Jekk upload jiġi interrott, żomm ir-reġistrazzjoni lokali u ċċekkja jekk il-fajl wasalx qabel tibagħtu mill-ġdid. Delete saved draft ineħħi biss l-abbozz issejvjat magħżul.

Kapabbiltajiet u limiti

Rekordjar massimu default: 300 sekondi; konfigurabbli 1–3600. Limitu default ta’ upload: 10 MiB; massimu 30 MiB. Timeout ta’ upload: 60 sekondi, mingħajr retry awtomatiku. Bubble uploads huma pubbliċi. Biss l-indirizzi tiegħek *.bubbleapps.io għall-upload tal-fajls huma sostnut; dominji personalizzati mhux. L-iskizzi lokali mhumiex ħażna encryptata.

Konfigurazzjonijiet, azzjonijiet u riżultati

Uża dawn l-ismijiet f'Bubble. Il-karatteristiċi pjanati huma mmarkati separatament.

Settings beta disponibbli

Konfigurazzjonijiet tal-element

title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · text

Stati

recorder_status · textpermission_status · textis_recording · yes_nois_paused · yes_noduration · numberlocal_uri · textdraft_id · textis_saved_locally · yes_nomime_type · textfile_size · numberwaveform_peaks_json · textpreview_status · textpreview_is_playing · yes_nopreview_current_time · numberupload_status · textupload_progress · numberuploaded_url · textuploaded_file · fileerror_code · text

Avvenimenti

recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_error

Azzjonijiet u l-inputs tagħhom

Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speed
Konfigurazzjonijiet tal-element · 10
titletext · Valur predefinit: ""
Valur eżempjuLesson 4 — review
Eżempju ta’ espressjoni BubbleSelected Lesson's name
Test tal‑applikazzjoni li jidher; vojta juża kopja lokalizzata integrata fejn hija appoġġjata. Ebda kredenzjali.
max_duration_secondsnumber · Valur predefinit: 300
Valur eżempju300
Eżempju ta’ espressjoni BubbleVoice Settings' max_seconds
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
max_upload_bytesnumber · Valur predefinit: 10485760
Valur eżempju10485760
Eżempju ta’ espressjoni BubbleVoice Settings' max_upload_bytes
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
is_activeyes_no · Valur predefinit: true
Valur eżempjuyes
Eżempju ta’ espressjoni BubbleGuideHost's view_is_active (your yes/no custom state)
Issettja yes waqt li din il-veduta tkun miftuħa. Issettja no meta toħroġ minnha, sabiex id-daqq jew ix-xogħol attwali jkun jista’ jieqaf.
disabledyes_no · Valur predefinit: false
Valur eżempjuno
Eżempju ta’ espressjoni BubbleGuideHost's is_busy (your yes/no custom state)
Itfi l‑element waqt li l‑applikazzjoni tiegħek tkun impenjata jew din l‑azzjoni mhux disponibbli.
ui_text_jsontext · Valur predefinit: ""
Valur eżempju{}
Eżempju ta’ espressjoni BubbleApp Settings' player_labels_json (supported keys only)
JSON opzjonal bil‑tikketti tal‑buttuni appoġġjati. Ħalli vojta biex tuża t-test integrat.
saved_draft_idtext · Valur predefinit: ""
Valur eżempju<returned draft_id>
Eżempju ta’ espressjoni BubbleSelected VoiceDraft's draft_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
bubble_upload_urltext · Valur predefinit: ""
Valur eżempjuhttps://your-app.bubbleapps.io/version-test/fileupload
Eżempju ta’ espressjoni BubbleApp Settings' selected_bubble_upload_url
L‑indirizz tal‑file‑upload tal‑app Bubble tiegħek: /version-test/fileupload għal Development, /fileupload għal Live. Dan l‑upload joħloq fajls pubbliċi.
languagetext · Valur predefinit: "auto"
Valur eżempjuuk
Eżempju ta’ espressjoni BubbleCurrent User's preferred_language
Issettja language=auto biex tuża l-lingwa tal-apparat jew tal-browser jekk dik il-lingwa tkun appoġġjata. Daħħal kodiċi ta’ lingwa appoġġjata biex tagħżilha espliċitament.
document_contexttext · Valur predefinit: ""
Valur eżempju<current-user-id>
Eżempju ta’ espressjoni BubbleCurrent User's unique id
Valur stabbli għal dan il-kont jew rekord. Uża l-istess valur meta tirrestawra l-fajls jew l-abbozzi ssejvjati tiegħu.
Azzjonijiet u l-inputs tagħhom · 15
Start recording

Ebda parametri ta' azzjoni

Pause recording

Ebda parametri ta' azzjoni

Resume recording

Ebda parametri ta' azzjoni

Stop recording

Ebda parametri ta' azzjoni

Cancel recording

Ebda parametri ta' azzjoni

Save locally

Ebda parametri ta' azzjoni

Restore local draft
draft_idtext · Valur predefinit: —
Valur eżempju<returned draft_id>
Eżempju ta’ espressjoni BubbleSelected VoiceDraft's draft_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Delete saved draft
draft_idtext · Valur predefinit: —
Valur eżempju<returned draft_id>
Eżempju ta’ espressjoni BubbleSelected VoiceDraft's draft_id
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Upload to Bubble

Ebda parametri ta' azzjoni

Cancel upload

Ebda parametri ta' azzjoni

Play preview

Ebda parametri ta' azzjoni

Pause preview

Ebda parametri ta' azzjoni

Stop preview

Ebda parametri ta' azzjoni

Seek preview
secondsnumber · Valur predefinit: —
Valur eżempju12
Eżempju ta’ espressjoni BubbleSelected Comment's seconds
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Set preview speed
ratenumber · Valur predefinit: —
Valur eżempju1.5
Eżempju ta’ espressjoni BubblePreview Speed Dropdown's value
Uża l-valur tar‑rekord tan-negozju kurrenti; ivvalidaha kontra l-limiti hawn taħt.
Stati u avvenimenti

Stati

recorder_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

permission_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

is_recording · yes_no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

is_paused · yes_no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

duration · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

local_uri · text

Il-post tal-fajl fuq dan l-apparat. Issejvja jew ittella’ l-fajl separatament jekk irid jinżamm online.

draft_id · text

Identifikatur għal dan l‑oġġett jew azzjoni. Żommuh mal‑rekord tal‑app li jaqbel. Uża l-istess identifikatur tal‑talba meta terġa' tipprova riżultat mhux ċert.

is_saved_locally · yes_no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

mime_type · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

file_size · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

waveform_peaks_json · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

preview_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

preview_is_playing · yes_no

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

preview_current_time · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

upload_status · text

Riżultat kurrenti ta’ din l‑azzjoni. Uża l‑avveniment ta’ tlestija korrispondenti qabel tissejvja suċċess.

upload_progress · number

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

uploaded_url · text

Valur kurrenti għall‑oġġett magħżul. Aqra dan wara l‑avveniment relatat.

uploaded_file · file

Il-fajl mogħti wara upload_succeeded. Issejvjah fil-qasam Bubble File tiegħek.

error_code · text

Informazzjoni dwar l‑żball għall‑azzjoni l‑aktar riċenti. Uri messaġġ ta’ għajnuna u offri r‑retries rilevanti.

Avvenimenti

recording_started

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

recording_paused

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

recording_resumed

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

recording_stopped

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

recording_ready

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

recording_cancelled

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

recorder_error

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

local_saved

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

local_restored

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

local_deleted

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

upload_succeeded

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

upload_failed

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

upload_cancelled

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

preview_ready

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

preview_error

Meta dan l-avveniment jiġri, aqra l-istati relatati mill-istess element.

Mistoqsijiet li jistaqsu l-iżviluppaturi

Il-ħażna lokali tuploadja r-rekordjar?

Le. Save locally iżomm abbozz tiegħek fuq dan l-apparat. Upload to Bubble hija operazzjoni pubblika separata li trid tintgħażel espliċitament.

Kif taħdem is-sottoskrizzjoni?

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Gwidi relatati

Għal għajnuna, għidilna liema plugin u apparat qed tuża, l-azzjoni li ppruvajt u x'ġara. Uża eżempju mingħajr data personali. Qatt ma taqsam il-key tiegħek jew fajls privati.