Xodera Plugins · Bubble Native
Xodera Offline Files Native
Bevar rapportvedhæftninger og valgte filer på enheden, gendan dem senere og lad brugeren dele en valgt kopi.
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.
Dokumentation gennemgået 6 november 2026
Praktiske eksempler
Forbered flere lokale vedhæftninger inden indsendelse af en rapport
En formular skal vise, hvilke filer der blev valgt, og lade brugeren beholde en administreret kopi inden nogen cloud‑indsendelse.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; angiv `max_files`, `max_file_bytes` og en konto/rapport `document_context`.
Pick files → inspicér de valgte navne/størrelser → Save selection locally. Din formular beholder de resulterende fil‑ID’er, indtil dens separate Indsend‑arbejdsgang uploader de godkendte filer.
Brug `selection_count`, `file_names`, `file_sizes` og `saved_file_ids` til at gengive anmeldelseslisten. En gemt administreret kopi bevarer opkalderens originale.
En annulleret vælger er ikke en indsendt rapport. På `files_error` bevares allerede accepterede lokale ID'er og vises `error_code`; opret aldrig en sky‑vedhæftning kun fra en lokal URI.
Filer forbliver på denne enhed, indtil de deles eller uploades separat.
Gem output fra foto‑editor eller optager til senere brug
En genereret lokal fil kan ligge i en midlertidig placering; appen har brug for en eksplicit administreret kopi.
`source_uri = the local output of a separately accepted editor/recorder`; bind dens reelle `display_name` og `mime_type`; brug den samme ejers `document_context`.
Load local source → inspicér metadata → Save selection locally. Gem den returnerede fil‑ID kun i den tilsvarende enhed/kontekst, og udfør derefter Restore saved file med den præcise ID, når det er nødvendigt.
Forbrug `file_id`, `local_uri`, `size_bytes` og `is_saved_locally`; brug `file_restored` til at skelne en fuldført gendannelse fra blot en anmodning om en.
Afvis en fjern‑HTTP‑URL som en lokal kilde. Hvis en kilde forsvinder eller gendannelsen fejler, vis `error_code` og bevar den oprindelige app‑post til gendannelse.
Filer forbliver på denne enhed, indtil de deles eller uploades separat.
Lad en bruger dele en app‑genereret lokal kvittering eller eksport
Appen bør overlevere en valgt lokal fil til enhedens delingsark i stedet for at opfinde en offentlig URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; dens navn og MIME beskriver den reelle lokale fil.
List saved files → Restore saved file → Share selected file efter brugeren trykker på Del. Behold den gemte kopi, indtil de eksplicit vælger Delete saved copy.
Brug `share_status` og `share_sheet_closed` til at opdatere UI'en, når arket lukkes. Behold fil‑ID'en til en anden bevidst deling.
Et lukket delingsark er ikke bevis på, at en e‑mail/besked er leveret. Håndtér annullering og `files_error` uden at rapportere succes til modtageren.
Filer forbliver på denne enhed, indtil de deles eller uploades separat.
Hvad der virker nu
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.
Byg arbejdsprocessen
Brug de tilgængelige beta-handlinger nedenfor og test resultatet på dine målrettede enheder.
Denne eksempler bruger app‑poster såsom Lesson, Message og Order. Erstat dem med dine egne datatyper og elementnavne. Eksempelmedie‑adresser skal erstattes med dine egne filer.
Angiv document_context = Current User's unique id, eller en stabil værdi for kontoen og rapporten. Vælg accepted_mime_types_json, max_files og max_file_bytes.
Kør Pick files, eller brug Load local source til en læsbar fil produceret af Fotoeditor eller Optager. Efter selection_changed, læs de tilsvarende fillister; Select picked file vælger et indeks.
Kør Save selection locally. Efter files_saved, behold saved_file_ids i din apps lokale vedhæftningsregister. List saved files viser gemte kopier; Restore saved file åbner det valgte gemte ID.
Share selected file åbner systemets delingsmenu. share_sheet_closed betyder kun, at menuen lukkede. Delete saved copy kræver det valgte ID og confirm=yes.
Konfigurer én gang
Opret eller vælg dit Bubble app‑projekt i BestPlugins → Dashboard → Plugins. Vælg Xodera Offline Files Native, kopier dens nøgle, åbn derefter Bubble → Plugins → Xodera Offline Files Native og indsæt den i licensing_api_key. Gem én gang; brug derefter handlingerne nedenfor. Hvert plugin i hvert projekt har sin egen nøgle.
Brug en native app med adgang til de valgte filer. Angiv en stabil document_context for kontoen eller rapporten, så de gemte filer holdes korrekt grupperet.
Konfigurer én gang
- Opret eller vælg dit Bubble app-projekt på BestPlugins → Dashboard → Plugins.
- Vælg dette plugin og kopier dets projekt-nøgle.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Tilføj elementet, vælg dine app-data og opbyg arbejdsflowet nedenfor.
- 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.
Installation og abonnement
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.
Gem resultatet i din app
Eksempel LocalAttachment: ejer, document_context, gemt fil-ID, display_name, mime_type og size_bytes. Dette ID fungerer kun på samme enhed og for samme konto eller rapport. For en online‑vedhæftning skal du uploade filen med en separat arbejdsgang og gemme den returnerede online‑filreference.
Fejl, annullering og genoprettelse
En annulleret vælger returnerer operation_cancelled; den indsender ikke formularen. Mens native_pending=yes, vent på at filvælgeren eller delingsmenuen lukker, før du åbner en ny. Clear session rydder den aktuelle markering men bevarer gemte kopier. Hvis en fil mangler, lad brugeren vælge den igen.
Kapaciteter og begrænsninger
Vælg 1–20 filer på én gang. Per-fil grænse: 1 byte–256 MiB, med en lavere grænse hvis du ønsker det. Filtypefiltre kontrollerer ikke filer for virus. Enhedens fil‑ID’er og stier fungerer ikke som cloud‑download‑links. Lokale kopier er ikke krypteret lagring og kan gå tabt, hvis app‑data fjernes.
Indstillinger, handlinger og resultater
Brug disse navne i Bubble. Planlagte funktioner er markeret separat.
Tilgængelige beta‑indstillinger
Elementindstillinger
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 · textTilstande
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 (liste)file_uris · text (liste)file_names · text (liste)file_mime_types · text (liste)file_sizes · number (liste)files_json · textsaved_count · numbersaved_file_ids · text (liste)saved_file_uris · text (liste)saved_file_names · text (liste)saved_file_mime_types · text (liste)saved_file_sizes · number (liste)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textBegivenheder
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorHandlinger og deres input
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionElementindstillinger · 16
source_uritext · Standard: ""- Eksempelværdi
file:///app-cache/report.pdf - Eksempel Bubble udtryk
Photo Editor's output_uri - Læselig filplacering på denne enhed, returneret af din vælger eller et andet plugin.
display_nametext · Standard: ""- Eksempelværdi
report-photo.jpg - Eksempel Bubble udtryk
Selected Attachment's display_name - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
mime_typetext · Standard: ""- Eksempelværdi
image/jpeg - Eksempel Bubble udtryk
Photo Editor's output_mime - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
document_contexttext · Standard: "default"- Eksempelværdi
<current-user-id> - Eksempel Bubble udtryk
Current User's unique id - Stabil værdi for denne konto eller post. Brug den samme værdi, når du gendanner dens gemte filer eller kladder.
selected_file_idtext · Standard: ""- Eksempelværdi
<returned saved file ID> - Eksempel Bubble udtryk
Selected LocalAttachment's local_file_id - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
accepted_mime_types_jsontext · Standard: "[\"*/*\"]"- Eksempelværdi
["image/*","application/pdf"] - Eksempel Bubble udtryk
Report Settings' accepted_mime_types_json - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
multipleyes_no · Standard: false- Eksempelværdi
yes - Eksempel Bubble udtryk
Report Settings' allow_multiple_attachments - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
copy_to_cacheyes_no · Standard: true- Eksempelværdi
yes - Eksempel Bubble udtryk
Report Settings' copy_to_cache - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
max_filesnumber · Standard: 20- Eksempelværdi
5 - Eksempel Bubble udtryk
Report Settings' attachment_limit - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
max_file_bytesnumber · Standard: 268435456- Eksempelværdi
10485760 - Eksempel Bubble udtryk
Report Settings' max_attachment_bytes - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
is_activeyes_no · Standard: true- Eksempelværdi
yes - Eksempel Bubble udtryk
GuideHost's view_is_active (your yes/no custom state) - Sæt ja, mens denne visning er åben. Sæt nej ved afslutning, så afspilning eller aktuelt arbejde kan stoppe.
disabledyes_no · Standard: false- Eksempelværdi
no - Eksempel Bubble udtryk
GuideHost's is_busy (your yes/no custom state) - Deaktivér elementet, mens din app er optaget eller handlingen er utilgængelig.
show_controlsyes_no · Standard: true- Eksempelværdi
yes - Eksempel Bubble udtryk
App Settings' show_editor_controls - Vis eller skjul de indbyggede kontroller.
languagetext · Standard: "auto"- Eksempelværdi
uk - Eksempel Bubble udtryk
Current User's preferred_language - Sæt language=auto til at følge en understøttet enhed eller browsersprog. Indtast en understøttet sprogkode for at vælge den eksplicit.
ui_text_jsontext · Standard: ""- Eksempelværdi
{} - Eksempel Bubble udtryk
App Settings' player_labels_json (supported keys only) - Valgfri JSON med understøttede knapetiketter. Lad stå tomt for at bruge den indbyggede tekst.
titletext · Standard: ""- Eksempelværdi
Lesson 4 — review - Eksempel Bubble udtryk
Selected Lesson's name - Synlig app-tekst; tom bruger indbygget lokaliseret tekst, hvor den understøttes. Ingen legitimationsoplysninger.
Handlinger og deres input · 10
Pick files
Ingen handlingsparametre
Load local source
source_uritext · Standard: —- Eksempelværdi
file:///app-cache/report.pdf - Eksempel Bubble udtryk
Photo Editor's output_uri - Læselig filplacering på denne enhed, returneret af din vælger eller et andet plugin.
display_nametext · Standard: —- Eksempelværdi
report-photo.jpg - Eksempel Bubble udtryk
Selected Attachment's display_name - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
mime_typetext · Standard: —- Eksempelværdi
image/jpeg - Eksempel Bubble udtryk
Photo Editor's output_mime - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
Select picked file
indexnumber · Standard: —- Eksempelværdi
0 - Eksempel Bubble udtryk
Selected row's current_source_index - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
Save selection locally
Ingen handlingsparametre
List saved files
Ingen handlingsparametre
Restore saved file
file_idtext · Standard: —- Eksempelværdi
<returned saved file ID> - Eksempel Bubble udtryk
Selected LocalAttachment's local_file_id - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
Delete saved copy
file_idtext · Standard: —- Eksempelværdi
<returned saved file ID> - Eksempel Bubble udtryk
Selected LocalAttachment's local_file_id - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
confirmyes_no · Standard: —- Eksempelværdi
yes — explicit confirmation only - Eksempel Bubble udtryk
Confirm Checkbox is checked - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
Share selected file
dialog_titletext · Standard: —- Eksempelværdi
Share attachment - Eksempel Bubble udtryk
Selected Report's share_title - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
utitext · Standard: —- Eksempelværdi
"" - Eksempel Bubble udtryk
Empty unless your iOS integration supplies a proven UTI - Brug den aktuelle forretningspost's værdi; valider den mod grænserne nedenfor.
Cancel operation
Ingen handlingsparametre
Clear session
Ingen handlingsparametre
Tilstande og hændelser
Tilstande
status · textNuværende resultat af denne handling. Brug den tilsvarende afslutnings‑begivenhed før gemning af succes.
is_busy · yes_noArbejdet er stadig i gang. Vent, før du starter en anden handling.
native_pending · yes_noArbejdet er stadig i gang. Vent, før du starter en anden handling.
operation · textNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
selection_count · numberNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
selected_index · numberNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
file_id · textIdentifikator for dette element eller handling. Bevar den sammen med den tilsvarende app‑post. Brug den samme anmodnings‑identifikator ved gentagelse af et usikkert resultat.
local_uri · textFilplacering på denne enhed. Gem eller upload filen separat, hvis den skal holdes online.
display_name · textNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
mime_type · textNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
mime_source · textNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
size_bytes · numberNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
is_saved_locally · yes_noNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
file_ids · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
file_uris · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
file_names · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
file_mime_types · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
file_sizes · number (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
files_json · textNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
saved_count · numberNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
saved_file_ids · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
saved_file_uris · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
saved_file_names · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
saved_file_mime_types · text (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
saved_file_sizes · number (liste)En liste over de valgte filer. Elementer med samme indeks i de andre fillister refererer til den samme fil.
saved_files_json · textNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
invalid_saved_count · numberNuværende værdi for det valgte element. Læs den efter den relaterede begivenhed.
share_status · textNuværende resultat af denne handling. Brug den tilsvarende afslutnings‑begivenhed før gemning af succes.
error_code · textFejlinformation for den sidste handling. Vis en hjælpsom besked og tilbyd den relevante genforsøg.
Begivenheder
selection_changedNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
files_savedNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
list_loadedNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
file_restoredNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
file_deletedNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
share_sheet_closedNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
operation_cancelledNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
files_errorNår denne hændelse indtræffer, læs de relaterede tilstande fra det samme element.
Spørgsmål udviklere stiller
Betyder Deling “sendt”?
Nej. OS’en giver ikke en pålidelig kvittering for modtagerens succes her. Vis “share sheet closed”.
Hvordan fungerer abonnementet?
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.
Relaterede vejledninger
For hjælp, fortæl os, hvilket plugin og hvilken enhed du bruger, hvilken handling du forsøgte, og hvad der skete. Brug et eksempel uden personlige data. Del aldrig din nøgle eller private filer.