
Xodera Plugins · Bubble Native
Xodera Offline Files Native
Uchovejte přílohy zprávy a vybrané soubory v zařízení, obnovte je později a umožněte uživateli sdílet vybranou kopii.
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
Připravte několik místních příloh před odesláním zprávy
Formulář musí zobrazit, které soubory byly vybrány, a umožnit uživateli zachovat spravovanou kopii před jakýmkoli odesláním do cloudu.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; nastavte `max_files`, `max_file_bytes` a účet/zprávu `document_context`.
Pick files → zkontrolujte vybraná jména/velikosti → Save selection locally. Váš formulář uchovává výsledná ID souborů, dokud jejich samostatný pracovní postup Odeslat nenahraje schválené soubory.
Použijte `selection_count`, `file_names`, `file_sizes` a `saved_file_ids` k vykreslení seznamu revizí. Uložená spravovaná kopie zachovává originál volajícího.
Zrušený výběr není odeslaná zpráva. Na `files_error` zachovejte již přijatá místní ID a zobrazte `error_code`; nikdy nevytvářejte cloudový příloha jen z místního URI.
Soubory zůstávají na tomto zařízení, dokud nejsou sdíleny nebo nahrány samostatně.
Uchovejte výstup fotoeditoru nebo rekordéru pro pozdější použití
Vygenerovaný místní soubor může být v dočasném umístění; aplikace potřebuje explicitní spravovanou kopii.
`source_uri = the local output of a separately accepted editor/recorder`; svázat jeho skutečné `display_name` a `mime_type`; použít `document_context` stejného vlastníka.
Load local source → zkontrolovat metadata → Save selection locally. Uložte vrácené ID souboru pouze v odpovídajícím zařízení/kontextu, pak Restore saved file tímto přesným ID podle potřeby.
Spotřebujte `file_id`, `local_uri`, `size_bytes` a `is_saved_locally`; použijte `file_restored` k rozlišení dokončené obnovy od pouhého požadavku.
Odmítněte vzdálenou HTTP URL jako místní zdroj. Pokud zdroj zmizí nebo obnova selže, zobrazte `error_code` a zachovejte původní záznam aplikace pro obnovu.
Soubory zůstávají na tomto zařízení, dokud nejsou sdíleny nebo nahrány samostatně.
Umožněte uživateli sdílet lokální účtenku nebo export vygenerovaný aplikací
Aplikace by měla předat vybraný místní soubor do sdílecího listu zařízení místo vytváření veřejné URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; jeho název a MIME popisují skutečný místní soubor.
List saved files → Restore saved file → Share selected file po klepnutí uživatele na Sdílet. Uchovejte uloženou kopii, dokud výslovně nevyberou Delete saved copy.
Použijte `share_status` a `share_sheet_closed` k aktualizaci UI po zavření listu. Zachovejte ID souboru pro další úmyslné sdílení.
Uzavřený sdílecí list není důkaz, že e‑mail/zpráva byla doručena. Zpracujte zrušení a `files_error` bez hlášení úspěchu příjemci.
Soubory zůstávají na tomto zařízení, dokud nejsou sdíleny nebo nahrány samostatně.
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.
Nastavte document_context = Current User's unique id nebo stabilní hodnotu pro účet a zprávu. Vyberte accepted_mime_types_json, max_files a max_file_bytes.
Spusťte Pick files nebo použijte Load local source pro čitelný soubor vytvořený aplikací Photo Editor nebo Recorder. Po selection_changed načtěte odpovídající seznamy souborů; Select picked file vybere index.
Spusťte Save selection locally. Po files_saved uchovejte saved_file_ids v místním záznamu příloh vaší aplikace. List saved files zobrazuje uložené kopie; Restore saved file otevře vybrané uložené ID.
Share selected file otevře systémovou nabídku sdílení. share_sheet_closed jen znamená, že se nabídka zavřela. Delete saved copy potřebuje vybrané ID a confirm=yes.
Nastavte jednou
Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Offline Files Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera Offline Files 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íč.
Použijte nativní aplikaci s přístupem k vybraným souborům. Nastavte stabilní document_context pro účet nebo zprávu, aby její uložené soubory byly správně seskupeny.
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
Příklad LocalAttachment: vlastník, document_context, ID uloženého souboru, display_name, mime_type a size_bytes. Toto ID funguje pouze na stejném zařízení a pro stejný účet nebo zprávu. Pro online přílohu nahrajte soubor samostatným pracovním postupem a uložte vrácený odkaz na online soubor.
Selhání, zrušení a obnovení
Zrušený výběr vrací operation_cancelled; neodesílá formulář. Během native_pending=yes počkejte, až se výběr souboru nebo nabídka sdílení zavře, než otevřete další. Clear session vymaže aktuální výběr, ale zachová uložené kopie. Pokud soubor chybí, nechte uživatele vybrat jej znovu.
Možnosti a limity
Vyberte najednou soubory 1–20. Limit na soubor: 1 byte–256 MiB, s nižším limitem, pokud zvolíte. Filtry typů souborů neprověřují soubory na viry. ID souborů a cesty v zařízení nefungují jako odkazy pro stažení z cloudu. Lokální kopie nejsou šifrované úložiště a mohou být ztraceny při odstranění dat aplikace.
Nastavení, akce a výsledky
Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.
Dostupná beta nastavení
Nastavení prvku
source_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · textStavy
status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (seznam)file_uris · text (seznam)file_names · text (seznam)file_mime_types · text (seznam)file_sizes · number (seznam)files_json · textsaved_count · numbersaved_file_ids · text (seznam)saved_file_uris · text (seznam)saved_file_names · text (seznam)saved_file_mime_types · text (seznam)saved_file_sizes · number (seznam)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textUdálosti
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorAkce a jejich vstupy
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionNastavení prvku · 16
source_uritext · Výchozí: ""- Ukázková hodnota
file:///app-cache/report.pdf - Příklad Bubble výrazu
Photo Editor's output_uri - Čitelná cesta k souboru na tomto zařízení, vrácená vaším výběrem nebo jiným pluginem.
display_nametext · Výchozí: ""- Ukázková hodnota
report-photo.jpg - Příklad Bubble výrazu
Selected Attachment's display_name - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
mime_typetext · Výchozí: ""- Ukázková hodnota
image/jpeg - Příklad Bubble výrazu
Photo Editor's output_mime - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
document_contexttext · Výchozí: "default"- 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ů.
selected_file_idtext · Výchozí: ""- Ukázková hodnota
<returned saved file ID> - Příklad Bubble výrazu
Selected LocalAttachment's local_file_id - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
accepted_mime_types_jsontext · Výchozí: "[\"*/*\"]"- Ukázková hodnota
["image/*","application/pdf"] - Příklad Bubble výrazu
Report Settings' accepted_mime_types_json - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
multipleyes_no · Výchozí: false- Ukázková hodnota
yes - Příklad Bubble výrazu
Report Settings' allow_multiple_attachments - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
copy_to_cacheyes_no · Výchozí: true- Ukázková hodnota
yes - Příklad Bubble výrazu
Report Settings' copy_to_cache - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
max_filesnumber · Výchozí: 20- Ukázková hodnota
5 - Příklad Bubble výrazu
Report Settings' attachment_limit - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
max_file_bytesnumber · Výchozí: 268435456- Ukázková hodnota
10485760 - Příklad Bubble výrazu
Report Settings' max_attachment_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á.
show_controlsyes_no · Výchozí: true- Ukázková hodnota
yes - Příklad Bubble výrazu
App Settings' show_editor_controls - Zobrazit nebo skrýt vestavěné ovládací prvky.
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.
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.
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.
Akce a jejich vstupy · 10
Pick files
Žádné parametry akce
Load local source
source_uritext · Výchozí: —- Ukázková hodnota
file:///app-cache/report.pdf - Příklad Bubble výrazu
Photo Editor's output_uri - Čitelná cesta k souboru na tomto zařízení, vrácená vaším výběrem nebo jiným pluginem.
display_nametext · Výchozí: —- Ukázková hodnota
report-photo.jpg - Příklad Bubble výrazu
Selected Attachment's display_name - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
mime_typetext · Výchozí: —- Ukázková hodnota
image/jpeg - Příklad Bubble výrazu
Photo Editor's output_mime - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Select picked file
indexnumber · Výchozí: —- Ukázková hodnota
0 - Příklad Bubble výrazu
Selected row's current_source_index - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Save selection locally
Žádné parametry akce
List saved files
Žádné parametry akce
Restore saved file
file_idtext · Výchozí: —- Ukázková hodnota
<returned saved file ID> - Příklad Bubble výrazu
Selected LocalAttachment's local_file_id - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Delete saved copy
file_idtext · Výchozí: —- Ukázková hodnota
<returned saved file ID> - Příklad Bubble výrazu
Selected LocalAttachment's local_file_id - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
confirmyes_no · Výchozí: —- Ukázková hodnota
yes — explicit confirmation only - Příklad Bubble výrazu
Confirm Checkbox is checked - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Share selected file
dialog_titletext · Výchozí: —- Ukázková hodnota
Share attachment - Příklad Bubble výrazu
Selected Report's share_title - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
utitext · Výchozí: —- Ukázková hodnota
"" - Příklad Bubble výrazu
Empty unless your iOS integration supplies a proven UTI - Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Cancel operation
Žádné parametry akce
Clear session
Žádné parametry akce
Stavy a události
Stavy
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_busy · yes_noPráce stále probíhá. Počkejte, než spustíte další akci.
native_pending · yes_noPráce stále probíhá. Počkejte, než spustíte další akci.
operation · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
selection_count · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
selected_index · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
file_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.
local_uri · textUmístění souboru na tomto zařízení. Uložte nebo nahrajte soubor samostatně, pokud má být uchován online.
display_name · textAktuá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.
mime_source · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
size_bytes · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
is_saved_locally · yes_noAktuální hodnota vybrané položky. Přečtěte ji po související události.
file_ids · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
file_uris · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
file_names · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
file_mime_types · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
file_sizes · number (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
files_json · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
saved_count · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
saved_file_ids · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
saved_file_uris · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
saved_file_names · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
saved_file_mime_types · text (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
saved_file_sizes · number (seznam)Seznam vybraných souborů. Položky se stejným indexem v ostatních seznamech souborů odkazují na stejný soubor.
saved_files_json · textAktuální hodnota vybrané položky. Přečtěte ji po související události.
invalid_saved_count · numberAktuální hodnota vybrané položky. Přečtěte ji po související události.
share_status · textAktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu.
error_code · textInformace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.
Události
selection_changedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
files_savedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
list_loadedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
file_restoredKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
file_deletedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
share_sheet_closedKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
operation_cancelledKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
files_errorKdyž nastane tato událost, přečtěte související stavy ze stejného prvku.
Otázky, které vývojáři kladou
Znamená Sdílení „odesláno“?
Ne. OS zde neposkytuje spolehlivý potvrzení o úspěšném doručení příjemci. Zobrazte „sdílecí list zavřen“.
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.