Offline Files-interfaco.
Offline Files-interfaco.
← Ĉiuj gvidiloj pri Bubble Native

Xodera Plugins · Bubble Native

Xodera Offline Files Native

Konservu raportajn aldonaĵojn kaj elektitajn dosierojn sur la aparato, restaŭru ilin poste kaj permesu al la uzanto kunhavigi elektitan kopion.

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.

Dokumentado reviziita 6 novembro 2026

Praktikaj ekzemploj

Preparu plurajn lokajn aldonaĵojn antaŭ ol submeti raporton

Formularo devas montri kiuj dosieroj estis elektitaj kaj permesi al la uzanto teni administritan kopion antaŭ iu ajna nuba sendo.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; agordi `max_files`, `max_file_bytes` kaj konto/raporto `document_context`.

Pick files → inspekti la elektitajn nomojn/grandojn → Save selection locally. Via formularo tenas la rezultajn dosier‑ID‑ojn ĝis ĝia aparta Sendi‑laborfluo alŝutas aprobitajn dosierojn.

Uzu `selection_count`, `file_names`, `file_sizes` kaj `saved_file_ids` por montri la revudan liston. Konservita administrita kopio konservas la originalon de la vokanto.

Nuligita elektilo ne estas submetita raporto. Sur `files_error`, retenu jam akceptitajn lokajn ID‑ojn kaj montru `error_code`; neniam kreu nuban aldonaĵon el loka URI sola.

Dosieroj restas sur ĉi tiu aparato ĝis ili estas dividitaj aŭ alŝutitaj aparte.

Konservu fotoredaktilan aŭ registrilan eliron por posta uzo

Generita loka dosiero povas troviĝi en provizora loko; la aplikaĵo bezonas eksplicitan administritan kopion.

`source_uri = the local output of a separately accepted editor/recorder`; ligu ĝiajn verajn `display_name` kaj `mime_type`; uzu la `document_context` de la sama posedanto.

Load local source → inspekti metadatenojn → Save selection locally. Konservu la revenitan dosier‑ID‑on nur en la kongrua aparato/kunteksto, poste Restore saved file per tiu ekzakta ID kiam necesas.

Uzu `file_id`, `local_uri`, `size_bytes` kaj `is_saved_locally`; uzu `file_restored` por distingi kompletan restaŭron de nur peto.

Rifuzi foran HTTP‑URL‑on kiel lokan fonton. Se fonto malaperis aŭ restaŭro malsukcesas, montru `error_code` kaj konservu la originan aplikaĵan registron por restaŭro.

Dosieroj restas sur ĉi tiu aparato ĝis ili estas dividitaj aŭ alŝutitaj aparte.

Permesu al uzanto dividi lokan kvitancon aŭ eksporton generitan de la aplikaĵo

La aplikaĵo devus transdoni elektitan lokan dosieron al la aparata kunhaviga folio anstataŭ inventi publikan URL‑on.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; ĝia nomo kaj MIME priskribas la realan lokan dosieron.

List saved files → Restore saved file → Share selected file post kiam la uzanto alklakas Dividi. Konservu la konservitan kopion ĝis ili eksplicite elektas Delete saved copy.

Uzu `share_status` kaj `share_sheet_closed` por ĝisdatigi la UI post kiam la folio fermiĝas. Retenu la dosier‑ID‑on por alia intenca divido.

Fermita kunhaviga folio ne pruvas ke retpoŝto/messaĝo estis liverita. Traktu nuligon kaj `files_error` sen raporti sukceson al la ricevanto.

Dosieroj restas sur ĉi tiu aparato ĝis ili estas dividitaj aŭ alŝutitaj aparte.

Kio funkcias nun

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.

Kreu la laborfluon

Uzu la disponeblajn beta-agojn sube kaj testu la rezulton sur viaj cela aparatoj.

