Offline Files viðmót.
Offline Files viðmót.
← Allar leiðbeiningar fyrir native-viðbætur

Xodera Plugins · Bubble Native

Xodera Offline Files Native

Geymdu viðhengi skýrslna og valdar skrár á tækinu, endurheimtu þau síðar og leyfðu notandanum að deila völdu afriti.

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.

Skjölun yfirfarin 6 nóvember 2026

Hagnýt dæmi

Undirbúðu nokkur staðvær viðhengi áður en skýrsla er send inn

Eyðublað þarf að sýna hvaða skrár voru valdar og láta notandann halda stjórnað afriti áður en skýjuupphleðsla fer fram.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; stilltu `max_files`, `max_file_bytes` og reikning/skýrslu `document_context`.

Pick files → skoða valdar nöfn/stærðir → Save selection locally. Eyðublaðið þitt heldur niðurstöðuskráa-ID-um þar til sjálfstætt innsendingarferli hleður upp samþykktum skrám.

Notaðu `selection_count`, `file_names`, `file_sizes` og `saved_file_ids` til að birta lista yfir skrár til yfirferðar. Vistun á stýrðu afriti breytir ekki upprunalegu skránni sem kallandi kóði lagði til.

Hætt við val er ekki skilað skýrsla. Á `files_error`, haltu nú þegar samþykktum staðbundnum auðkennum og sýndu `error_code`; aldrei búa til viðhengi í skýinu út frá staðbundnu URI einu saman.

Skrár eru á þessu tæki þar til þær eru deilt eða hlaðið upp sérstaklega.

Geymdu úttak úr ljósmyndavinnsluforriti eða upptökutæki til síðar notkunar

Útbúin staðbundin skrá getur verið í bráðabirgðastað; forritið þarf skýrt stjórnað afrit.

`source_uri = the local output of a separately accepted editor/recorder`; tengdu raunverulega `display_name` og `mime_type`; notaðu sama eiganda’s `document_context`.

Load local source → skoða lýsigögn → Save selection locally. Vistaðu skilaða skráarauðkennið aðeins í samsvarandi tæki/samhengi, síðan Restore saved file með því nákvæma auðkenni þegar þörf er.

Notaðu `file_id`, `local_uri`, `size_bytes` og `is_saved_locally`; notaðu `file_restored` til að greina fullunna endurheimt frá því að bara biðja um hana.

Hafnaðu fjarlægum HTTP URL sem staðbundnum uppruna. Ef uppruni hverfur eða endurheimt mistókst, sýndu `error_code` og varðveittu upprunalega færslu forritsins til endurheimt.

Skrár eru á þessu tæki þar til þær eru deilt eða hlaðið upp sérstaklega.

Leyfðu notanda að deila staðbundnu kvittun eða útflutningi sem forritið býr til

Forritið á að afhenda valda staðbundna skrá til deilingarvalmyndar tækisins í stað þess að búa til opinbera URL-slóð.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; nafnið þess og MIME lýsa raunverulegri staðbundinni skrá.

List saved files → Restore saved file → Share selected file eftir að notandi smelltir á Deila. Geymdu vistaða afritið þar til hann velur skýrt Delete saved copy.

Notaðu `share_status` og `share_sheet_closed` til að uppfæra viðmótið eftir að blaðið lokar. Halda skráarauðkenni til annars meðvitaðs deilingar.

Lokuð deilingarvalmynd er ekki sönnun þess að tölvupóstur eða skilaboð hafi borist viðtakanda. Meðhöndlaðu afturköllun og `files_error` án þess að segja að afhending til viðtakanda hafi tekist.

Skrár eru á þessu tæki þar til þær eru deilt eða hlaðið upp sérstaklega.

Hvað virkar núna

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.

Búðu til vinnuflæðið

Notaðu tiltækar beta-aðgerðir hér að neðan og prófaðu niðurstöðuna á marktækjunum þínum.

