Audio Recorder felület.
Audio Recorder felület.
← Minden natív útmutató

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

Munkafolyamat diagram — nem alkalmazás képernyőkép

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
  1. Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
  2. Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
  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.
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 · text

Események

recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_error

Műveletek és azok bemenetei

Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speed
Elem beállítások · 10
titletext · Alapértelmezett: ""
PéldaértékLesson 4 — review
Példa Bubble kifejezésSelected 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ék300
Példa Bubble kifejezésVoice 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ék10485760
Példa Bubble kifejezésVoice 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ékyes
Példa Bubble kifejezésGuideHost'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ékno
Példa Bubble kifejezésGuideHost'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ésApp 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ésSelected 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ékhttps://your-app.bubbleapps.io/version-test/fileupload
Példa Bubble kifejezésApp 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ékuk
Példa Bubble kifejezésCurrent 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ésCurrent 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ésSelected 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ésSelected 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ék12
Példa Bubble kifejezésSelected 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ék1.5
Példa Bubble kifejezésPreview 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 · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

permission_status · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

is_recording · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

is_paused · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

duration · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

local_uri · text

Fájl helye ezen az eszközön. Mentse vagy töltse fel a fájlt külön, ha online kell maradnia.

draft_id · text

Az 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_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

mime_type · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

file_size · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

waveform_peaks_json · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

preview_status · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

preview_is_playing · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

preview_current_time · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

upload_status · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

upload_progress · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

uploaded_url · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

uploaded_file · file

A fájl visszakapott a upload_succeeded után. Mentse el a Bubble fájl mezőben.

error_code · text

Hibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.

Események

recording_started

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

recording_paused

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

recording_resumed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

recording_stopped

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

recording_ready

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

recording_cancelled

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

recorder_error

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

local_saved

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

local_restored

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

local_deleted

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

upload_succeeded

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

upload_failed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

upload_cancelled

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

preview_ready

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

preview_error

Amikor 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.