Ĉi tiuj ekzemploj uzas aplikaĵajn rekordojn kiel Lesson, Message kaj Order. Anstataŭigu ilin per viaj propraj datumtipoj kaj elementnomoj. Ekzemplaj aŭdvida adresoj devas esti anstataŭigitaj per viaj propraj dosieroj.

  1. Agordu document_context = Current User's unique id, aŭ stabilan valoron por la konto kaj raporto. Elektu accepted_mime_types_json, max_files kaj max_file_bytes.

  2. Rulu Pick files, aŭ uzu Load local source por legebla dosiero kreita de Foto-Redaktilo aŭ Registrilo. Post selection_changed, legu la kongruajn dosierlistojn; Select picked file elektas indekson.

  3. Rulu Save selection locally. Post files_saved, retenu saved_file_ids en la loka aldonaĵa registro de via aplikaĵo. List saved files montras konservitajn kopiojn; Restore saved file malfermas la elektitan konservitan ID.

  4. Share selected file malfermas la sisteman kunhavigan menuon. share_sheet_closed nur signifas ke la menuo fermiĝis. Delete saved copy bezonas la elektitan ID kaj confirm=yes.

Laborflua diagramo — ne aplikaĵa ekrankopio

Agordu unufoje

Kreu aŭ elektu vian Bubble-aplikaĵan projekton en BestPlugins → Dashboard → Plugins. Elektu Xodera Offline Files Native, kopiu ĝian ŝlosilon, poste malfermu Bubble → Plugins → Xodera Offline Files Native kaj algluu ĝin en licensing_api_key. Konservu unufoje; poste uzu la subajn agojn. Ĉiu kromaĵo en ĉiu projekto havas sian propran ŝlosilon.

Uzu aplikaĵon konstruitan per Bubble Native kun aliro al la elektitaj dosieroj. Agordu stabilan document_context por la konto aŭ raporto, por ke ĝiaj konservitaj dosieroj restu ĝuste grupigitaj.

Agordu unufoje
  1. Kreu aŭ elektu vian Bubble-aplikaĵan projekton ĉe BestPlugins → Dashboard → Plugins.
  2. Elektu ĉi tiun kromaĵon kaj kopiu ĝian projektan ŝlosilon.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Aldonu la elementon, elektu viajn aplikaĵajn datumojn kaj konstruu la suban laborfluon.
  5. 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.
Instalado kaj abono

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.

Konservu la rezulton en via aplikaĵo

Ekzemplo LocalAttachment: owner, document_context, ID de la konservita dosiero, display_name, mime_type kaj size_bytes. Ĉi tiu ID funkcias nur sur la sama aparato kaj por la sama konto aŭ raporto. Por reta aldonaĵo, alŝutu la dosieron per aparta laborfluo kaj konservu la ricevitan retan dosierreferencon.

Malsukceso, nuligo kaj restaŭro

Nuligita elektilo redonas operation_cancelled; ĝi ne submetas la formularon. Dum native_pending=yes, atendu ke la dosier-elektilo aŭ kunhaviga menuo fermiĝu antaŭ ol malfermi alian. Clear session forigas la aktualan elekton sed tenas konservitajn kopiojn. Se dosiero mankas, permesu al la uzanto elekti ĝin denove.

Kapabloj kaj limoj

Elektu 1–20 dosierojn samtempe. Limigo por ĉiu dosiero: 1 bajto–256 MiB, kun pli malalta limo se vi elektas. Dosiertipaj filtriloj ne kontrolas dosierojn kontraŭ virusoj. Aparataj dosier-ID-oj kaj vojoj ne funkcias kiel nuba elŝutligiloj. Lokaj kopioj ne estas ĉifritaj kaj povas perdiĝi se aplikaĵaj datumoj estas forigitaj.

Agordoj, agoj kaj rezultoj

Uzu ĉi tiujn nomojn en Bubble. Planitaj funkcioj estas markitaj aparte.

Disponeblaj beta-agordoj

Elementaj agordoj

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 · text

Statoj

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 (listo)file_uris · text (listo)file_names · text (listo)file_mime_types · text (listo)file_sizes · number (listo)files_json · textsaved_count · numbersaved_file_ids · text (listo)saved_file_uris · text (listo)saved_file_names · text (listo)saved_file_mime_types · text (listo)saved_file_sizes · number (listo)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · text

