
Xodera Plugins · Bubble Native
Xodera Audio Recorder Native
Engedje, hogy a felhasználók hangjegyzetet rögzítsenek, küldés előtt meghallgassák, és helyi vázlatot tartsanak. Feltöltés csak akkor, amikor a felhasználó elküldésre dönt.
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.
Dokumentáció felülvizsgált 6 november 2026
Gyakorlati példák
Hallgassa meg, mielőtt nem bizalmas hangüzenetet küld
A felhasználóknak lehetőséget kell kapniuk a felvétel meghallgatására és cseréjére, mielőtt csatolmány lesz.
`title = the app’s conversation label`; állítsa be a `max_duration_seconds` és a `max_upload_bytes` értékét az üzenetpolitikájában.
Start recording → Stop recording → várja a `recording_ready` → Play preview. Kínálja a Seek preview és a Set preview speed lehetőséget. Csak egy kifejezett Küldés hívja meg a Upload to Bubble-et a jóváhagyott saját alkalmazás feltöltési végponton.
Csak a `upload_succeeded` esetén hozza létre a Message-t, és állítsa be annak audio mezőjét a `uploaded_file`-re. Az üzenetet nem a felvevő hozza létre.
Mikrofon megtagadásakor jelenjen meg a `permission_status`; feltöltési hiba esetén tartsa meg a helyi felvételt. Ellenőrizze egy ismeretlen feltöltés eredményét a újrapróbálás előtt, hogy a Küldés ne hozhasson létre duplikált csatolmányokat/üzeneteket.
A Bubble feltöltés nyilvános audiofájlt hoz létre. Ne használja ezt a feltöltést bizalmas felvételekhez.
Kiejtés gyakorlás azonnali feltöltés nélkül
A tanulók össze szeretnék hasonlítani saját beszédes válaszukat a leckével, mielőtt eldöntenék a beküldést.
`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; egy feladatválasz az alkalmazás által birtokolt rekord marad.
Felvétel → Stop → Play preview. Engedje a tanulót keresni, lassítani az előnézetet vagy megszakítani, és új próbát felvenni. Save locally csak akkor, ha a vázlatot megtartják.
A `duration`, `local_uri`, `mime_type` és `draft_id` leírják a kísérletet. Az alkalmazás dönt, hogy helyben marad-e, vagy később a választott feltöltési munkafolyamaton keresztül kerül beküldésre.
A `preview_error` esetén őrizze meg a vázlatot, és jelenítse meg a `error_code`-t. Ne alakítsa előnézetté vagy mentett vázlatot beküldött Válasszá, amíg az alkalmazás beküldési munkafolyamata nem sikerül.
A Bubble feltöltés nyilvános audiofájlt hoz létre. Ne használja ezt a feltöltést bizalmas felvételekhez.
Tartsa meg a helyi hangvázlatot, és tegye a Küldést egyértelművé
A terepi munkás megszakítható a jegyzet befejezése előtt, és nem kell feltöltenie csak a megőrzés érdekében.
`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. Tárolja a visszakapott `draft_id`-et saját eszközén/fiókhoz kötött állapotban. Használja a Restore local draft-et ugyanahhoz az azonosítóhoz, majd a Play preview-et, mielőtt eldöntené a feltöltést.
A `local_saved` vagy `local_restored` esetén ellenőrizze a `is_saved_locally`, `local_uri` és `duration` értékeket. Csak akkor törölje a mentett vázlatot, ha a felhasználó kifejezetten választotta, vagy egy külön megerősített megőrzési szabály szerint.
Ha a visszaállítás sikertelen, jelenítse meg a `error_code`-t, és tartsa meg az azonosítót a diagnózishoz; ne jelentsen üres vagy eltérő felvételt visszaállítottként. Soha ne végezzen auto-feltöltést újracsatlakozáskor.
A Bubble feltöltés nyilvános audiofájlt hoz létre. Ne használja ezt a feltöltést bizalmas felvételekhez.
Mi működik most
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.
A munkafolyamat felépítése
Használja az alább elérhető béta műveleteket, és tesztelje az eredményt a céleszközein.
Ezek a példák olyan alkalmazásrekordokat használnak, mint a Lesson, Message és Order. Cserélje ki őket saját adat típusokra és elemnevekre. A példaként megadott média címeket saját fájljaival kell helyettesíteni.
Adja hozzá a felvevőt. Állítsa be a document_context = Current User's unique id és a is_active értékét attól függően, hogy a felvételi nézet nyitva van-e.
A Start recording mikrofonengedélyt kér. A Pause és Resume ugyanazt a felvételt tartja. A Stop recording befejezi; várjon a recording_ready-re, mielőtt felülvizsgálatot vagy feltöltést kínálna.
Használja az előnézeti vezérlőket a hallgatáshoz. A Save locally helyi vázlatot tárol ezen az eszközön; a local_saved után tartsa meg a draft_id-t a Restore local draft-hez.
Magyarázza el, hogy a küldés nyilvános fájlt hoz létre. Állítsa be a bubble_upload_url-et a saját Bubble alkalmazásának megfelelő Development vagy Live fájlfeltöltési címére. A Upload to Bubble csak akkor fusson, amikor a felhasználó a Küldést választja; a upload_succeeded során mentse a uploaded_file-et a rekordjában.
Egyszeri beállítás
Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt. Válassza ki a Xodera Audio Recorder Native-t, másolja a kulcsát, majd nyissa meg a Bubble → Plugins → Xodera Audio Recorder Native-t, és illessze be a licensing_api_key-be. Mentse el egyszer; ezután használja az alábbi műveleteket. Minden bővítmény minden projektben saját kulccsal rendelkezik.
Kérjen mikrofonengedélyt, amikor a felhasználó elkezd felvenni. Válassza ki, hogyan mentse az alkalmazás a vázlatokat. A Bubble feltöltés nyilvános fájlt tárol, ezért csak nyilvános tárolásra alkalmas hangra használja.
Egyszeri beállítás
- Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
- Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
- 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.
Telepítés és előfizetés
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.
Eredmény mentése az alkalmazásodba
A upload_succeeded után állítsa be a VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration és mime_type = Recorder's mime_type értékeket. A draft_id helyi vázlatot állít vissza; ez nem online hangfájl.
Hiba, megszakítás és helyreállítás
Ha a mikrofonhozzáférés megtagadásra kerül, magyarázza el, hogyan engedélyezhető az eszköz beállításaiban. A Cancel recording eldobja a mentetlen felvételt; a mentett vázlatok megmaradnak. Ha a feltöltés megszakad, tartsa meg a helyi felvételt, és ellenőrizze, hogy a fájl megérkezett-e, mielőtt újra elküldené. A Delete saved draft csak a kiválasztott mentett vázlatot távolítja el.
Képességek és korlátok
Alapértelmezett maximális felvétel: 300 másodperc; konfigurálható 1–3600. Alapértelmezett feltöltési korlát: 10 MiB; maximum 30 MiB. Feltöltési időkorlát: 60 másodperc, automatikus újrapróbálkozás nélkül. A Bubble feltöltések nyilvánosak. Csak a saját *.bubbleapps.io fájlfeltöltési címei támogatottak; egyedi domainek nem. A helyi vázlatok nem titkosított tárolás.
Beállítások, műveletek és eredmények
Használja ezeket a neveket a Bubble-ben. A tervezett funkciók külön vannak jelölve.
Elérhető béta beállítások
Elem beállítások
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Állapotok
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 · textEsemények
recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_errorMűveletek és azok bemenetei
Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speedElem beállítások · 10
titletext · Alapértelmezett: ""- Példaérték
Lesson 4 — review - Példa Bubble kifejezés
Selected Lesson's name - Látható alkalmazás szöveg; üres esetén a beépített lokalizált szöveg kerül felhasználásra, ahol támogatott. Nincsenek hitelesítő adatok.
max_duration_secondsnumber · Alapértelmezett: 300- Példaérték
300 - Példa Bubble kifejezés
Voice Settings' max_seconds - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
max_upload_bytesnumber · Alapértelmezett: 10485760- Példaérték
10485760 - Példa Bubble kifejezés
Voice Settings' max_upload_bytes - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
is_activeyes_no · Alapértelmezett: true- Példaérték
yes - Példa Bubble kifejezés
GuideHost's view_is_active (your yes/no custom state) - Állítsa igent, amíg ez a nézet nyitva van. Állítsa nemet a kilépéskor, hogy a lejátszás vagy a jelenlegi munka leállhasson.
disabledyes_no · Alapértelmezett: false- Példaérték
no - Példa Bubble kifejezés
GuideHost's is_busy (your yes/no custom state) - Tiltja le az elemet, amíg az alkalmazás foglalt vagy a művelet nem érhető el.
ui_text_jsontext · Alapértelmezett: ""- Példaérték
{} - Példa Bubble kifejezés
App Settings' player_labels_json (supported keys only) - Választható JSON a támogatott gombcímkékkel. Hagyja üresen a beépített szöveg használatához.
saved_draft_idtext · Alapértelmezett: ""- Példaérték
<returned draft_id> - Példa Bubble kifejezés
Selected VoiceDraft's draft_id - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
bubble_upload_urltext · Alapértelmezett: ""- Példaérték
https://your-app.bubbleapps.io/version-test/fileupload - Példa Bubble kifejezés
App Settings' selected_bubble_upload_url - Az Ön saját Bubble alkalmazás fájlfeltöltési címe: /version-test/fileupload a Development-hez, /fileupload a Live-hez. Ez a feltöltés nyilvános fájlokat hoz létre.
languagetext · Alapértelmezett: "auto"- Példaérték
uk - Példa Bubble kifejezés
Current User's preferred_language - Állítsa be a language=auto-t, hogy egy támogatott eszköz vagy böngésző nyelvét kövesse. Adjon meg egy támogatott nyelvkódot a kifejezett kiválasztáshoz.
document_contexttext · Alapértelmezett: ""- Példaérték
<current-user-id> - Példa Bubble kifejezés
Current User's unique id - Stabil érték ehhez a fiókhoz vagy rekordhoz. Használja ugyanazt az értéket a mentett fájlok vagy vázlatok visszaállításakor.
Műveletek és azok bemenetei · 15
Start recording
Nincsenek műveletparaméterek
Pause recording
Nincsenek műveletparaméterek
Resume recording
Nincsenek műveletparaméterek
Stop recording
Nincsenek műveletparaméterek
Cancel recording
Nincsenek műveletparaméterek
Save locally
Nincsenek műveletparaméterek
Restore local draft
draft_idtext · Alapértelmezett: —- Példaérték
<returned draft_id> - Példa Bubble kifejezés
Selected VoiceDraft's draft_id - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Delete saved draft
draft_idtext · Alapértelmezett: —- Példaérték
<returned draft_id> - Példa Bubble kifejezés
Selected VoiceDraft's draft_id - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Upload to Bubble
Nincsenek műveletparaméterek
Cancel upload
Nincsenek műveletparaméterek
Play preview
Nincsenek műveletparaméterek
Pause preview
Nincsenek műveletparaméterek
Stop preview
Nincsenek műveletparaméterek
Seek preview
secondsnumber · Alapértelmezett: —- Példaérték
12 - Példa Bubble kifejezés
Selected Comment's seconds - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Set preview speed
ratenumber · Alapértelmezett: —- Példaérték
1.5 - Példa Bubble kifejezés
Preview Speed Dropdown's value - Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Állapotok és események
Állapotok
recorder_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
permission_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
is_recording · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
is_paused · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
duration · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
local_uri · textFájl helye ezen az eszközön. Mentse vagy töltse fel a fájlt külön, ha online kell maradnia.
draft_id · textAz elem vagy művelet azonosítója. Tartsa meg a megfelelő alkalmazásrekorddal. Használja ugyanazt a kérésazonosítót bizonytalan eredmény újrapróbálásakor.
is_saved_locally · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
mime_type · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
file_size · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
waveform_peaks_json · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
preview_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
preview_is_playing · yes_noA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
preview_current_time · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
upload_status · textA művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.
upload_progress · numberA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
uploaded_url · textA kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.
uploaded_file · fileA fájl visszakapott a upload_succeeded után. Mentse el a Bubble fájl mezőben.
error_code · textHibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.
Események
recording_startedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
recording_pausedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
recording_resumedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
recording_stoppedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
recording_readyAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
recording_cancelledAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
recorder_errorAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
local_savedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
local_restoredAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
local_deletedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
upload_succeededAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
upload_failedAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
upload_cancelledAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
preview_readyAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
preview_errorAmikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.
Fejlesztők által feltett kérdések
A helyi mentés feltölti a felvételt?
Nem. A Save locally helyi eszközvázlatot tart. A Upload to Bubble egy külön, kifejezett nyilvános művelet.
Hogyan működik az előfizetés?
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.
Kapcsolódó útmutatók
Segítségért mondja el, melyik plugint és eszközt használja, milyen műveletet próbált és mi történt. Használjon személyes adatokat nem tartalmazó példát. Soha ne ossza meg a kulcsát vagy privát fájljait.