Audio Recorder-interfaco.
Audio Recorder-interfaco.
← Ĉiuj gvidiloj pri Bubble Native

Xodera Plugins · Bubble Native

Xodera Audio Recorder Native

Permesu al homoj registri voĉnoton, aŭskulti antaŭ ol sendi kaj teni lokan skizon. Alŝutu nur kiam ili elektas sendi la registrado.

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.

Dokumentado reviziita 6 novembro 2026

Praktikaj ekzemploj

Aŭskulti antaŭ ol sendi ne-konfidencan voĉmesaĝon

Uzantoj bezonas ŝancon aŭdi kaj anstataŭigi registradon antaŭ ol ĝi iĝas aldonaĵo.

`title = the app’s conversation label`; agordu `max_duration_seconds` kaj `max_upload_bytes` al via mesaĝa politiko.

Start recording → Stop recording → atendu `recording_ready` → Play preview. Ofertu Seek preview kaj Set preview speed. Nur eksplicita Send alvokas Upload to Bubble sur la akceptita propra-aplika alŝuta finpunkto.

Nur ĉe `upload_succeeded`, kreu vian Message kaj agordu ĝian sonan kampon al `uploaded_file`. La mesaĝo ne estas kreita de la registrilo mem.

Ĉe mikrofonmalpermeso montru `permission_status`; ĉe alŝuta malsukceso retenu la lokan registradon. Kontrolu la rezulton de nekonata alŝuto antaŭ ol reprovi, por ke Send ne povu krei duoblajn aldonaĵojn/mesaĝojn.

Bubble alŝuto kreas publikan sonan dosieron. Ne uzu ĉi tiun alŝuton por konfidencaj registradoj.

Prononcado-praktiko sen tuja alŝuto

Lernantoj volas kompari sian propran parolitan respondon kun leciono antaŭ ol decidi sendi ĝin.

`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; ekzerca respondo restas registro posedata de la aplikaĵo.

Record → Stop → Play preview. Lasu la lernanton moviĝi al alia loko en la registraĵo, malrapidigi la antaŭaŭskulton aŭ nuligi kaj registri alian provon. Uzu Save locally nur kiam la lernanto elektas konservi la skizon.

`duration`, `local_uri`, `mime_type` kaj `draft_id` priskribas la provon. Via aplikaĵo decidas ĉu ĝi restas loka aŭ poste estas sendita per via elektita alŝuta laborfluo.

Ĉe `preview_error`, konservu la skizon kaj montru `error_code`. Ne transformu antaŭaŭskulton aŭ konservitan skizon en senditan Answer ĝis la submet-laborfluo de la aplikaĵo sukcesas.

Bubble alŝuto kreas publikan sonan dosieron. Ne uzu ĉi tiun alŝuton por konfidencaj registradoj.

Konservu lokan voĉan skizon kaj faru Send eksplicita

Kamplaboristo povas esti interrompita antaŭ ol fini noton kaj ne devus alŝuti ĝin nur por konservi ĝin.

`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. Konservu la ricevitan `draft_id` en via propra stato limigita al la koncerna aparato kaj konto. Uzu Restore local draft por tiu sama ID, poste Play preview antaŭ ol decidi, ĉu alŝuti.

Ĉe `local_saved` aŭ `local_restored`, inspektu `is_saved_locally`, `local_uri` kaj `duration`. Forigu la konservitan skizon nur post eksplicita elekto de la uzanto aŭ laŭ aparte konfirmita retenpolitiko.

Se restaŭro malsukcesas, montru `error_code` kaj retenu la ID por diagnozo; ne raportu malplenan aŭ malsaman registrado kiel restaŭrita. Neniam auto-ŝarĝu ĉe rekonekto.

Bubble alŝuto kreas publikan sonan dosieron. Ne uzu ĉi tiun alŝuton por konfidencaj registradoj.

Kio funkcias nun

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.

Kreu la laborfluon

Uzu la disponeblajn beta-agojn sube kaj testu la rezulton sur viaj cela aparatoj.

Ĉi tiuj ekzemploj uzas aplikaĵajn rekordojn kiel Lesson, Message kaj Order. Anstataŭigu ilin per viaj propraj datumtipoj kaj elementnomoj. Ekzemplaj aŭdvida adresoj devas esti anstataŭigitaj per viaj propraj dosieroj.

  1. Aldonu la registrilon. Agordu document_context = Current User's unique id kaj is_active laŭ ĉu la registra vido estas malfermita.

  2. Start recording petas mikrofonpermeson. Pause kaj Resume konservas la saman registraĵon. Stop recording finas ĝin; atendu recording_ready antaŭ ol proponi revizion aŭ alŝuton.

  3. Uzu la antaŭrigardajn regilojn por aŭskulti. Save locally konservas skizon en ĉi tiu aparato; post local_saved, retenu draft_id por Restore local draft.

  4. Klarigu ke sendado kreas publikan dosieron. Agordu bubble_upload_url al via propra Bubble‑aplikaĵo ĝusta Development aŭ Live dosieralŝutadreso. Rulu Upload to Bubble nur kiam la uzanto elektas Sendi; ĉe upload_succeeded, konservu uploaded_file en via registro.

