Xodera Plugins · Bubble Native
Xodera Offline Files Native
Obdržite priponke poročila in izbrane datoteke na napravi, jih pozneje obnovite in uporabniku omogočite deljenje izbrane kopije.
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.
Dokumentacija pregledana 6 november 2026
Praktični primeri
Pripravite več lokalnih priponk pred oddajo poročila
Obrazec mora prikazati, katere datoteke so bile izbrane, in uporabniku omogočiti, da ohrani upravljano kopijo pred kakršnokoli pošiljanjem v oblak.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; nastavite `max_files`, `max_file_bytes` in račun/poročilo `document_context`.
Pick files → pregled izbranih imen/velikosti → Save selection locally. Vaš obrazec hrani nastale ID-je datotek, dokler njihov ločen postopek Pošlji ne naloži odobrenih datotek.
Uporabite `selection_count`, `file_names`, `file_sizes` in `saved_file_ids` za prikaz seznama pregledov. Shranjena upravljana kopija ohranja izvirnik klicatelja.
Preklicani izbirnik ni oddano poročilo. Na `files_error` obdržite že sprejete lokalne ID-je in prikažite `error_code`; nikoli ne ustvarite oblačne priponke samo iz lokalnega URI-ja.
Datoteke ostanejo na tej napravi, dokler niso deljene ali ločeno naložene.
Obdržite izhod foto‑urejevalnika ali snemalnika za kasnejšo uporabo
Ustvarjena lokalna datoteka lahko živi v začasni lokaciji; aplikacija potrebuje izrecno upravljano kopijo.
`source_uri = the local output of a separately accepted editor/recorder`; povežite njegovo dejansko `display_name` in `mime_type`; uporabite `document_context` istega lastnika.
Load local source → pregledajte metapodatke → Save selection locally. Shranite vrnjeni ID datoteke le v ustrezni napravi/kontekstu, nato Restore saved file s tem točnim ID-jem po potrebi.
Porabite `file_id`, `local_uri`, `size_bytes` in `is_saved_locally`; uporabite `file_restored` za razlikovanje dokončane obnove od zgolj zahteve po njej.
Zavrnite oddaljeni HTTP URL kot lokalni vir. Če vir izgine ali obnova ne uspe, prikažite `error_code` in ohranite izvirni zapis aplikacije za obnovitev.
Datoteke ostanejo na tej napravi, dokler niso deljene ali ločeno naložene.
Omogočite uporabniku, da deli lokalni račun ali izvoz, ki ga je ustvarila aplikacija
Aplikacija naj izbrano lokalno datoteko predloži sistemskemu deljenju naprave, namesto da ustvarja javni URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; njegovo ime in MIME opisujeta dejansko lokalno datoteko.
List saved files → Restore saved file → Share selected file po tem, ko uporabnik pritisne Deli. Obdržite shranjeno kopijo, dokler ne izberejo Delete saved copy.
Uporabite `share_status` in `share_sheet_closed` za posodobitev uporabniškega vmesnika po zaprtju delilnega lista. Ohranite ID datoteke za naslednjo namerno delitev.
Zaprt delilni list ni dokaz, da je bil e‑mail/sporočilo dostavljeno. Obravnavajte preklic in `files_error` brez poročanja o uspehu prejemniku.
Datoteke ostanejo na tej napravi, dokler niso deljene ali ločeno naložene.
Kaj deluje zdaj
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.
Ustvarite delovni tok
Uporabite spodnje razpoložljive beta akcije in preizkusite rezultat na svojih ciljnih napravah.
Ti primeri uporabljajo zapise aplikacije, kot so Lesson, Message in Order. Zamenjajte jih s svojimi vrstami podatkov in imeni elementov. Primeri naslovov medijev je treba zamenjati s svojimi datotekami.
Nastavite document_context = Current User's unique id ali stabilno vrednost za račun in poročilo. Izberite accepted_mime_types_json, max_files in max_file_bytes.
Zaženite Pick files ali uporabite Load local source za berljivo datoteko, ki jo je ustvaril Photo Editor ali Recorder. Po selection_changed preberite ustrezne sezname datotek; Select picked file izbere indeks.
Zaženite Save selection locally. Po files_saved shranite saved_file_ids v lokalni zapis priponk vaše aplikacije. List saved files prikaže shranjene kopije; Restore saved file odpre izbrani shranjeni ID.
Share selected file odpre sistemski meni za deljenje. share_sheet_closed pomeni le, da se je meni zaprl. Delete saved copy potrebuje izbrani ID in confirm=yes.
Nastavite enkrat
Ustvarite ali izberite svoj projekt aplikacije Bubble v BestPlugins → Dashboard → Plugins. Izberite Xodera Offline Files Native, kopirajte njegov ključ, nato odprite Bubble → Plugins → Xodera Offline Files Native in ga prilepite v licensing_api_key. Shranite enkrat; nato uporabite spodnje akcije. Vsak vtičnik v vsakem projektu ima svoj ključ.
Uporabite nativno aplikacijo z dostopom do izbranih datotek. Nastavite stabilen document_context za račun ali poročilo, da se njegove shranjene datoteke pravilno združijo.
Nastavite enkrat
- Ustvarite ali izberite svoj projekt aplikacije Bubble pri BestPlugins → Dashboard → Plugins.
- Izberite ta vtičnik in kopirajte njegov ključ projekta.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Dodajte element, izberite svoje podatke aplikacije in sestavite spodnji potek dela.
- 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.
Namestitev in naročnina
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.
Shrani rezultat v vašo aplikacijo
Primer LocalAttachment: lastnik, document_context, ID shranjene datoteke, display_name, mime_type in size_bytes. Ta ID deluje le na isti napravi in za isti račun ali poročilo. Za spletno priponko naložite datoteko s posebnim delovnim tokom in shranite vrnjeno spletno referenco datoteke.
Napaka, preklic in obnovitev
Preklicani izbirnik vrne operation_cancelled; ne pošlje obrazca. Med native_pending=yes počakajte, da se izbirnik datotek ali meni za deljenje zapre, preden odprete novega. Clear session počisti trenutno izbiro, vendar ohrani shranjene kopije. Če datoteka manjka, uporabniku omogočite, da jo izbere znova.
Zmožnosti in omejitve
Izberite datoteke 1–20 hkrati. Omejitev na datoteko: 1 bajt–256 MiB, z nižjo omejitvijo po potrebi. Filtri po tipu datoteke ne preverjajo virusov. ID-ji in poti datotek na napravi ne delujejo kot povezave za prenos iz oblaka. Lokalne kopije niso šifrirano shranjevanje in se lahko izgubijo, če se podatki aplikacije odstranijo.
Nastavitve, dejanja in rezultati
Uporabite ta imena v Bubble. Načrtovane funkcije so označene ločeno.
Razpoložljive beta nastavitve
Nastavitve elementa
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 · textStanja
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 · textDogodki
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorDejanja in njihovi vnosi
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionNastavitve elementa · 16
source_uritext · Privzeto: ""- Primer vrednosti
file:///app-cache/report.pdf - Primer Bubble izraza
Photo Editor's output_uri - Berljiva lokacija datoteke na tej napravi, ki jo vrne vaš izbirnik ali drug vtičnik.
display_nametext · Privzeto: ""- Primer vrednosti
report-photo.jpg - Primer Bubble izraza
Selected Attachment's display_name - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
mime_typetext · Privzeto: ""- Primer vrednosti
image/jpeg - Primer Bubble izraza
Photo Editor's output_mime - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
document_contexttext · Privzeto: "default"- Primer vrednosti
<current-user-id> - Primer Bubble izraza
Current User's unique id - Stabilna vrednost za ta račun ali zapis. Uporabite isto vrednost pri obnovi njegovih shranjenih datotek ali osnutkov.
selected_file_idtext · Privzeto: ""- Primer vrednosti
<returned saved file ID> - Primer Bubble izraza
Selected LocalAttachment's local_file_id - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
accepted_mime_types_jsontext · Privzeto: "[\"*/*\"]"- Primer vrednosti
["image/*","application/pdf"] - Primer Bubble izraza
Report Settings' accepted_mime_types_json - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
multipleyes_no · Privzeto: false- Primer vrednosti
yes - Primer Bubble izraza
Report Settings' allow_multiple_attachments - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
copy_to_cacheyes_no · Privzeto: true- Primer vrednosti
yes - Primer Bubble izraza
Report Settings' copy_to_cache - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
max_filesnumber · Privzeto: 20- Primer vrednosti
5 - Primer Bubble izraza
Report Settings' attachment_limit - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
max_file_bytesnumber · Privzeto: 268435456- Primer vrednosti
10485760 - Primer Bubble izraza
Report Settings' max_attachment_bytes - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
is_activeyes_no · Privzeto: true- Primer vrednosti
yes - Primer Bubble izraza
GuideHost's view_is_active (your yes/no custom state) - Nastavi da, ko je ta pogled odprt. Nastavi ne, ko zapuščate, da se predvajanje ali trenutno delo lahko ustavi.
disabledyes_no · Privzeto: false- Primer vrednosti
no - Primer Bubble izraza
GuideHost's is_busy (your yes/no custom state) - Onemogoči element, ko je vaša aplikacija zasedena ali ko je to dejanje nedostopno.
show_controlsyes_no · Privzeto: true- Primer vrednosti
yes - Primer Bubble izraza
App Settings' show_editor_controls - Prikaži ali skrij vgrajene kontrole.
languagetext · Privzeto: "auto"- Primer vrednosti
uk - Primer Bubble izraza
Current User's preferred_language - Nastavite language=auto, da sledi podprti napravi ali jeziku brskalnika. Vnesite podprto kodo jezika, da ga izberete izrecno.
ui_text_jsontext · Privzeto: ""- Primer vrednosti
{} - Primer Bubble izraza
App Settings' player_labels_json (supported keys only) - Izbirni JSON s podprtimi oznakami gumbov. Pustite prazno za uporabo vgrajenega besedila.
titletext · Privzeto: ""- Primer vrednosti
Lesson 4 — review - Primer Bubble izraza
Selected Lesson's name - Vidno besedilo aplikacije; prazno uporablja vgrajeno lokalizirano kopijo, kjer je podprto. Brez poverilnic.
Dejanja in njihovi vnosi · 10
Pick files
Ni parametrov dejanja
Load local source
source_uritext · Privzeto: —- Primer vrednosti
file:///app-cache/report.pdf - Primer Bubble izraza
Photo Editor's output_uri - Berljiva lokacija datoteke na tej napravi, ki jo vrne vaš izbirnik ali drug vtičnik.
display_nametext · Privzeto: —- Primer vrednosti
report-photo.jpg - Primer Bubble izraza
Selected Attachment's display_name - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
mime_typetext · Privzeto: —- Primer vrednosti
image/jpeg - Primer Bubble izraza
Photo Editor's output_mime - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Select picked file
indexnumber · Privzeto: —- Primer vrednosti
0 - Primer Bubble izraza
Selected row's current_source_index - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Save selection locally
Ni parametrov dejanja
List saved files
Ni parametrov dejanja
Restore saved file
file_idtext · Privzeto: —- Primer vrednosti
<returned saved file ID> - Primer Bubble izraza
Selected LocalAttachment's local_file_id - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Delete saved copy
file_idtext · Privzeto: —- Primer vrednosti
<returned saved file ID> - Primer Bubble izraza
Selected LocalAttachment's local_file_id - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
confirmyes_no · Privzeto: —- Primer vrednosti
yes — explicit confirmation only - Primer Bubble izraza
Confirm Checkbox is checked - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Share selected file
dialog_titletext · Privzeto: —- Primer vrednosti
Share attachment - Primer Bubble izraza
Selected Report's share_title - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
utitext · Privzeto: —- Primer vrednosti
"" - Primer Bubble izraza
Empty unless your iOS integration supplies a proven UTI - Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
Cancel operation
Ni parametrov dejanja
Clear session
Ni parametrov dejanja
Stanja in dogodki
Stanja
status · textTrenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.
is_busy · yes_noDelo je še v teku. Počakajte, preden začnete drugo dejanje.
native_pending · yes_noDelo je še v teku. Počakajte, preden začnete drugo dejanje.
operation · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
selection_count · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
selected_index · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
file_id · textIdentifikator za ta element ali dejanje. Obdržite ga z ustreznim zapisom aplikacije. Uporabite isti identifikator zahteve pri ponovnem poskusu nejasnega rezultata.
local_uri · textLokacija datoteke na tej napravi. Shranite ali naložite datoteko ločeno, če jo je treba obdržati na spletu.
display_name · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
mime_type · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
mime_source · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
size_bytes · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
is_saved_locally · yes_noTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
file_ids · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
file_uris · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
file_names · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
file_mime_types · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
file_sizes · number (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
files_json · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
saved_count · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
saved_file_ids · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
saved_file_uris · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
saved_file_names · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
saved_file_mime_types · text (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
saved_file_sizes · number (seznam)Seznam izbranih datotek. Elementi na istem indeksu v drugih seznamih datotek se nanašajo na isto datoteko.
saved_files_json · textTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
invalid_saved_count · numberTrenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.
share_status · textTrenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha.
error_code · textPodatki o napaki za zadnje dejanje. Prikažite koristno sporočilo in ponudite ustrezen ponovni poskus.
Dogodki
selection_changedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
files_savedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
list_loadedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
file_restoredKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
file_deletedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
share_sheet_closedKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
operation_cancelledKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
files_errorKo se ta dogodek zgodi, preberite povezane stanje iz istega elementa.
Vprašanja, ki jih postavljajo razvijalci
Ali Share pomeni “poslano”?
Ne. OS tukaj ne zagotavlja zanesljivega potrditvenega sporočila o uspehu prejemnika. Prikažite “share sheet closed”.
Kako deluje naročnina?
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.
Povezani vodniki
Za pomoč nam povejte, kateri vtičnik in napravo uporabljate, kakšno dejanje ste poskusili in kaj se je zgodilo. Uporabite primer brez osebnih podatkov. Nikoli ne delite svojega ključa ali zasebnih datotek.