Eventoj

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Agoj kaj iliaj enigoj

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
Elementaj agordoj · 16
source_uritext · Defaŭlto: ""
Ekzempla valorofile:///app-cache/report.pdf
Ekzemplo Bubble esprimoPhoto Editor's output_uri
Legebla dosierloko sur ĉi tiu aparato, revenita de via elektilo aŭ alia kromaĵo.
display_nametext · Defaŭlto: ""
Ekzempla valororeport-photo.jpg
Ekzemplo Bubble esprimoSelected Attachment's display_name
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
mime_typetext · Defaŭlto: ""
Ekzempla valoroimage/jpeg
Ekzemplo Bubble esprimoPhoto Editor's output_mime
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
document_contexttext · Defaŭlto: "default"
Ekzempla valoro<current-user-id>
Ekzemplo Bubble esprimoCurrent User's unique id
Stabila valoro por ĉi tiu konto aŭ registro. Uzu la saman valoron kiam vi restarigas ĝiajn konservitajn dosierojn aŭ skizojn.
selected_file_idtext · Defaŭlto: ""
Ekzempla valoro<returned saved file ID>
Ekzemplo Bubble esprimoSelected LocalAttachment's local_file_id
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
accepted_mime_types_jsontext · Defaŭlto: "[\"*/*\"]"
Ekzempla valoro["image/*","application/pdf"]
Ekzemplo Bubble esprimoReport Settings' accepted_mime_types_json
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
multipleyes_no · Defaŭlto: false
Ekzempla valoroyes
Ekzemplo Bubble esprimoReport Settings' allow_multiple_attachments
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
copy_to_cacheyes_no · Defaŭlto: true
Ekzempla valoroyes
Ekzemplo Bubble esprimoReport Settings' copy_to_cache
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
max_filesnumber · Defaŭlto: 20
Ekzempla valoro5
Ekzemplo Bubble esprimoReport Settings' attachment_limit
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
max_file_bytesnumber · Defaŭlto: 268435456
Ekzempla valoro10485760
Ekzemplo Bubble esprimoReport Settings' max_attachment_bytes
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
is_activeyes_no · Defaŭlto: true
Ekzempla valoroyes
Ekzemplo Bubble esprimoGuideHost's view_is_active (your yes/no custom state)
Agordu jes dum ĉi tiu vido estas malfermita. Agordu ne kiam forlasas, por ke reproduktado aŭ nuna laboro povas ĉesi.
disabledyes_no · Defaŭlto: false
Ekzempla valorono
Ekzemplo Bubble esprimoGuideHost's is_busy (your yes/no custom state)
Malebligu la elementon dum via aplikaĵo estas okupata aŭ ĉi tiu ago ne disponeblas.
show_controlsyes_no · Defaŭlto: true
Ekzempla valoroyes
Ekzemplo Bubble esprimoApp Settings' show_editor_controls
Montri aŭ kaŝi la enkonstruitajn regilojn.
languagetext · Defaŭlto: "auto"
Ekzempla valorouk
Ekzemplo Bubble esprimoCurrent User's preferred_language
Agordu language=auto por sekvi subtenatan lingvon de la aparato aŭ retumilo. Enigu subtenatan lingvokodon por elekti ĝin eksplicite.
ui_text_jsontext · Defaŭlto: ""
Ekzempla valoro{}
Ekzemplo Bubble esprimoApp Settings' player_labels_json (supported keys only)
Nedeviga JSON kun subtenataj butonetiketoj. Lasu malplena por uzi la enkonstruitan tekston.
titletext · Defaŭlto: ""
Ekzempla valoroLesson 4 — review
Ekzemplo Bubble esprimoSelected Lesson's name
Videbla teksto de la aplikaĵo; malplena valoro uzas la enkonstruitan tradukitan tekston, kie tio estas subtenata. Ne enmetu akreditaĵojn.
Agoj kaj iliaj enigoj · 10
Pick files

Neniuj ago-parametroj

