Xodera Plugins · Bubble Native
Xodera Offline Files Native
Laikykite ataskaitos priedus ir pasirinktus failus įrenginyje, vėliau juos atkurkite ir leiskite vartotojui bendrinti pasirinktą kopiją.
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 peržiūrėta 6 lapkričio 2026
Praktiniai pavyzdžiai
Paruoškite kelis vietinius priedus prieš pateikiant ataskaitą
Forma turi rodyti, kurie failai buvo pasirinkti, ir leisti vartotojui išlaikyti tvarkomą kopiją prieš bet kokį debesies pateikimą.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; nustatykite `max_files`, `max_file_bytes` ir paskyros/ataskaitos `document_context`.
Pick files → peržiūrėkite pasirinktus pavadinimus/dydžius → Save selection locally. Jūsų forma išsaugo gautus failų ID, kol atskiras pateikimo darbo srautas įkelia patvirtintus failus.
Naudokite `selection_count`, `file_names`, `file_sizes` ir `saved_file_ids` peržiūros sąrašo atvaizdavimui. Išsaugota valdomoji kopija išsaugo skambintojo originalą.
Atšauktas parinkiklis nėra pateikta ataskaita. `files_error`, išsaugokite jau priimtus vietinius ID ir rodykite `error_code`; niekada nesukurkite debesies priedo tik iš vietinio URI.
Failai lieka šiame įrenginyje, kol nebus bendrinami arba įkelti atskirai.
Laikykite foto redaktoriaus arba įrašymo išvestį vėlesniam naudojimui.
Sugeneruotas vietinis failas gali būti laikinas vietoje; programai reikia aiškios valdomos kopijos.
`source_uri = the local output of a separately accepted editor/recorder`; susiekite jo realų `display_name` ir `mime_type`; naudokite tą patį savininko `document_context`.
Load local source → peržiūrėkite metaduomenis → Save selection locally. Išsaugokite grąžintą failo ID tik atitinkamame įrenginyje/kontekste, tada Restore saved file pagal tą tikslų ID, kai reikia.
Naudokite `file_id`, `local_uri`, `size_bytes` ir `is_saved_locally`; naudokite `file_restored`, kad atskirtumėte baigtą atkūrimą nuo tik užklausimo.
Atmesti nuotolinį HTTP URL kaip vietinį šaltinį. Jei šaltinis dingo arba atkūrimas nepavyko, rodyti `error_code` ir išsaugoti originalų programos įrašą atkūrimui.
Failai lieka šiame įrenginyje, kol nebus bendrinami arba įkelti atskirai.
Leiskite vartotojui bendrinti programos sukurtą vietinį kvitą arba eksportą.
Programai turėtų perduoti pasirinktą vietinį failą įrenginio bendrinimo lapui, o ne kurti viešą URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; jo pavadinimas ir MIME aprašo tikrąjį vietinį failą.
List saved files → Restore saved file → Share selected file po to, kai naudotojas paspaudžia Dalinti. Laikykite išsaugotą kopiją, kol jie aiškiai nepasirenka Delete saved copy.
Naudokite `share_status` ir `share_sheet_closed`, kad atnaujintumėte naudotojo sąsają po lapo uždarymo. Išsaugokite failo ID kitam tyčiamui bendrinimui.
Uždarytas bendrinimo lapas nėra įrodymas, kad el. laiškas/žinutė buvo pristatyta. Tvarkykite atšaukimą ir `files_error` neinformuodami gavėjo apie sėkmę.
Failai lieka šiame įrenginyje, kol nebus bendrinami arba įkelti atskirai.
Kas veikia dabar
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.
Sukurkite darbo srautą
Naudokite žemiau pateiktas prieinamas beta veiksmus ir išbandykite rezultatą savo tiksliniuose įrenginiuose.
Šie pavyzdžiai naudoja programos įrašus, tokius kaip Lesson, Message ir Order. Pakeiskite juos savo duomenų tipais ir elementų pavadinimais. Pavyzdiniai medijos adresai turi būti pakeisti jūsų failais.
Nustatykite document_context = Current User's unique id arba stabilų reikšmę paskyrai ir ataskaitai. Pasirinkite accepted_mime_types_json, max_files ir max_file_bytes.
Paleiskite Pick files arba naudokite Load local source skaitomam failui, sukurtam Foto redaktoriaus arba Įrašymo programos. Po selection_changed perskaitykite atitinkamus failų sąrašus; Select picked file pasirenka indeksą.
Paleiskite Save selection locally. Po files_saved, saugokite saved_file_ids savo programos vietiniame priedų registre. List saved files rodo išsaugotas kopijas; Restore saved file atveria pasirinktą išsaugotą ID.
Share selected file atveria sistemos bendrinimo meniu. share_sheet_closed reiškia tik, kad meniu užsidarė. Delete saved copy reikia pasirinkto ID ir confirm=yes.
Konfigūruokite vieną kartą
Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins. Pasirinkite Xodera Offline Files Native, nukopijuokite jo raktą, tada atidarykite Bubble → Plugins → Xodera Offline Files Native ir įklijuokite jį į licensing_api_key. Išsaugokite vieną kartą; tada naudokite žemiau esančius veiksmus. Kiekvienas įskiepis kiekviename projekte turi savo raktą.
Naudokite savąją programėlę, turinčią prieigą prie pasirinktų failų. Paskyrai arba ataskaitai nustatykite stabilų document_context, kad jos išsaugoti failai būtų tinkamai sugrupuoti.
Konfigūruokite vieną kartą
- Sukurkite arba pasirinkite savo Bubble programos projektą BestPlugins → Dashboard → Plugins.
- Pasirinkite šį įskiepį ir nukopijuokite jo projekto raktą.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Pridėkite elementą, pasirinkite savo programos duomenis ir sukurkite žemiau esantį darbo srautą.
- 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.
Įdiegimas ir prenumerata
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.
Išsaugokite rezultatą savo programoje
Pavyzdys LocalAttachment: savininkas, document_context, išsaugoto failo ID, display_name, mime_type ir size_bytes. Šis ID veikia tik tame pačiame įrenginyje ir toje pačioje paskyroje arba ataskaitoje. Internetiniam priedui įkelkite failą atskiru darbo srautu ir išsaugokite grąžintą internetinį failo nuorodą.
Gedimas, atšaukimas ir atkūrimas
Atšauktas parinkiklis grąžina operation_cancelled; jis nepateikia formos. Kol native_pending=yes, laukite, kol failų parinkiklis arba bendrinimo meniu užsidarys, prieš atveriant kitą. Clear session išvalo dabartinį pasirinkimą, bet išsaugo išsaugotas kopijas. Jei failas trūksta, leiskite vartotojui jį pasirinkti iš naujo.
Galimybės ir apribojimai
Pasirinkite 1–20 failus vienu metu. Vieno failo riba: 1 baitų–256 MiB, su mažesne riba, jei pasirinksite. Failų tipų filtrai nepatikrina failų dėl virusų. Įrenginio failų ID ir keliai neveikia kaip debesies atsisiuntimo nuorodos. Vietinės kopijos nėra šifruota saugykla ir gali būti prarastos, jei programos duomenys pašalinami.
Nustatymai, veiksmai ir rezultatai
Naudokite šiuos pavadinimus Bubble. Planuojamos funkcijos pažymėtos atskirai.
Prieinami beta nustatymai
Elemento nustatymai
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 · textBūsenos
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 (sąrašas)file_uris · text (sąrašas)file_names · text (sąrašas)file_mime_types · text (sąrašas)file_sizes · number (sąrašas)files_json · textsaved_count · numbersaved_file_ids · text (sąrašas)saved_file_uris · text (sąrašas)saved_file_names · text (sąrašas)saved_file_mime_types · text (sąrašas)saved_file_sizes · number (sąrašas)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textĮvykiai
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorVeiksmai ir jų įvestys
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionElemento nustatymai · 16
source_uritext · Numatytasis: ""- Pavyzdinė reikšmė
file:///app-cache/report.pdf - Pavyzdinis Bubble išraiška
Photo Editor's output_uri - Skaitoma failo vieta šiame įrenginyje, grąžinta jūsų parinkiklio arba kito įskiepio.
display_nametext · Numatytasis: ""- Pavyzdinė reikšmė
report-photo.jpg - Pavyzdinis Bubble išraiška
Selected Attachment's display_name - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
mime_typetext · Numatytasis: ""- Pavyzdinė reikšmė
image/jpeg - Pavyzdinis Bubble išraiška
Photo Editor's output_mime - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
document_contexttext · Numatytasis: "default"- Pavyzdinė reikšmė
<current-user-id> - Pavyzdinis Bubble išraiška
Current User's unique id - Stabili vertė šiai paskyrai arba įrašui. Naudokite tą pačią vertę atkurdami išsaugotus failus arba juodraščius.
selected_file_idtext · Numatytasis: ""- Pavyzdinė reikšmė
<returned saved file ID> - Pavyzdinis Bubble išraiška
Selected LocalAttachment's local_file_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
accepted_mime_types_jsontext · Numatytasis: "[\"*/*\"]"- Pavyzdinė reikšmė
["image/*","application/pdf"] - Pavyzdinis Bubble išraiška
Report Settings' accepted_mime_types_json - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
multipleyes_no · Numatytasis: false- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
Report Settings' allow_multiple_attachments - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
copy_to_cacheyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
Report Settings' copy_to_cache - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
max_filesnumber · Numatytasis: 20- Pavyzdinė reikšmė
5 - Pavyzdinis Bubble išraiška
Report Settings' attachment_limit - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
max_file_bytesnumber · Numatytasis: 268435456- Pavyzdinė reikšmė
10485760 - Pavyzdinis Bubble išraiška
Report Settings' max_attachment_bytes - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
is_activeyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
GuideHost's view_is_active (your yes/no custom state) - Nustatykite taip, kai šis vaizdas atvertas. Nustatykite ne, kai išeinate, kad atkūrimas arba dabartinis darbas galėtų sustoti.
disabledyes_no · Numatytasis: false- Pavyzdinė reikšmė
no - Pavyzdinis Bubble išraiška
GuideHost's is_busy (your yes/no custom state) - Išjunkite elementą, kai programa užimta arba šis veiksmas neprieinamas.
show_controlsyes_no · Numatytasis: true- Pavyzdinė reikšmė
yes - Pavyzdinis Bubble išraiška
App Settings' show_editor_controls - Rodyti arba slėpti įmontuotas valdikles.
languagetext · Numatytasis: "auto"- Pavyzdinė reikšmė
uk - Pavyzdinis Bubble išraiška
Current User's preferred_language - Nustatykite language=auto sekti palaikomą įrenginį arba naršyklės kalbą. Įveskite palaikomą kalbos kodą, kad pasirinktumėte ją tiesiogiai.
ui_text_jsontext · Numatytasis: ""- Pavyzdinė reikšmė
{} - Pavyzdinis Bubble išraiška
App Settings' player_labels_json (supported keys only) - Pasirenkamas JSON su palaikomais mygtukų etiketėmis. Palikite tuščią, kad naudotumėte įdiegtą tekstą.
titletext · Numatytasis: ""- Pavyzdinė reikšmė
Lesson 4 — review - Pavyzdinis Bubble išraiška
Selected Lesson's name - Matomas programos tekstas; jei tuščias, naudojama įdiegta lokalizuota kopija, kur palaikoma. Nėra kredencialų.
Veiksmai ir jų įvestys · 10
Pick files
Nėra veiksmų parametrų
Load local source
source_uritext · Numatytasis: —- Pavyzdinė reikšmė
file:///app-cache/report.pdf - Pavyzdinis Bubble išraiška
Photo Editor's output_uri - Skaitoma failo vieta šiame įrenginyje, grąžinta jūsų parinkiklio arba kito įskiepio.
display_nametext · Numatytasis: —- Pavyzdinė reikšmė
report-photo.jpg - Pavyzdinis Bubble išraiška
Selected Attachment's display_name - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
mime_typetext · Numatytasis: —- Pavyzdinė reikšmė
image/jpeg - Pavyzdinis Bubble išraiška
Photo Editor's output_mime - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Select picked file
indexnumber · Numatytasis: —- Pavyzdinė reikšmė
0 - Pavyzdinis Bubble išraiška
Selected row's current_source_index - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Save selection locally
Nėra veiksmų parametrų
List saved files
Nėra veiksmų parametrų
Restore saved file
file_idtext · Numatytasis: —- Pavyzdinė reikšmė
<returned saved file ID> - Pavyzdinis Bubble išraiška
Selected LocalAttachment's local_file_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Delete saved copy
file_idtext · Numatytasis: —- Pavyzdinė reikšmė
<returned saved file ID> - Pavyzdinis Bubble išraiška
Selected LocalAttachment's local_file_id - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
confirmyes_no · Numatytasis: —- Pavyzdinė reikšmė
yes — explicit confirmation only - Pavyzdinis Bubble išraiška
Confirm Checkbox is checked - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Share selected file
dialog_titletext · Numatytasis: —- Pavyzdinė reikšmė
Share attachment - Pavyzdinis Bubble išraiška
Selected Report's share_title - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
utitext · Numatytasis: —- Pavyzdinė reikšmė
"" - Pavyzdinis Bubble išraiška
Empty unless your iOS integration supplies a proven UTI - Naudokite dabartinio verslo įrašo reikšmę; patikrinkite ją pagal žemiau pateiktas ribas.
Cancel operation
Nėra veiksmų parametrų
Clear session
Nėra veiksmų parametrų
Būsenos ir įvykiai
Būsenos
status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
is_busy · yes_noDarbas vis dar vykdomas. Palaukite prieš pradėdami kitą veiksmą.
native_pending · yes_noDarbas vis dar vykdomas. Palaukite prieš pradėdami kitą veiksmą.
operation · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
selection_count · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
selected_index · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
file_id · textIdentifikatorius šiam elementui arba veiksmui. Laikykite jį kartu su atitinkamu programos įrašu. Naudokite tą patį užklausos identifikatorių, kai kartojate neaiškų rezultatą.
local_uri · textFailo vieta šiame įrenginyje. Išsaugokite arba įkelkite failą atskirai, jei jis turi būti laikomas internete.
display_name · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
mime_type · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
mime_source · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
size_bytes · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
is_saved_locally · yes_noDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
file_ids · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
file_uris · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
file_names · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
file_mime_types · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
file_sizes · number (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
files_json · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
saved_count · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
saved_file_ids · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
saved_file_uris · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
saved_file_names · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
saved_file_mime_types · text (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
saved_file_sizes · number (sąrašas)Sąrašas pasirinktiems failams. Elementai toje pačioje pozicijoje kituose failų sąrašuose nurodo tą patį failą.
saved_files_json · textDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
invalid_saved_count · numberDabartinė pasirinkto elemento reikšmė. Perskaitykite ją po susijusio įvykio.
share_status · textDabartinis šio veiksmo rezultatas. Naudokite atitinkamą užbaigimo įvykį prieš išsaugant sėkmę.
error_code · textPaskutinio veiksmo klaidos informacija. Rodykite naudingą pranešimą ir pasiūlykite atitinkamą pakartojimą.
Įvykiai
selection_changedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
files_savedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
list_loadedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
file_restoredKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
file_deletedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
share_sheet_closedKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
operation_cancelledKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
files_errorKai įvyksta šis įvykis, perskaitykite susijusias būsenas iš to paties elemento.
Klausimai, kuriuos užduoda kūrėjai
Ar „Share“ reiškia „išsiųsta“?
Ne. OS čia nepateikia patikimo gavėjo sėkmės patvirtinimo. Rodyti „share sheet closed“.
Kaip veikia prenumerata?
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.
Susijusios gairės
Pagalbos prašym, nurodykite, kurį papildinį ir įrenginį naudojate, kokį veiksmą bandėte ir kas įvyko. Naudokite pavyzdį be asmeninių duomenų. Niekada nesidalinkite savo raktu ar privačiais failais.