Xodera Plugins · Bubble Native
Xodera Audio Recorder Native
Umožněte lidem nahrát hlasovou poznámku, poslechnout si ji před odesláním a uchovat lokální koncept. Nahrajte ji pouze, když se rozhodnou nahrávku odeslat.
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.
Dokumentace přezkoumána 6 listopad 2026
Praktické příklady
Poslechněte si hlasovou zprávu bez důvěrných informací před jejím odesláním
Uživatelé potřebují možnost poslechnout si a nahradit nahrávku, než se stane přílohou.
`title = the app’s conversation label`; nastavte `max_duration_seconds` a `max_upload_bytes` podle vaší politiky zpráv.
Start recording → Stop recording → čekejte na `recording_ready` → Play preview. Nabídněte Seek preview a Set preview speed. Pouze explicitní Odeslat vyvolá Upload to Bubble na přijatém koncovém bodu nahrávání vlastní aplikace.
Pouze na `upload_succeeded` vytvořte svůj Message a nastavte jeho audio pole na `uploaded_file`. Zpráva není vytvořena samotným rekordérem.
Při odmítnutí mikrofonu zobrazte `permission_status`; při selhání nahrávání zachovejte lokální nahrávku. Zkontrolujte výsledek neznámého nahrávání před opakováním, aby Odeslat nemohl vytvořit duplicitní přílohy/zprávy.
Nahrání Bubble vytvoří veřejný audio soubor. Nepoužívejte toto nahrání pro důvěrné nahrávky.
Procvičování výslovnosti bez okamžitého nahrání
Učící se chtějí porovnat svou vlastní mluvenou odpověď s lekcí, než se rozhodnou ji odeslat.
`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; odpověď na cvičení zůstává záznamem vlastněným aplikací.
Nahrát → Stop → Play preview. Nechte učícího se posouvat, zpomalit náhled nebo zrušit a nahrát další pokus. Save locally pouze když se rozhodnou zachovat koncept.
`duration`, `local_uri`, `mime_type` a `draft_id` popisují pokus. Vaše aplikace rozhodne, zda zůstane lokální nebo bude později odeslána prostřednictvím vámi zvoleného workflow nahrávání.
Na `preview_error` zachovejte koncept a zobrazte `error_code`. Nepřevádějte náhled nebo uložený koncept na odeslanou Odpověď, dokud neproběhne úspěšně workflow odeslání aplikace.
Nahrání Bubble vytvoří veřejný audio soubor. Nepoužívejte toto nahrání pro důvěrné nahrávky.
Uchovávejte lokální hlasový koncept a udělejte Odeslat explicitním
Terénní pracovník může být přerušen před dokončením poznámky a neměl by ji muset nahrát jen kvůli jejímu zachování.
`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. Uložte vrácený `draft_id` do svého zařízení/stavu v rámci účtu. Použijte Restore local draft pro stejné ID, poté Play preview před rozhodnutím o nahrání.
Na `local_saved` nebo `local_restored` zkontrolujte `is_saved_locally`, `local_uri` a `duration`. Smazat uložený koncept pouze po explicitní volbě uživatele nebo po samostatně potvrzené politice uchování.
Pokud obnovení selže, zobrazte `error_code` a uchovejte ID pro diagnostiku; nehlaste prázdný nebo jiný záznam jako obnovený. Nikdy neprovádějte auto-nahrávání při opětovném připojení.
Nahrání Bubble vytvoří veřejný audio soubor. Nepoužívejte toto nahrání pro důvěrné nahrávky.
Co funguje nyní
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.
Vytvořte pracovní postup
Použijte níže dostupné beta akce a otestujte výsledek na svých cílových zařízeních.
Tyto příklady používají záznamy aplikace, jako jsou Lesson, Message a Order. Nahraďte je vlastními typy dat a názvy prvků. Příkladové adresy médií je třeba nahradit vlastními soubory.
Přidejte rekordér. Nastavte document_context = Current User's unique id a is_active podle toho, zda je zobrazení nahrávání otevřeno.
Start recording požaduje oprávnění k mikrofonu. Pozastavení a pokračování zachovají stejný záznam. Stop recording jej ukončí; počkejte na recording_ready před nabídkou revize nebo nahrání.
Použijte ovládací prvky náhledu k poslechu. Save locally uchovává koncept na tomto zařízení; po local_saved zachovejte draft_id pro Restore local draft.
Vysvětlete, že odeslání vytvoří veřejný soubor. Nastavte bubble_upload_url na správnou Development nebo Live adresu pro nahrávání souborů vaší vlastní Bubble aplikace. Spusťte Upload to Bubble pouze když uživatel zvolí Odeslat; při upload_succeeded uložte uploaded_file do vašeho záznamu.
Nastavte jednou
Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Audio Recorder Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera Audio Recorder Native a vložte jej do licensing_api_key. Uložte jednou; poté použijte akce níže. Každý plugin v každém projektu má svůj vlastní klíč.
Požádejte o oprávnění k mikrofonu, když uživatel zahájí nahrávání. Zvolte, jak aplikace bude ukládat koncepty. Bubble nahrávání ukládá veřejný soubor, takže jej používejte jen pro audio vhodné pro veřejné úložiště.
Nastavte jednou
- Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a zkopírujte jeho projektový klíč.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
- 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.
Instalace a předplatné
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.
Uložte výsledek ve své aplikaci
Po upload_succeeded nastavte VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration a mime_type = Recorder's mime_type. draft_id obnoví koncept na tomto zařízení; nejde o online audio soubor.
Selhání, zrušení a obnovení
Pokud je přístup k mikrofonu odmítnut, vysvětlete, jak jej povolit v nastavení zařízení. Cancel recording zahodí neuložený záznam; uložené koncepty zůstávají. Pokud je nahrávání přerušeno, zachovejte lokální nahrávku a ověřte, zda soubor dorazil, než jej pošlete znovu. Delete saved draft odstraní pouze vybraný uložený koncept.
Možnosti a limity
Výchozí maximální záznam: 300 sekund; nastavitelný 1–3600. Výchozí limit nahrávání: 10 MiB; maximální 30 MiB. Časový limit nahrávání: 60 sekund, bez automatického opakování. Bubble nahrávky jsou veřejné. Podporovány jsou pouze vaše vlastní *.bubbleapps.io adresy pro nahrávání souborů; vlastní domény nejsou. Lokální koncepty nejsou šifrovaným úložištěm.
Nastavení, akce a výsledky
Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.
Dostupná beta nastavení
Nastavení prvku
title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · textStavy
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 · textUdálosti
recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_errorAkce a jejich vstupy
Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speedNastavení prvku · 10
titletext · Výchozí: ""- Ukázková hodnota
Lesson 4 — review - Příklad Bubble výrazu
Selected Lesson's name - Viditelný text aplikace; prázdné použije vestavěnou lokalizovanou verzi, kde je podporována. Žádné přihlašovací údaje.
max_duration_secondsnumber · Výchozí: 300- Ukázková hodnota
300 - Příklad Bubble výrazu
Voice Settings' max_seconds - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
max_upload_bytesnumber · Výchozí: 10485760- Ukázková hodnota
10485760 - Příklad Bubble výrazu
Voice Settings' max_upload_bytes - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
is_activeyes_no · Výchozí: true- Ukázková hodnota
yes - Příklad Bubble výrazu
GuideHost's view_is_active (your yes/no custom state) - Nastavte ano, dokud je tento pohled otevřený. Nastavte ne při odchodu, aby se přehrávání nebo aktuální práce mohly zastavit.
disabledyes_no · Výchozí: false- Ukázková hodnota
no - Příklad Bubble výrazu
GuideHost's is_busy (your yes/no custom state) - Deaktivujte prvek, když je aplikace zaneprázdněná nebo je tato akce nedostupná.
ui_text_jsontext · Výchozí: ""- Ukázková hodnota
{} - Příklad Bubble výrazu
App Settings' player_labels_json (supported keys only) - Volitelný JSON s podporovanými popisky tlačítek. Nechte prázdné pro použití vestavěného textu.
saved_draft_idtext · Výchozí: ""- Ukázková hodnota
<returned draft_id> - Příklad Bubble výrazu
Selected VoiceDraft's draft_id - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
bubble_upload_urltext · Výchozí: ""- Ukázková hodnota
https://your-app.bubbleapps.io/version-test/fileupload - Příklad Bubble výrazu
App Settings' selected_bubble_upload_url - Vaše vlastní Bubble adresa pro nahrávání souborů aplikace: /version-test/fileupload pro Development, /fileupload pro Live. Toto nahrávání vytváří veřejné soubory.
languagetext · Výchozí: "auto"- Ukázková hodnota
uk - Příklad Bubble výrazu
Current User's preferred_language - Nastavte language=auto tak, aby sledoval podporované zařízení nebo jazyk prohlížeče. Zadejte podporovaný kód jazyka pro jeho explicitní výběr.
document_contexttext · Výchozí: ""- Ukázková hodnota
<current-user-id> - Příklad Bubble výrazu
Current User's unique id - Stabilní hodnota pro tento účet nebo záznam. Použijte stejnou hodnotu při obnově jeho uložených souborů nebo konceptů.
Akce a jejich vstupy · 15
Start recording
Žádné parametry akce
Pause recording
Žádné parametry akce
Resume recording
Žádné parametry akce
Stop recording
Žádné parametry akce
Cancel recording
Žádné parametry akce
Save locally
Žádné parametry akce
Restore local draft
draft_idtext · Výchozí: —- Ukázková hodnota
<returned draft_id> - Příklad Bubble výrazu
Selected VoiceDraft's draft_id - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Delete saved draft
draft_idtext · Výchozí: —- Ukázková hodnota
<returned draft_id> - Příklad Bubble výrazu
Selected VoiceDraft's draft_id - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Upload to Bubble
Žádné parametry akce
Cancel upload
Žádné parametry akce
Play preview
Žádné parametry akce
Pause preview
Žádné parametry akce
Stop preview
Žádné parametry akce
Seek preview
secondsnumber · Výchozí: —- Ukázková hodnota
12 - Příklad Bubble výrazu
Selected Comment's seconds - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Set preview speed
ratenumber · Výchozí: —- Ukázková hodnota
1.5 - Příklad Bubble výrazu
Preview Speed Dropdown's value - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Stavy a události
Stavy
recorder_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
permission_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
is_recording · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
is_paused · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
duration · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
local_uri · textUmístění souboru na tomto zařízení. Uložte nebo nahrajte soubor samostatně, pokud má být uchován online.
draft_id · textIdentifikátor pro tuto položku nebo akci. Uchovejte jej u odpovídajícího záznamu aplikace. Použijte stejný identifikátor požadavku při opakování nejistého výsledku.
is_saved_locally · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
mime_type · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
file_size · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
waveform_peaks_json · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
preview_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
preview_is_playing · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
preview_current_time · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
upload_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
upload_progress · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
uploaded_url · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
uploaded_file · fileSoubor vrácen po upload_succeeded. Uložte jej do pole Soubor ve vašem Bubble.
error_code · textInformace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.
Události
recording_startedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
recording_pausedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
recording_resumedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
recording_stoppedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
recording_readyKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
recording_cancelledKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
recorder_errorKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
local_savedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
local_restoredKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
local_deletedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
upload_succeededKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
upload_failedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
upload_cancelledKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
preview_readyKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
preview_errorKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
Otázky, které vývojáři kladou
Nahrává lokální uložení nahrávku?
Ne. Save locally uchovává vlastní koncept zařízení. Upload to Bubble je samostatná explicitní veřejná operace.
Jak funguje předplatné?
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.
Související průvodci
Pro pomoc nám sdělte, který plugin a zařízení používáte, jakou akci jste zkusili a co se stalo. Použijte příklad bez osobních údajů. Nikdy nesdílejte svůj klíč ani soukromé soubory.