Þessi dæmi nota gagnaskrár forritsins, svo sem Lesson, Message og Order. Skiptu þeim út fyrir þínar eigin gagnategundir og nöfn viðmótsþátta. Skiptu slóðum að dæmismiðlum út fyrir slóðir að þínum eigin skrám.

  1. Stilltu document_context = Current User's unique id, eða stöðugt gildi fyrir reikninginn og skýrsluna. Veldu accepted_mime_types_json, max_files og max_file_bytes.

  2. Keyrðu Pick files, eða notaðu Load local source fyrir lesanlega skrá sem myndvinnsluforrit eða upptökuforrit bjó til. Eftir selection_changed, lestu samsvarandi skráalista; Select picked file velur vísitölu.

  3. Keyrðu Save selection locally. Eftir files_saved, haltu saved_file_ids í staðbundnu viðhengjaskrá forritsins. List saved files sýnir vistuð afrit; Restore saved file opnar valda vistuðu ID.

  4. Share selected file opnar kerfisdeilingarvalmynd. share_sheet_closed þýðir aðeins að valmyndin lokaðist. Delete saved copy þarf valda ID og confirm=yes.

Vinnuflæðiritning — ekki skjámynd forrits

Stilla einu sinni

Búðu til eða veldu Bubble forritaverkefnið í BestPlugins → Dashboard → Plugins. Veldu Xodera Offline Files Native, afritaðu lykilinn, opnaðu síðan Bubble → Plugins → Xodera Offline Files Native og límdu hann í licensing_api_key. Vistaðu einu sinni; notaðu síðan aðgerðirnar hér að neðan. Hver viðbót í hverju verkefni hefur sinn eigin lykil.

Notaðu native-forrit sem hefur aðgang að völdum skrám. Stilltu stöðugt document_context fyrir reikninginn eða skýrsluna svo vistaðar skrár haldist rétt flokkaðar saman.

Stilla einu sinni
  1. Búðu til eða veldu Bubble forritaverkefnið í BestPlugins → Dashboard → Plugins.
  2. Veldu þessa viðbót og afritaðu verkefnalykilinn.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Bættu við atriðinu, veldu forritagögnin þín og byggðu vinnuferlið hér að neðan.
  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.
Uppsetning og áskrift

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.

Vistaðu niðurstöðuna í forritinu þínu

Dæmi LocalAttachment: eigandi, document_context, vistunarskráar-ID, display_name, mime_type og size_bytes. Þetta ID virkar aðeins á sama tæki og fyrir sama reikning eða skýrslu. Fyrir netviðhengi, hlaðið skráinni upp í sjálfstæðri vinnuferli og vistaðu skilaða netskráarvísun.

Bilun, afturköllun og endurheimt

Þegar hætt er við skráaval skilar valglugginn operation_cancelled; það sendir eyðublaðið ekki inn. Á meðan native_pending=yes, bíddu eftir að skráaval eða deilingarvalmynd lokist áður en þú opnar annað. Clear session hreinsar núverandi val en heldur vistuðum afritum. Ef skrá vantar, láttu notandann velja hana aftur.

Möguleikar og takmarkanir

Veldu 1–20 skrár í einu. Takmörk á hverja skrá: 1 bæti–256 MiB, með lægra takmörk ef þú velur. Skráategundasíur athuga ekki skrár fyrir vírusum. Skráar-ID og slóðir tækis virka ekki sem ský niðurhalskrækjur. Staðvær afrit eru ekki dulkóðuð geymsla og geta tapast ef forritsgögn eru fjarlægð.

Stillingar, aðgerðir og niðurstöður

Notaðu þessi nöfn í Bubble. Áætlaðir eiginleikar eru merktir aðskilt.

Fáanleg beta stillingar

Stillingar atriðis

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

Stöður

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

