Xodera Plugins · Bubble Native
Xodera Audio Recorder Native
Lejoni përdoruesit të regjistrojnë një shënim zanor, ta dëgjojnë përpara dërgimit dhe të mbajnë një draft lokal. Ngarkojeni vetëm kur ata zgjedhin ta dërgojnë regjistrimin.
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.
Dokumentacioni i rishikuar 6 November 2026
Shembuj praktikë
Dëgjoni përpara se të dërgoni një mesazh zanor jo-konfidencial
Përdoruesit kanë nevojë për një mundësi të dëgjojnë dhe zëvendësojnë një regjistrim përpara se të bëhet bashkëngjitje.
`title = the app’s conversation label`; caktoni `max_duration_seconds` dhe `max_upload_bytes` në politikën tuaj të mesazheve.
Start recording → Stop recording → prisni për `recording_ready` → Play preview. Ofroni Seek preview dhe Set preview speed. Upload to Bubble aktivizohet vetëm kur përdoruesi zgjedh Send shprehimisht, në adresën e pranuar të ngarkimit të vetë aplikacionit tuaj.
Vetëm në `upload_succeeded`, krijoni Message tuaj dhe caktoni fushën e tij audio në `uploaded_file`. Mesazhi nuk krijohet nga regjistruesi vetë.
Kur refuzohet mikrofon, shfaq `permission_status`; në rast të dështimit të ngarkimit mbajeni regjistrimin lokal. Kontrolloni rezultatin e një ngarkimi të panjohur përpara riprovimit që Dërgimi të mos krijojë bashkëngjitje/mesazhe të dyfishta.
Ngarkimi Bubble krijon një skedar audio publik. Mos përdorni këtë ngarkim për regjistrime konfidenciale.
Ushtrim i shqiptimit pa një ngarkim të menjëhershëm
Nxënësit dëshirojnë të krahasojnë përgjigjen e tyre të folur me një mësim përpara se të vendosin t’a dërgojnë.
`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; një përgjigje e ushtrimit mbetet një regjistër i pronësuar nga aplikacioni.
Regjistro → Ndalo → Play preview. Lejoni nxënësin të ndryshojë pozicionin e riprodhimit, të ngadalësojë riprodhimin paraprak ose të anulojë dhe të regjistrojë një përpjekje tjetër. Save locally përdoret vetëm kur ai zgjedh ta mbajë draftin.
`duration`, `local_uri`, `mime_type` dhe `draft_id` përshkruajnë përpjekjen. Aplikacioni juaj vendos nëse mbetet lokale ose më vonë dërgohet përmes rrjedhës së ngarkimit që keni zgjedhur.
Në `preview_error`, ruani skicën dhe shfaqni `error_code`. Mos e shndërroni parapamjen ose skicën e ruajtur në një Përgjigje të dërguar deri sa rrjedha e dërgimit të aplikacionit të ketë sukses.
Ngarkimi Bubble krijon një skedar audio publik. Mos përdorni këtë ngarkim për regjistrime konfidenciale.
Mbani një skicë zanore lokale dhe bëni dërgimin të qartë
Një punonjës në terren mund të ndërpritet para se të përfundojë një shënim dhe nuk duhet të jetë i detyruar ta ngarkojë vetëm për ta mbajtur.
`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. Ruani `draft_id` e kthyer në një gjendje të administruar nga aplikacioni, të kufizuar për këtë pajisje dhe këtë llogari. Përdorni Restore local draft për të njëjtin ID, pastaj Play preview përpara se të vendosni nëse do ta ngarkoni.
Në `local_saved` ose `local_restored`, kontrolloni `is_saved_locally`, `local_uri` dhe `duration`. Fshini skicën e ruajtur vetëm pas zgjedhjes së qartë të përdoruesit ose pas një politike të ruajtjes së konfirmuar veçmas.
Nëse rikthimi dështon, shfaq `error_code` dhe mbaj ID-në për diagnozë; mos raportoni një regjistrim bosh ose të ndryshëm si i rikthyer. Kurrë mos bëni ngarkim auto gjatë rilidhjes.
Ngarkimi Bubble krijon një skedar audio publik. Mos përdorni këtë ngarkim për regjistrime konfidenciale.
Çfarë funksionon tani
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.
Krijoni rrjedhën e punës
Përdorni veprimet beta të disponueshme më poshtë dhe testoni rezultatin në pajisjet tuaja të synuara.
Këto shembuj përdorin regjistrime aplikacioni si Lesson, Message dhe Order. Zëvendësoni ato me llojet tuaja të të dhënave dhe emrat e elementeve. Adresat e mediave shembull duhet të zëvendësohen me skedarët tuaj.
Shtoni regjistruesin. Caktoni document_context = Current User's unique id. Caktoni is_active sipas faktit nëse pamja e regjistrimit është e hapur apo jo.
Start recording kërkon leje për mikrofon. Pause dhe Resume mbajnë të njëjtin regjistrim. Stop recording e përfundon; prisni recording_ready përpara se të ofroni shqyrtim ose ngarkim.
Përdorni kontrollet e parapamjes për të dëgjuar. Save locally mban një skicë në këtë pajisje; pas local_saved, mbani draft_id për Restore local draft.
Shpjegoni se dërgimi krijon një skedar publik. Caktoni bubble_upload_url në adresën e duhur të ngarkimit të skedarëve të aplikacionit tuaj Bubble, Development ose Live. Ekzekutoni Upload to Bubble vetëm kur përdoruesi zgjedh Dërgo; në upload_succeeded, ruani uploaded_file në regjistrin tuaj.
Konfigurojeni një herë
Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins. Zgjidhni Xodera Audio Recorder Native, kopjoni çelësin e tij, pastaj hapni Bubble → Plugins → Xodera Audio Recorder Native dhe ngjitni në licensing_api_key. Ruani një herë; më pas përdorni veprimet më poshtë. Çdo shtojcë në çdo projekt ka çelësin e vet.
Kërkoni leje për mikrofon kur përdoruesi fillon regjistrimin. Zgjidhni si aplikacioni do të ruajë skicat. Bubble upload ruan një skedar publik, ndaj përdoreni vetëm për audio të përshtatshëm për ruajtje publike.
Konfigurojeni një herë
- Krijoni ose zgjidhni projektin tuaj të aplikacionit Bubble në BestPlugins → Dashboard → Plugins.
- Zgjidhni këtë shtojcë dhe kopjoni çelësin e projektit.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Shtoni elementin, zgjidhni të dhënat e aplikacionit tuaj dhe ndërtoni rrjedhën e punës më poshtë.
- 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.
Instalim dhe abonim
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.
Ruani rezultatin në aplikacionin tuaj
Pasi të kryhet upload_succeeded, caktoni VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration dhe mime_type = Recorder's mime_type. draft_id rikthen një skicë në këtë pajisje; nuk është një skedar audio në internet.
Dështim, anulim dhe rikuperim
Nëse qasja në mikrofon refuzohet, shpjegoni si ta aktivizoni në cilësimet e pajisjes. Cancel recording heq regjistrimin e paruajtur; draftet e ruajtura mbeten. Nëse një ngarkim ndërpritet, mbani regjistrimin lokal dhe kontrolloni nëse skedari ka mbërritur përpara se ta dërgoni përsëri. Delete saved draft heq vetëm draftin e ruajtur të zgjedhur.
Aftësitë dhe kufizimet
Regjistrimi maksimal i paracaktuar: 300 sekonda; i konfigurueshëm 1–3600. Kufiri i paracaktuar i ngarkimit: 10 MiB; maksimumi 30 MiB. Koha e skadimit të ngarkimit: 60 sekonda, pa riprovë automatike. Ngarkimet Bubble janë publike. Vetëm adresat tuaja të ngarkimit të skedarëve *.bubbleapps.io mbështeten; domenet e personalizuara nuk mbështeten. Skicat lokale nuk janë ruajtje e enkriptuar.
Rregullimet, veprimet dhe rezultatet
Përdorni këto emra në Bubble. Veçoritë e planifikuara janë shënuar veçmas.
Cilësimet beta të disponueshme
Rregullimet e elementit
title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · textGjendjet
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 · textNgjarjet
recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_errorVeprimet dhe inputet e tyre
Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speedRregullimet e elementit · 10
titletext · Parazgjedhur: ""- Vlera shembull
Lesson 4 — review - Shembull i shprehjes Bubble
Selected Lesson's name - Teksti i dukshëm i aplikacionit; bosh përdor kopjen e brendshme të lokalizuar ku mbështetet. Pa kredenciale.
max_duration_secondsnumber · Parazgjedhur: 300- Vlera shembull
300 - Shembull i shprehjes Bubble
Voice Settings' max_seconds - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
max_upload_bytesnumber · Parazgjedhur: 10485760- Vlera shembull
10485760 - Shembull i shprehjes Bubble
Voice Settings' max_upload_bytes - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
is_activeyes_no · Parazgjedhur: true- Vlera shembull
yes - Shembull i shprehjes Bubble
GuideHost's view_is_active (your yes/no custom state) - Vendosni yes ndërsa kjo pamje është e hapur. Vendosni no kur dilni, në mënyrë që riprodhimi ose puna aktuale të mund të ndalojë.
disabledyes_no · Parazgjedhur: false- Vlera shembull
no - Shembull i shprehjes Bubble
GuideHost's is_busy (your yes/no custom state) - Çaktivizo elementin ndërsa aplikacioni juaj është i zënë ose kjo veprim është i padisponueshëm.
ui_text_jsontext · Parazgjedhur: ""- Vlera shembull
{} - Shembull i shprehjes Bubble
App Settings' player_labels_json (supported keys only) - JSON opsionale me etiketa butonash të mbështetura. Lëreni bosh për të përdorur tekstin e brendshëm.
saved_draft_idtext · Parazgjedhur: ""- Vlera shembull
<returned draft_id> - Shembull i shprehjes Bubble
Selected VoiceDraft's draft_id - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
bubble_upload_urltext · Parazgjedhur: ""- Vlera shembull
https://your-app.bubbleapps.io/version-test/fileupload - Shembull i shprehjes Bubble
App Settings' selected_bubble_upload_url - Adresa juaj e ngarkimit të skedarëve të aplikacionit Bubble: /version-test/fileupload për Development, /fileupload për Live. Ky ngarkim krijon skedarë publikë.
languagetext · Parazgjedhur: "auto"- Vlera shembull
uk - Shembull i shprehjes Bubble
Current User's preferred_language - Vendosni language=auto për të ndjekur gjuhën e pajisjes ose të shfletuesit, nëse ajo mbështetet. Futni një kod gjuhe të mbështetur për ta zgjedhur gjuhën shprehimisht.
document_contexttext · Parazgjedhur: ""- Vlera shembull
<current-user-id> - Shembull i shprehjes Bubble
Current User's unique id - Vlerë e qëndrueshme për këtë llogari ose rekord. Përdorni të njëjtën vlerë kur riktheni skedarët ose skicat e ruajtur.
Veprimet dhe inputet e tyre · 15
Start recording
Pa parametra veprimi
Pause recording
Pa parametra veprimi
Resume recording
Pa parametra veprimi
Stop recording
Pa parametra veprimi
Cancel recording
Pa parametra veprimi
Save locally
Pa parametra veprimi
Restore local draft
draft_idtext · Parazgjedhur: —- Vlera shembull
<returned draft_id> - Shembull i shprehjes Bubble
Selected VoiceDraft's draft_id - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Delete saved draft
draft_idtext · Parazgjedhur: —- Vlera shembull
<returned draft_id> - Shembull i shprehjes Bubble
Selected VoiceDraft's draft_id - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Upload to Bubble
Pa parametra veprimi
Cancel upload
Pa parametra veprimi
Play preview
Pa parametra veprimi
Pause preview
Pa parametra veprimi
Stop preview
Pa parametra veprimi
Seek preview
secondsnumber · Parazgjedhur: —- Vlera shembull
12 - Shembull i shprehjes Bubble
Selected Comment's seconds - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Set preview speed
ratenumber · Parazgjedhur: —- Vlera shembull
1.5 - Shembull i shprehjes Bubble
Preview Speed Dropdown's value - Përdorni vlerën e regjistrimit aktual të biznesit; verifikojeni kundrejt kufijve më poshtë.
Gjendjet dhe ngjarjet
Gjendjet
recorder_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
permission_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
is_recording · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
is_paused · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
duration · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
local_uri · textVendndodhja e skedarit në këtë pajisje. Ruani ose ngarkoni skedarin veçmas nëse duhet të mbahet online.
draft_id · textIdentifikues për këtë artikull ose veprim. Mbajeni me regjistrin përkatës të aplikacionit. Përdorni të njëjtin identifikues kërkese kur riprovoni një rezultat të pasigurt.
is_saved_locally · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
mime_type · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
file_size · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
waveform_peaks_json · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
preview_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
preview_is_playing · yes_noVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
preview_current_time · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
upload_status · textRezultati aktual i kësaj veprimi. Përdorni ngjarjen përfundimtare përkatëse përpara se të ruani suksesin.
upload_progress · numberVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
uploaded_url · textVlera aktuale për elementin e zgjedhur. Lexojeni pas ngjarjes përkatëse.
uploaded_file · fileSkedari u kthye pas upload_succeeded. Ruajeni në fushën tuaj Bubble File.
error_code · textInformacioni i gabimit për veprimin e fundit. Shfaqni një mesazh i dobishëm dhe ofroni riprovimin përkatës.
Ngjarjet
recording_startedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
recording_pausedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
recording_resumedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
recording_stoppedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
recording_readyKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
recording_cancelledKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
recorder_errorKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
local_savedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
local_restoredKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
local_deletedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
upload_succeededKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
upload_failedKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
upload_cancelledKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
preview_readyKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
preview_errorKur ndodh kjo ngjarje, lexoni gjendjet përkatëse nga i njëjti element.
Pyetjet që bëjnë zhvilluesit
A e ngarkon ruajtja lokale regjistrimin?
Jo. Save locally mban një draft të administruar nga aplikacioni në këtë pajisje. Upload to Bubble është një veprim publik i veçantë që duhet zgjedhur shprehimisht.
Si funksionon abonimi?
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.
Udhëzues të lidhur
Për ndihmë, na tregoni cilin shtojcë dhe pajisje përdorni, veprimin që provuat dhe çfarë ndodhi. Përdorni një shembull pa të dhëna personale. Kurrë mos ndani çelësin tuaj ose skedarët privatë.