Xodera Plugins · Bubble Native
Xodera Offline Files Native
Uchovajte prílohy správy a vybrané súbory v zariadení, obnovte ich neskôr a umožnite používateľovi zdieľať vybranú kópiu.
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ácia skontrolovaná 6 november 2026
Praktické príklady
Pripravte niekoľko lokálnych príloh pred odoslaním správy
Formulár musí zobrazovať, ktoré súbory boli vybrané, a umožniť používateľovi uchovať spravovanú kópiu pred akýmkoľvek odoslaním do cloudu.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; nastavte `max_files`, `max_file_bytes` a účet/hlásenie `document_context`.
Pick files → skontrolujte vybrané názvy/veľkosti → Save selection locally. Váš formulár uchováva výsledné ID súborov, kým ich samostatný pracovný tok Odoslať neodošle schválené súbory.
Použite `selection_count`, `file_names`, `file_sizes` a `saved_file_ids` na vykreslenie zoznamu recenzií. Uložená spravovaná kópia zachová originál volajúceho.
Zrušený výber nie je odoslaná správa. Na `files_error` zachovajte už prijaté lokálne ID a zobrazte `error_code`; nikdy nevytvárajte cloudové prílohy len z lokálneho URI.
Súbory zostanú na tomto zariadení, kým nie sú zdieľané alebo odoslané samostatne.
Uchovajte výstup fotoeditora alebo rekordéra na neskoršie použitie
Vygenerovaný lokálny súbor môže byť v dočasnom umiestnení; aplikácia potrebuje explicitnú spravovanú kópiu.
`source_uri = the local output of a separately accepted editor/recorder`; prepojte jeho skutočný `display_name` a `mime_type`; použite `document_context` toho istého vlastníka.
Load local source → skontrolujte metadáta → Save selection locally. Uložte vrátené ID súboru len do zodpovedajúceho zariadenia/kontekstu, potom Restore saved file podľa tohto presného ID podľa potreby.
Spotrebujte `file_id`, `local_uri`, `size_bytes` a `is_saved_locally`; použite `file_restored` na rozlíšenie dokončenej obnovy od iba požiadavky na ňu.
Odmietnite vzdialenú URL HTTP ako lokálny zdroj. Ak zdroj zmizne alebo obnova zlyhá, zobrazte `error_code` a zachovajte pôvodný záznam aplikácie pre obnovu.
Súbory zostanú na tomto zariadení, kým nie sú zdieľané alebo odoslané samostatne.
Umožnite používateľovi zdieľať lokálny doklad alebo export vygenerovaný aplikáciou
Aplikácia by mala odovzdať vybraný lokálny súbor do zdieľacieho listu zariadenia namiesto vytvárania verejnej URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; jeho názov a MIME popisujú skutočný lokálny súbor.
List saved files → Restore saved file → Share selected file po kliknutí používateľa na Zdieľať. Uchovajte uloženú kópiu, kým výslovne nevyberú Delete saved copy.
Použite `share_status` a `share_sheet_closed` na aktualizáciu používateľského rozhrania po zatvorení listu. Zachovajte ID súboru pre ďalšie úmyselné zdieľanie.
Zatvorený zdieľací list nepreukazuje, že e‑mail/odkaz bol doručený. Spracujte zrušenie a `files_error` bez hlásenia úspechu príjemcovi.
Súbory zostanú na tomto zariadení, kým nie sú zdieľané alebo odoslané samostatne.
Čo funguje teraz
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.
Vytvorte pracovný postup
Použite dostupné beta akcie nižšie a otestujte výsledok na svojich cieľových zariadeniach.
Tieto príklady používajú záznamy aplikácie, ako sú Lesson, Message a Order. Nahraďte ich vlastnými typmi údajov a názvami prvkov. Príkladové mediálne adresy musia byť nahradené vašimi vlastnými súbormi.
Nastavte document_context = Current User's unique id alebo stabilnú hodnotu pre účet a správu. Vyberte accepted_mime_types_json, max_files a max_file_bytes.
Spustite Pick files alebo použite Load local source pre čitateľný súbor vytvorený Photo Editorom alebo Recorderom. Po selection_changed prečítajte zodpovedajúce zoznamy súborov; Select picked file vyberá index.
Spustite Save selection locally. Po files_saved uchovajte saved_file_ids v lokálnom zázname príloh vašej aplikácie. List saved files zobrazuje uložené kópie; Restore saved file otvorí vybrané uložené ID.
Share selected file otvorí systémovú ponuku zdieľania. share_sheet_closed znamená iba, že ponuka bola zatvorená. Delete saved copy potrebuje vybrané ID a confirm=yes.
Nastavte raz
Vytvorte alebo vyberte svoj Bubble projekt v BestPlugins → Dashboard → Plugins. Vyberte Xodera Offline Files Native, skopírujte jeho kľúč a potom otvorte Bubble → Plugins → Xodera Offline Files Native a vložte ho do licensing_api_key. Uložte raz; potom použite akcie nižšie. Každý plugin v každom projekte má svoj vlastný kľúč.
Použite natívnu aplikáciu s prístupom k vybraným súborom. Nastavte stabilný document_context pre účet alebo správu, aby sa jej uložené súbory správne zoskupovali.
Nastavte raz
- Vytvorte alebo vyberte svoj Bubble projekt na BestPlugins → Dashboard → Plugins.
- Vyberte tento plugin a skopírujte jeho projektový kľúč.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridajte element, vyberte svoje údaje aplikácie a zostavte pracovný postup nižšie.
- 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.
Inštalácia a predplatné
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ýsledok do svojej aplikácie
Príklad LocalAttachment: vlastník, document_context, ID uloženého súboru, display_name, mime_type a size_bytes. Toto ID funguje iba na rovnakom zariadení a pre rovnaký účet alebo správu. Pre online prílohu nahrajte súbor samostatným pracovným tokom a uložte vrátený online odkaz na súbor.
Zlyhanie, zrušenie a obnovenie
Zrušený výber vráti operation_cancelled; neodosiela formulár. Počas native_pending=yes počkajte, kým sa výber súboru alebo ponuka zdieľania zatvorí, predtým než otvoríte ďalší. Clear session vymaže aktuálny výber, ale zachová uložené kópie. Ak súbor chýba, nechajte používateľa vybrať ho znova.
Možnosti a limity
Vyberte súbory 1–20 naraz. Limit na súbor: 1 bajt–256 MiB, s nižším limitom podľa potreby. Filtre typov súborov nekontrolujú vírusy. ID a cesty súborov v zariadení nefungujú ako odkazy na cloudové sťahovanie. Lokálne kópie nie sú šifrovaným úložiskom a môžu byť stratené pri odstránení dát aplikácie.
Nastavenia, akcie a výsledky
Použite tieto názvy v Bubble. Plánované funkcie sú označené samostatne.
Dostupné beta nastavenia
Nastavenia 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 (Zoznam)file_uris · text (Zoznam)file_names · text (Zoznam)file_mime_types · text (Zoznam)file_sizes · number (Zoznam)files_json · textsaved_count · numbersaved_file_ids · text (Zoznam)saved_file_uris · text (Zoznam)saved_file_names · text (Zoznam)saved_file_mime_types · text (Zoznam)saved_file_sizes · number (Zoznam)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textUdalosti
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorAkcie a ich vstupy
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionNastavenia prvku · 16
source_uritext · Predvolené: ""- Ukážková hodnota
file:///app-cache/report.pdf - Príklad Bubble výraz
Photo Editor's output_uri - Čitateľná cesta k súboru na tomto zariadení, vrátená vaším výberom alebo iným pluginom.
display_nametext · Predvolené: ""- Ukážková hodnota
report-photo.jpg - Príklad Bubble výraz
Selected Attachment's display_name - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
mime_typetext · Predvolené: ""- Ukážková hodnota
image/jpeg - Príklad Bubble výraz
Photo Editor's output_mime - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
document_contexttext · Predvolené: "default"- Ukážková hodnota
<current-user-id> - Príklad Bubble výraz
Current User's unique id - Stabilná hodnota pre tento účet alebo záznam. Použite rovnakú hodnotu pri obnove jeho uložených súborov alebo konceptov.
selected_file_idtext · Predvolené: ""- Ukážková hodnota
<returned saved file ID> - Príklad Bubble výraz
Selected LocalAttachment's local_file_id - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
accepted_mime_types_jsontext · Predvolené: "[\"*/*\"]"- Ukážková hodnota
["image/*","application/pdf"] - Príklad Bubble výraz
Report Settings' accepted_mime_types_json - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
multipleyes_no · Predvolené: false- Ukážková hodnota
yes - Príklad Bubble výraz
Report Settings' allow_multiple_attachments - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
copy_to_cacheyes_no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
Report Settings' copy_to_cache - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
max_filesnumber · Predvolené: 20- Ukážková hodnota
5 - Príklad Bubble výraz
Report Settings' attachment_limit - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
max_file_bytesnumber · Predvolené: 268435456- Ukážková hodnota
10485760 - Príklad Bubble výraz
Report Settings' max_attachment_bytes - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
is_activeyes_no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
GuideHost's view_is_active (your yes/no custom state) - Nastavte áno, kým je tento pohľad otvorený. Nastavte nie pri odchode, aby sa prehrávanie alebo aktuálna práca mohla zastaviť.
disabledyes_no · Predvolené: false- Ukážková hodnota
no - Príklad Bubble výraz
GuideHost's is_busy (your yes/no custom state) - Zakážte prvok, keď je vaša aplikácia zaneprázdnená alebo je táto akcia nedostupná.
show_controlsyes_no · Predvolené: true- Ukážková hodnota
yes - Príklad Bubble výraz
App Settings' show_editor_controls - Zobraziť alebo skryť vstavané ovládacie prvky.
languagetext · Predvolené: "auto"- Ukážková hodnota
uk - Príklad Bubble výraz
Current User's preferred_language - Nastavte language=auto, aby sledoval podporované zariadenie alebo jazyk prehliadača. Zadajte podporovaný kód jazyka pre jeho explicitný výber.
ui_text_jsontext · Predvolené: ""- Ukážková hodnota
{} - Príklad Bubble výraz
App Settings' player_labels_json (supported keys only) - Voliteľný JSON s podporovanými popiskami tlačidiel. Ponechajte prázdne pre použitie vstavaného textu.
titletext · Predvolené: ""- Ukážková hodnota
Lesson 4 — review - Príklad Bubble výraz
Selected Lesson's name - Viditeľný text aplikácie; prázdne použije vstavanú lokalizovanú verziu, ak je podporovaná. Žiadne poverenia.
Akcie a ich vstupy · 10
Pick files
Žiadne parametre akcie
Load local source
source_uritext · Predvolené: —- Ukážková hodnota
file:///app-cache/report.pdf - Príklad Bubble výraz
Photo Editor's output_uri - Čitateľná cesta k súboru na tomto zariadení, vrátená vaším výberom alebo iným pluginom.
display_nametext · Predvolené: —- Ukážková hodnota
report-photo.jpg - Príklad Bubble výraz
Selected Attachment's display_name - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
mime_typetext · Predvolené: —- Ukážková hodnota
image/jpeg - Príklad Bubble výraz
Photo Editor's output_mime - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Select picked file
indexnumber · Predvolené: —- Ukážková hodnota
0 - Príklad Bubble výraz
Selected row's current_source_index - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Save selection locally
Žiadne parametre akcie
List saved files
Žiadne parametre akcie
Restore saved file
file_idtext · Predvolené: —- Ukážková hodnota
<returned saved file ID> - Príklad Bubble výraz
Selected LocalAttachment's local_file_id - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Delete saved copy
file_idtext · Predvolené: —- Ukážková hodnota
<returned saved file ID> - Príklad Bubble výraz
Selected LocalAttachment's local_file_id - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
confirmyes_no · Predvolené: —- Ukážková hodnota
yes — explicit confirmation only - Príklad Bubble výraz
Confirm Checkbox is checked - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Share selected file
dialog_titletext · Predvolené: —- Ukážková hodnota
Share attachment - Príklad Bubble výraz
Selected Report's share_title - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
utitext · Predvolené: —- Ukážková hodnota
"" - Príklad Bubble výraz
Empty unless your iOS integration supplies a proven UTI - Použite hodnotu aktuálneho obchodného záznamu; overte ju voči nižšie uvedeným limitom.
Cancel operation
Žiadne parametre akcie
Clear session
Žiadne parametre akcie
Stavy a udalosti
Stavy
status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
is_busy · yes_noPráca stále prebieha. Počkajte pred spustením ďalšej akcie.
native_pending · yes_noPráca stále prebieha. Počkajte pred spustením ďalšej akcie.
operation · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
selection_count · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
selected_index · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
file_id · textIdentifikátor pre túto položku alebo akciu. Uchovajte ho s príslušným záznamom aplikácie. Použite rovnaký identifikátor požiadavky pri opakovaní neistého výsledku.
local_uri · textUmiestnenie súboru na tomto zariadení. Uložte alebo nahrajte súbor samostatne, ak musí zostať online.
display_name · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
mime_type · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
mime_source · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
size_bytes · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
is_saved_locally · yes_noAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
file_ids · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
file_uris · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
file_names · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
file_mime_types · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
file_sizes · number (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
files_json · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
saved_count · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
saved_file_ids · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
saved_file_uris · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
saved_file_names · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
saved_file_mime_types · text (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
saved_file_sizes · number (Zoznam)Zoznam vybraných súborov. Položky na rovnakom indexe v ostatných zoznamoch súborov odkazujú na ten istý súbor.
saved_files_json · textAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
invalid_saved_count · numberAktuálna hodnota vybranej položky. Prečítajte ju po súvisiacej udalosti.
share_status · textAktuálny výsledok tejto akcie. Použite zodpovedajúcu udalosť dokončenia pred uložením úspechu.
error_code · textInformácie o chybe poslednej akcie. Zobrazte užitočnú správu a ponúknite príslušný opätovný pokus.
Udalosti
selection_changedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
files_savedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
list_loadedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
file_restoredKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
file_deletedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
share_sheet_closedKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
operation_cancelledKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
files_errorKeď nastane táto udalosť, prečítajte súvisiace stavy z rovnakého prvku.
Otázky, ktoré kladú vývojári
Znamená Zdieľať „odoslané“?
Nie. OS neposkytuje spoľahlivý potvrdenie o úspešnom prijímaní. Zobrazte „ponuka zdieľania zatvorená“.
Ako funguje predplatné?
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.
Súvisiace návody
Pre pomoc nám povedzte, ktorý plugin a zariadenie používate, akú akciu ste skúšali a čo sa stalo. Použite príklad bez osobných údajov. Nikdy nezdieľajte svoj kľúč ani súkromné súbory.