Atburðir

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Aðgerðir og inntök þeirra

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
Stillingar atriðis · 16
source_uritext · Sjálfgefið: ""
Dæmi um gildifile:///app-cache/report.pdf
Dæmi um Bubble-segðPhoto Editor's output_uri
Lesanleg staðsetning skrár á þessu tæki sem skráavalglugginn eða önnur viðbót skilar.
display_nametext · Sjálfgefið: ""
Dæmi um gildireport-photo.jpg
Dæmi um Bubble-segðSelected Attachment's display_name
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
mime_typetext · Sjálfgefið: ""
Dæmi um gildiimage/jpeg
Dæmi um Bubble-segðPhoto Editor's output_mime
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
document_contexttext · Sjálfgefið: "default"
Dæmi um gildi<current-user-id>
Dæmi um Bubble-segðCurrent User's unique id
Stöðugt gildi fyrir þennan reikning eða þessa færslu. Notaðu sama gildi þegar þú endurheimtir vistaðar skrár eða drög sem tilheyra þeim reikningi eða þeirri færslu.
selected_file_idtext · Sjálfgefið: ""
Dæmi um gildi<returned saved file ID>
Dæmi um Bubble-segðSelected LocalAttachment's local_file_id
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
accepted_mime_types_jsontext · Sjálfgefið: "[\"*/*\"]"
Dæmi um gildi["image/*","application/pdf"]
Dæmi um Bubble-segðReport Settings' accepted_mime_types_json
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
multipleyes_no · Sjálfgefið: false
Dæmi um gildiyes
Dæmi um Bubble-segðReport Settings' allow_multiple_attachments
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
copy_to_cacheyes_no · Sjálfgefið: true
Dæmi um gildiyes
Dæmi um Bubble-segðReport Settings' copy_to_cache
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
max_filesnumber · Sjálfgefið: 20
Dæmi um gildi5
Dæmi um Bubble-segðReport Settings' attachment_limit
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
max_file_bytesnumber · Sjálfgefið: 268435456
Dæmi um gildi10485760
Dæmi um Bubble-segðReport Settings' max_attachment_bytes
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
is_activeyes_no · Sjálfgefið: true
Dæmi um gildiyes
Dæmi um Bubble-segðGuideHost's view_is_active (your yes/no custom state)
Stilltu yes á meðan þessi sýn er opin. Stilltu no þegar hún er yfirgefin svo afspilun eða núverandi vinna geti stöðvast.
disabledyes_no · Sjálfgefið: false
Dæmi um gildino
Dæmi um Bubble-segðGuideHost's is_busy (your yes/no custom state)
Óvirkjaðu þennan þátt þegar forritið er upptekið eða aðgerð er ekki tiltæk.
show_controlsyes_no · Sjálfgefið: true
Dæmi um gildiyes
Dæmi um Bubble-segðApp Settings' show_editor_controls
Sýna eða fela innbyggðu stjórntækin.
languagetext · Sjálfgefið: "auto"
Dæmi um gildiuk
Dæmi um Bubble-segðCurrent User's preferred_language
Stilltu language=auto til að fylgja tungumáli tækisins eða vafrans ef stuðningur er við það. Sláðu inn studdan tungumálakóða til að velja tungumál sérstaklega.
ui_text_jsontext · Sjálfgefið: ""
Dæmi um gildi{}
Dæmi um Bubble-segðApp Settings' player_labels_json (supported keys only)
Valfrjálst JSON með studdum hnappamerkingum. Skildu eftir tómt til að nota innbyggðan texta.
titletext · Sjálfgefið: ""
Dæmi um gildiLesson 4 — review
Dæmi um Bubble-segðSelected Lesson's name
Sýnilegur texti í forritinu; ef reiturinn er tómur er innbyggður staðfærður texti notaður þar sem hann er studdur. Ekki setja inn aðgangsupplýsingar.
Aðgerðir og inntök þeirra · 10
Pick files

Engir aðgerðarbreytur

Load local source
source_uritext · Sjálfgefið: —
Dæmi um gildifile:///app-cache/report.pdf
Dæmi um Bubble-segðPhoto Editor's output_uri
Lesanleg staðsetning skrár á þessu tæki sem skráavalglugginn eða önnur viðbót skilar.
display_nametext · Sjálfgefið: —
Dæmi um gildireport-photo.jpg
Dæmi um Bubble-segðSelected Attachment's display_name
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
mime_typetext · Sjálfgefið: —
Dæmi um gildiimage/jpeg
Dæmi um Bubble-segðPhoto Editor's output_mime
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Select picked file
indexnumber · Sjálfgefið: —
Dæmi um gildi0
Dæmi um Bubble-segðSelected row's current_source_index
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Save selection locally