Load local source
source_uritext · Defaŭlto: —
Ekzempla valorofile:///app-cache/report.pdf
Ekzemplo Bubble esprimoPhoto Editor's output_uri
Legebla dosierloko sur ĉi tiu aparato, revenita de via elektilo aŭ alia kromaĵo.
display_nametext · Defaŭlto: —
Ekzempla valororeport-photo.jpg
Ekzemplo Bubble esprimoSelected Attachment's display_name
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
mime_typetext · Defaŭlto: —
Ekzempla valoroimage/jpeg
Ekzemplo Bubble esprimoPhoto Editor's output_mime
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Select picked file
indexnumber · Defaŭlto: —
Ekzempla valoro0
Ekzemplo Bubble esprimoSelected row's current_source_index
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Save selection locally

Neniuj ago-parametroj

List saved files

Neniuj ago-parametroj

Restore saved file
file_idtext · Defaŭlto: —
Ekzempla valoro<returned saved file ID>
Ekzemplo Bubble esprimoSelected LocalAttachment's local_file_id
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Delete saved copy
file_idtext · Defaŭlto: —
Ekzempla valoro<returned saved file ID>
Ekzemplo Bubble esprimoSelected LocalAttachment's local_file_id
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
confirmyes_no · Defaŭlto: —
Ekzempla valoroyes — explicit confirmation only
Ekzemplo Bubble esprimoConfirm Checkbox is checked
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Share selected file
dialog_titletext · Defaŭlto: —
Ekzempla valoroShare attachment
Ekzemplo Bubble esprimoSelected Report's share_title
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
utitext · Defaŭlto: —
Ekzempla valoro""
Ekzemplo Bubble esprimoEmpty unless your iOS integration supplies a proven UTI
Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.
Cancel operation

Neniuj ago-parametroj

Clear session

Neniuj ago-parametroj

Statoj kaj eventoj

Statoj

status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

is_busy · yes_no

Laboro ankoraŭ progresas. Atendu antaŭ ol komenci alian agon.

native_pending · yes_no

Laboro ankoraŭ progresas. Atendu antaŭ ol komenci alian agon.

operation · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

selection_count · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

selected_index · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

file_id · text

Identigilo por ĉi tiu elemento aŭ ago. Konservu ĝin kun la kongrua registro de la aplikaĵo. Uzu la saman petidentigilon kiam vi reprovas operacion kun necerta rezulto.

local_uri · text

Dosierlokado en ĉi tiu aparato. Konservu aŭ alŝutu la dosieron aparte se ĝi devas esti tenata enrete.

display_name · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

mime_type · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

mime_source · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

size_bytes · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

is_saved_locally · yes_no

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

file_ids · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

file_uris · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

file_names · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

file_mime_types · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

file_sizes · number (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

files_json · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

saved_count · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

saved_file_ids · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

saved_file_uris · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

saved_file_names · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

saved_file_mime_types · text (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

saved_file_sizes · number (listo)

Listo por la elektitaj dosieroj. Elementoj ĉe la sama indekso en la aliaj dosierlistoj referencas al la sama dosiero.

saved_files_json · text

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

invalid_saved_count · number

Nuna valoro por la elektita elemento. Legu ĝin post la rilata evento.

share_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

error_code · text

Erarinformoj por la lasta ago. Montru utilan mesaĝon kaj proponu la rilatan reprovon.

Eventoj

selection_changed

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

files_saved

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

list_loaded

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

file_restored

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

file_deleted

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

share_sheet_closed

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

operation_cancelled

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

files_error

Kiam ĉi tiu evento okazas, legu la rilatajn statojn de la sama elemento.

Demandoj, kiujn programistoj demandas

Ĉu Kunhavigi signifas “sendita”?

Ne. La operaciumo ĉi tie ne donas fidindan konfirmon, ke la ricevanto sukcese ricevis la dosieron. Montru “share sheet closed”.

Kiel funkcias la abono?

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.

Rilataj gvidiloj

Por helpo, informu nin kiun kromaĵon kaj aparaton vi uzas, la agon kiun vi provis kaj kio okazis. Uzu ekzemplon sen personaj datumoj. Neniam dividu vian ŝlosilon aŭ privatajn dosierojn.