Xodera Plugins · Bubble Native
Xodera Audio Recorder Native
Leiskite žmonėms įrašyti balso pastabą, išklausyti prieš siunčiant ir išsaugoti vietinį juodraštį. Įkelkite tik tada, kai jie pasirinks siųsti įrašą.
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.
Dokumentacija peržiūrėta 6 lapkričio 2026
Praktiniai pavyzdžiai
Klausykite prieš išsiunčiant nekonfidencialų balso pranešimą
Vartotojams reikia galimybės išgirsti ir pakeisti įrašą prieš jis tampa priedu.
`title = the app’s conversation label`; nustatykite `max_duration_seconds` ir `max_upload_bytes` savo pranešimo politikoje.
Start recording → Stop recording → laukti `recording_ready` → Play preview. Pateikite Seek preview ir Set preview speed. Tik aiškus Siųsti iškviečia Upload to Bubble priimtam jūsų programos įkėlimo galutiniam taškui.
Tik `upload_succeeded` sukurkite savo Message ir nustatykite jo garso lauką į `uploaded_file`. Pranešimas nėra sukurtas paties įrašymo įrenginio.
Atmetus mikrofono leidimą, rodyti `permission_status`; įkėlimo nesėkmės atveju išlaikyti vietinį įrašą. Patikrinkite nežinomo įkėlimo rezultatą prieš bandant dar kartą, kad Siųsti negalėtų sukurti dublikatų priedų/pranešimų.
Bubble įkėlimas sukuria viešą garso failą. Nenaudokite šio įkėlimo konfidencialiems įrašams.
Tarimo pratybos be būtinybės iškart įkelti įrašą
Mokiniai nori palyginti savo kalbėtą atsakymą su pamoka prieš nusprendžiant jį pateikti.
`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; pratimo atsakymas lieka programos valdomas įrašas.
Įrašyti → Sustabdyti → Play preview. Leiskite mokiniui ieškoti, sulėtinti peržiūrą arba atšaukti ir įrašyti kitą bandymą. Save locally tik kai jie pasirenka išsaugoti juodraštį.
`duration`, `local_uri`, `mime_type` ir `draft_id` aprašo bandymą. Jūsų programa nusprendžia, ar jis lieka vietinis, ar vėliau pateikiamas per pasirinktą įkėlimo procesą.
`preview_error` metu išsaugokite juodraštį ir rodykite `error_code`. Neperkelkite peržiūros ar išsaugoto juodraščio į pateiktą Atsakymą, kol programos pateikimo procesas nebus sėkmingai baigtas.
Bubble įkėlimas sukuria viešą garso failą. Nenaudokite šio įkėlimo konfidencialiems įrašams.
Išsaugokite vietinį balso juodraštį ir padarykite Siųsti aiškiu
Lauko darbuotojas gali būti pertrauktas prieš baigiant užrašą ir neturėtų turėti įkelti jo tik tam, kad jį išsaugotų.
`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. Išsaugokite grąžintą `draft_id` savo įrenginyje/paskyros būsenoje. Naudokite Restore local draft tam pačiam ID, tada Play preview prieš nusprendžiant, ar įkelti.
`local_saved` arba `local_restored` metu patikrinkite `is_saved_locally`, `local_uri` ir `duration`. Ištrinkite išsaugotą juodraštį tik po aiškaus vartotojo pasirinkimo arba po atskirai patvirtintos išsaugojimo politikos.
Jei atkūrimas nepavyksta, parodykite `error_code` ir išsaugokite ID diagnostikai; nepraneškite, kad tuščias arba kitas įrašas buvo atkurtas. Atkūrus ryšį niekada neįkelkite įrašo automatiškai (auto-upload).
Bubble įkėlimas sukuria viešą garso failą. Nenaudokite šio įkėlimo konfidencialiems įrašams.
Kas veikia dabar
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.
Sukurkite darbo srautą
Naudokite žemiau pateiktas prieinamas beta veiksmus ir išbandykite rezultatą savo tiksliniuose įrenginiuose.
Šie pavyzdžiai naudoja programos įrašus, tokius kaip Lesson, Message ir Order. Pakeiskite juos savo duomenų tipais ir elementų pavadinimais. Pavyzdiniai medijos adresai turi būti pakeisti jūsų failais.
Pridėkite įrašiklį. Nustatykite document_context = Current User's unique id ir is_active, ar įrašymo peržiūra yra atvira.
Start recording prašo mikrofono leidimo. Pause ir Resume išlaiko tą patį įrašą. Stop recording baigia jį; palaukite recording_ready prieš siūlant peržiūrą arba įkėlimą.
Naudokite peržiūros valdiklius klausymui. Save locally išsaugo juodraštį šiame įrenginyje; po local_saved, išlaikykite draft_id, skirtą Restore local draft.
Paaiškinkite, kad siuntimas sukuria viešą failą. Nustatykite bubble_upload_url į savo Bubble programos teisingą Development arba Live failų įkėlimo adresą. Vykdykite Upload to Bubble tik tada, kai naudotojas pasirenka Siųsti; upload_succeeded metu, įrašykite uploaded_file į savo įrašą.
Konfigūruokite vieną kartą
Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins. Pasirinkite Xodera Audio Recorder Native, nukopijuokite jo raktą, tada atidarykite Bubble → Plugins → Xodera Audio Recorder Native ir įklijuokite jį į licensing_api_key. Išsaugokite vieną kartą; tada naudokite žemiau esančius veiksmus. Kiekvienas įskiepis kiekviename projekte turi savo raktą.
Klauskite mikrofono leidimo, kai naudotojas pradeda įrašymą. Pasirinkite, kaip programa išsaugos juodraščius. Bubble įkėlimas saugo viešą failą, todėl naudokite jį tik garso įrašams, tinkamiems viešam saugojimui.
Konfigūruokite vieną kartą
- Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins.
- Pasirinkite šį įskiepį ir nukopijuokite jo projekto raktą.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridėkite elementą, pasirinkite savo programos duomenis ir sukurkite žemiau esantį darbo srautą.
- 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.
Įdiegimas ir prenumerata
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.
Išsaugokite rezultatą savo programoje
Po upload_succeeded nustatykite VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration ir mime_type = Recorder's mime_type. draft_id atkuria juodraštį šiame įrenginyje; tai nėra internetinis garso failas.
Gedimas, atšaukimas ir atkūrimas
Jei mikrofono prieiga atmesta, paaiškinkite, kaip ją įjungti įrenginio nustatymuose. Cancel recording išmeta neišsaugotą įrašą; išsaugoti juodraščiai lieka. Jei įkėlimas nutraukiamas, išlaikykite vietinį įrašą ir patikrinkite, ar failas pasiekė prieš siunčiant dar kartą. Delete saved draft pašalina tik pasirinktą išsaugotą juodraštį.
Galimybės ir apribojimai
Numatytasis maksimalus įrašas: 300 sekundžių; konfigūruojama 1–3600. Numatytoji įkėlimo riba: 10 MiB; maksimalu 30 MiB. Įkėlimo laiko limitas: 60 sekundžių, be automatinio pakartojimo. Bubble įkėlimai yra vieši. Palaikomi tik jūsų *.bubbleapps.io failų įkėlimo adresai; tinkinti domenai nepalaikomi. Vietiniai juodraščiai nėra šifruota saugykla.
Nustatymai, veiksmai ir rezultatai
Naudokite šiuos pavadinimus Bubble. Planuojamos funkcijos pažymėtos atskirai.
Prieinami beta nustatymai
Elemento nustatymai
title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · textBūsenos
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Įvykiai
recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_errorVeiksmai ir jų įvestys
Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speedElemento nustatymai · 10
titletext · Numatytasis: ""- Pavyzdinė reikšmė
Lesson 4 — review - Pavyzdinis Bubble išraiška
Selected Lesson's name - Matomas programos tekstas; jei tuščias, naudojama įdiegta lokalizuota kopija, kur palaikoma. Nėra kredencialų.
max_duration_secondsnumber · Numatytasis: 300- Pavyzdinė reikšmė
300 - Pavyzdinis Bubble išraiška
Voice Settings' max_seconds - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
max_upload_bytesnumber · Numatytasis: 10485760- Pavyzdinė reikšmė
10485760 - Pavyzdinis Bubble išraiška
Voice Settings' max_upload_bytes - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
is_activeyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
GuideHost's view_is_active (your yes/no custom state) - Nustatykite taip, kai šis vaizdas atvertas. Nustatykite ne, kai išeinate, kad atkūrimas arba dabartinis darbas galėtų sustoti.
disabledyes_no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
GuideHost's is_busy (your yes/no custom state) - Išjunkite elementą, kai programa užimta arba šis veiksmas neprieinamas.
ui_text_jsontext · Numatytasis: ""- Pavyzdinė reikšmė
{} - Pavyzdinis Bubble išraiška
App Settings' player_labels_json (supported keys only) - Pasirenkamas JSON su palaikomais mygtukų etiketėmis. Palikite tuščią, kad naudotumėte įdiegtą tekstą.
saved_draft_idtext · Numatytasis: ""- Pavyzdinė reikšmė
<returned draft_id> - Pavyzdinis Bubble išraiška
Selected VoiceDraft's draft_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
bubble_upload_urltext · Numatytasis: ""- Pavyzdinė reikšmė
https://your-app.bubbleapps.io/version-test/fileupload - Pavyzdinis Bubble išraiška
App Settings' selected_bubble_upload_url - Jūsų Bubble programos failų įkėlimo adresas: /version-test/fileupload – Development, /fileupload – Live. Šis įkėlimas sukuria viešus failus.
languagetext · Numatytasis: "auto"- Pavyzdinė reikšmė
uk - Pavyzdinis Bubble išraiška
Current User's preferred_language - Nustatykite language=auto sekti palaikomą įrenginį arba naršyklės kalbą. Įveskite palaikomą kalbos kodą, kad pasirinktumėte ją tiesiogiai.
document_contexttext · Numatytasis: ""- Pavyzdinė reikšmė
<current-user-id> - Pavyzdinis Bubble išraiška
Current User's unique id - Stabili vertė šiai paskyrai arba įrašui. Naudokite tą pačią vertę atkurdami išsaugotus failus arba juodraščius.
Veiksmai ir jų įvestys · 15
Start recording
Nėra veiksmų parametrų
Pause recording
Nėra veiksmų parametrų
Resume recording
Nėra veiksmų parametrų
Stop recording
Nėra veiksmų parametrų
Cancel recording
Nėra veiksmų parametrų
Save locally
Nėra veiksmų parametrų
Restore local draft
draft_idtext · Numatytasis: —- Pavyzdinė reikšmė
<returned draft_id> - Pavyzdinis Bubble išraiška
Selected VoiceDraft's draft_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Delete saved draft
draft_idtext · Numatytasis: —- Pavyzdinė reikšmė
<returned draft_id> - Pavyzdinis Bubble išraiška
Selected VoiceDraft's draft_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Upload to Bubble
Nėra veiksmų parametrų
Cancel upload
Nėra veiksmų parametrų
Play preview
Nėra veiksmų parametrų
Pause preview
Nėra veiksmų parametrų
Stop preview
Nėra veiksmų parametrų
Seek preview
secondsnumber · Numatytasis: —- Pavyzdinė reikšmė
12 - Pavyzdinis Bubble išraiška
Selected Comment's seconds - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Set preview speed
ratenumber · Numatytasis: —- Pavyzdinė reikšmė
1.5 - Pavyzdinis Bubble išraiška
Preview Speed Dropdown's value - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Būsenos ir įvykiai
Būsenos
recorder_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
permission_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
is_recording · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
is_paused · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
duration · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
local_uri · textFailo vieta šiame įrenginyje. Išsaugokite arba įkelkite failą atskirai, jei jis turi būti laikomas internete.
draft_id · textIdentifikatorius šiam elementui arba veiksmui. Laikykite jį kartu su atitinkamu programos įrašu. Naudokite tą patį užklausos identifikatorių, kai kartojate neaiškų rezultatą.
is_saved_locally · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
mime_type · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
file_size · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
waveform_peaks_json · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
preview_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
preview_is_playing · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
preview_current_time · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
upload_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
upload_progress · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
uploaded_url · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
uploaded_file · fileFailas grąžintas po upload_succeeded. Išsaugokite jį savo Bubble failų lauke.
error_code · textPaskutinio veiksmo klaidos informacija. Rodykite naudingą pranešimą ir pasiūlykite atitinkamą pakartojimą.
Įvykiai
recording_startedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
recording_pausedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
recording_resumedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
recording_stoppedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
recording_readyKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
recording_cancelledKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
recorder_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
local_savedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
local_restoredKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
local_deletedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
upload_succeededKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
upload_failedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
upload_cancelledKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
preview_readyKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
preview_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
Klausimai, kuriuos užduoda kūrėjai
Ar vietinis išsaugojimas įkelia įrašą?
Ne. Save locally išsaugo įrenginio juodraštį. Upload to Bubble yra atskira aiški vieša operacija.
Kaip veikia prenumerata?
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.
Susijusios gairės
Pagalbos prašym, nurodykite, kurį papildinį ir įrenginį naudojate, kokį veiksmą bandėte ir kas įvyko. Naudokite pavyzdį be asmeninių duomenų. Niekada nesidalinkite savo raktu ar privačiais failais.