Laborflua diagramo — ne aplikaĵa ekrankopio

Agordu unufoje

Kreu aŭ elektu vian Bubble-aplikaĵan projekton en BestPlugins → Dashboard → Plugins. Elektu Xodera Audio Recorder Native, kopiu ĝian ŝlosilon, poste malfermu Bubble → Plugins → Xodera Audio Recorder Native kaj algluu ĝin en licensing_api_key. Konservu unufoje; poste uzu la subajn agojn. Ĉiu kromaĵo en ĉiu projekto havas sian propran ŝlosilon.

Petu mikrofonpermeson kiam la uzanto komencas registri. Elektu kiel la aplikaĵo konservos skizojn. Bubble alŝuto konservas publikan dosieron, do uzu ĝin nur por audio taŭga por publika stokado.

Agordu unufoje
  1. Kreu aŭ elektu vian Bubble-aplikaĵan projekton ĉe BestPlugins → Dashboard → Plugins.
  2. Elektu ĉi tiun kromaĵon kaj kopiu ĝian projektan ŝlosilon.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Aldonu la elementon, elektu viajn aplikaĵajn datumojn kaj konstruu la suban laborfluon.
  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.
Instalado kaj abono

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.

Konservu la rezulton en via aplikaĵo

Post upload_succeeded, agordu VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration kaj mime_type = Recorder's mime_type. draft_id restarigas skizon en ĉi tiu aparato; ĝi ne estas interreta audio-dosiero.

Malsukceso, nuligo kaj restaŭro

Se aliro al mikrofono estas rifuzita, klarigu kiel ebligi ĝin en la aparat-agordoj. Cancel recording forĵetas la nesavitan prenon; konservitaj skizoj restas. Se alŝuto estas interrompita, retenu la lokan registradon kaj kontrolu ĉu la dosiero alvenis antaŭ ol resendi ĝin. Delete saved draft forigas nur la elektitan konservitan skizon.

Kapabloj kaj limoj

Defaŭlta maksimuma registrado: 300 sekundoj; agordebla 1–3600. Defaŭlta alŝuta limo: 10 MiB; maksimuma 30 MiB. Alŝuta tempolimo: 60 sekundoj, sen aŭtomata reprovo. Bubble alŝutoj estas publikaj. Nur viaj propraj *.bubbleapps.io dosieralŝutadresoj estas subtenataj; propraj domajnoj ne. Lokaj skizoj ne estas ĉifritaj.

Agordoj, agoj kaj rezultoj

Uzu ĉi tiujn nomojn en Bubble. Planitaj funkcioj estas markitaj aparte.

Disponeblaj beta-agordoj

Elementaj agordoj

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

Statoj

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

Eventoj

recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_error