Engir aðgerðarbreytur

List saved files

Engir aðgerðarbreytur

Restore saved file
file_idtext · Sjálfgefið: —
Dæmi um gildi<returned saved file ID>
Dæmi um Bubble-segðSelected LocalAttachment's local_file_id
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Delete saved copy
file_idtext · Sjálfgefið: —
Dæmi um gildi<returned saved file ID>
Dæmi um Bubble-segðSelected LocalAttachment's local_file_id
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
confirmyes_no · Sjálfgefið: —
Dæmi um gildiyes — explicit confirmation only
Dæmi um Bubble-segðConfirm Checkbox is checked
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Share selected file
dialog_titletext · Sjálfgefið: —
Dæmi um gildiShare attachment
Dæmi um Bubble-segðSelected Report's share_title
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
utitext · Sjálfgefið: —
Dæmi um gildi""
Dæmi um Bubble-segðEmpty unless your iOS integration supplies a proven UTI
Notaðu gildi núverandi viðskiptaskrár; staðfestu það gegn takmörkunum hér að neðan.
Cancel operation

Engir aðgerðarbreytur

Clear session

Engir aðgerðarbreytur

Stöður og atburðir

Stöður

status · text

Núverandi niðurstaða þessa aðgerðar. Notaðu samsvarandi lokaatburð áður en þú vistar árangur.

is_busy · yes_no

Verk er enn í vinnslu. Bíddu áður en þú byrjar aðra aðgerð.

native_pending · yes_no

Verk er enn í vinnslu. Bíddu áður en þú byrjar aðra aðgerð.

operation · text

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

selection_count · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

selected_index · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

file_id · text

Auðkenni fyrir þennan hlut eða aðgerð. Halda því með samsvarandi forritsskrá. Notaðu sama beiðniauðkenni þegar þú reynir aftur óvissa niðurstöðu.

local_uri · text

Staðsetning skrár á þessu tæki. Ef skráin þarf að vera aðgengileg á netinu verður að vista hana eða hlaða henni upp í sérstöku ferli.

display_name · text

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

mime_type · text

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

mime_source · text

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

size_bytes · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

is_saved_locally · yes_no

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

file_ids · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

file_uris · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

file_names · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

file_mime_types · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

file_sizes · number (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

files_json · text

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

saved_count · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

saved_file_ids · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

saved_file_uris · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

saved_file_names · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

saved_file_mime_types · text (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

saved_file_sizes · number (Listi)

Listi yfir valdar skrár. Atriði á sama vísitölu í öðrum skráalista vísa til sömu skrár.

saved_files_json · text

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

invalid_saved_count · number

Núverandi gildi fyrir valinn hlut. Lestu það eftir tengdan atburð.

share_status · text

Núverandi niðurstaða þessa aðgerðar. Notaðu samsvarandi lokaatburð áður en þú vistar árangur.

error_code · text

Villumeldingar og aðrar villuupplýsingar fyrir síðustu aðgerð. Sýndu gagnleg skilaboð og bjóddu viðeigandi endurtilraun.

Atburðir

selection_changed

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

files_saved

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

list_loaded

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

file_restored

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

file_deleted

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

share_sheet_closed

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

operation_cancelled

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

files_error

Þegar þessi atburður á sér stað skaltu lesa tengdar stöður úr sama viðmótsþætti.

Spurningar sem þróunaraðilar spyrja

Merkir Deiling “sent”?

Nei. Stýrikerfið veitir ekki áreiðanlegt kvittun um móttaka hér. Sýndu “deilingarvalmynd lokað”.

Hvernig virkar áskriftin?

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.

Tengdar leiðbeiningar

Fyrir aðstoð, segðu okkur hvaða viðbót og tæki þú notar, aðgerðina sem þú reyndir og hvað gerðist. Notaðu dæmi án persónuupplýsinga. Deildu aldrei lykli þínum eða einkaskrám.