Agoj kaj iliaj enigoj

Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speed
Elementaj agordoj · 10
titletext · Defaŭlto: ""
Ekzempla valoroLesson 4 — review
Ekzemplo Bubble esprimoSelected Lesson's name
Videbla teksto de la aplikaĵo; malplena valoro uzas la enkonstruitan tradukitan tekston, kie tio estas subtenata. Ne enmetu akreditaĵojn.
max_duration_secondsnumber · Defaŭlto: 300
Ekzempla valoro300
Ekzemplo Bubble esprimoVoice Settings' max_seconds
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
max_upload_bytesnumber · Defaŭlto: 10485760
Ekzempla valoro10485760
Ekzemplo Bubble esprimoVoice Settings' max_upload_bytes
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
is_activeyes_no · Defaŭlto: true
Ekzempla valoroyes
Ekzemplo Bubble esprimoGuideHost's view_is_active (your yes/no custom state)
Agordu jes dum ĉi tiu vido estas malfermita. Agordu ne kiam forlasas, por ke reproduktado aŭ nuna laboro povas ĉesi.
disabledyes_no · Defaŭlto: false
Ekzempla valorono
Ekzemplo Bubble esprimoGuideHost's is_busy (your yes/no custom state)
Malebligu la elementon dum via aplikaĵo estas okupata aŭ ĉi tiu ago ne disponeblas.
ui_text_jsontext · Defaŭlto: ""
Ekzempla valoro{}
Ekzemplo Bubble esprimoApp Settings' player_labels_json (supported keys only)
Nedeviga JSON kun subtenataj butonetiketoj. Lasu malplena por uzi la enkonstruitan tekston.
saved_draft_idtext · Defaŭlto: ""
Ekzempla valoro<returned draft_id>
Ekzemplo Bubble esprimoSelected VoiceDraft's draft_id
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
bubble_upload_urltext · Defaŭlto: ""
Ekzempla valorohttps://your-app.bubbleapps.io/version-test/fileupload
Ekzemplo Bubble esprimoApp Settings' selected_bubble_upload_url
Via propra Bubble-aplika dosier-ŝarĝa adreso: /version-test/fileupload por Development, /fileupload por Live. Ĉi tiu ŝarĝo kreas publikajn dosierojn.
languagetext · Defaŭlto: "auto"
Ekzempla valorouk
Ekzemplo Bubble esprimoCurrent User's preferred_language
Agordu language=auto por sekvi subtenatan lingvon de la aparato aŭ retumilo. Enigu subtenatan lingvokodon por elekti ĝin eksplicite.
document_contexttext · Defaŭlto: ""
Ekzempla valoro<current-user-id>
Ekzemplo Bubble esprimoCurrent User's unique id
Stabila valoro por ĉi tiu konto aŭ registro. Uzu la saman valoron kiam vi restarigas ĝiajn konservitajn dosierojn aŭ skizojn.
Agoj kaj iliaj enigoj · 15
Start recording

Neniuj ago-parametroj

Pause recording

Neniuj ago-parametroj

Resume recording

Neniuj ago-parametroj

Stop recording

Neniuj ago-parametroj

Cancel recording

Neniuj ago-parametroj

Save locally

Neniuj ago-parametroj

Restore local draft
draft_idtext · Defaŭlto: —
Ekzempla valoro<returned draft_id>
Ekzemplo Bubble esprimoSelected VoiceDraft's draft_id
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Delete saved draft
draft_idtext · Defaŭlto: —
Ekzempla valoro<returned draft_id>
Ekzemplo Bubble esprimoSelected VoiceDraft's draft_id
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Upload to Bubble

Neniuj ago-parametroj

Cancel upload

Neniuj ago-parametroj

Play preview

Neniuj ago-parametroj

Pause preview

Neniuj ago-parametroj

Stop preview

Neniuj ago-parametroj

Seek preview
secondsnumber · Defaŭlto: —
Ekzempla valoro12
Ekzemplo Bubble esprimoSelected Comment's seconds
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Set preview speed
ratenumber · Defaŭlto: —
Ekzempla valoro1.5
Ekzemplo Bubble esprimoPreview Speed Dropdown's value
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Statoj kaj eventoj

Statoj

recorder_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

permission_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

is_recording · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

is_paused · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

duration · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

local_uri · text

Dosierlokado en ĉi tiu aparato. Konservu aŭ alŝutu la dosieron aparte se ĝi devas esti tenata enrete.

draft_id · text

Identigilo por ĉi tiu elemento aŭ ago. Konservu ĝin kun la kongrua registro de la aplikaĵo. Uzu la saman petidentigilon kiam vi reprovas operacion kun necerta rezulto.

is_saved_locally · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

mime_type · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

file_size · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

waveform_peaks_json · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

preview_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

preview_is_playing · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

preview_current_time · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

upload_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

upload_progress · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

uploaded_url · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

uploaded_file · file

Dosiero redonita post upload_succeeded. Konservu ĝin en via kampo de tipo Bubble File.

error_code · text

Erarinformoj por la lasta ago. Montru utilan mesaĝon kaj proponu la rilatan reprovon.

Eventoj

recording_started

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

recording_paused

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

recording_resumed

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

recording_stopped

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

recording_ready

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

recording_cancelled

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

recorder_error

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

local_saved

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

local_restored

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

local_deleted

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

upload_succeeded

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

upload_failed

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

upload_cancelled

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

preview_ready

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

preview_error

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

Demandoj, kiujn programistoj demandas

Ĉu loka konservado alŝutas la registrado?

Ne. Save locally konservas posedatan skizon sur la aparato. Upload to Bubble estas aparta eksplicita publika operacio.

Kiel funkcias la abono?

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.

Rilataj gvidiloj

Por helpo, informu nin kiun kromaĵon kaj aparaton vi uzas, la agon kiun vi provis kaj kio okazis. Uzu ekzemplon sen personaj datumoj. Neniam dividu vian ŝlosilon aŭ privatajn dosierojn.