Offline Files liides.
Offline Files liides.
← Kõik natiivrakenduste juhendid

Xodera Plugins · Bubble Native

Xodera Offline Files Native

Hoia aruande manuseid ja valitud faile seadmes, taasta need hiljem ning lase kasutajal jagada valitud koopia.

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.

Dokumentatsioon üle vaadatud 6 novembris 2026

Praktilised näited

Valmista mitu kohalikku manust enne aruande esitamist

Vorm peab näitama, millised failid valiti, ja võimaldama kasutajal hoida hallatud koopiat enne mistahes pilveesitamist.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; määra `max_files`, `max_file_bytes` ja konto/aruande `document_context`.

Pick files → kontrolli valitud nimesid ja suurusi → Save selection locally. Vorm hoiab saadud faili-ID-sid, kuni eraldi Submit töövoog lubatud failid üles laadib.

Kasuta `selection_count`, `file_names`, `file_sizes` ja `saved_file_ids` ülevaatusloendi kuvamiseks. Hallatud koopia salvestamine jätab toimingu kutsuja algfaili alles.

Tühistatud valija ei ole esitatud aruanne. `files_error` juures säilita juba aktsepteeritud lokaalsed ID-d ja kuva `error_code`; ära kunagi loo pilvemanust ainult lokaalsest URI-st.

Failid jäävad sellel seadmel, kuni need jagatakse või laaditakse üles eraldi.

Säilita foto-redaktori või salvestaja väljund hilisemaks kasutamiseks

Genereeritud kohalik fail võib asuda ajutises asukohas; rakendus vajab selget hallatud koopiat.

`source_uri = the local output of a separately accepted editor/recorder`; seo selle tegelik `display_name` ja `mime_type`; kasuta sama omanikuga `document_context`.

Load local source → kontrolli metaandmeid → Save selection locally. Salvesta tagastatud faili ID ainult vastavasse seadmesse/konteksti, seejärel kasuta Restore saved file selle täpse ID-ga vajadusel.

Kasuta `file_id`, `local_uri`, `size_bytes` ja `is_saved_locally`; kasuta `file_restored`, et eristada lõpetatud taastamist lihtsalt taotlusest.

Lükka tagasi kaugne HTTP URL kui kohalik allikas. Kui allikas kaob või taastamine ebaõnnestub, kuva `error_code` ja säilita algne rakenduse kirje taastamiseks.

Failid jäävad sellel seadmel, kuni need jagatakse või laaditakse üles eraldi.

Luba kasutajal jagada rakenduse loodud kohalikku kviitungit või eksporti

Rakendus peaks edastama valitud kohaliku faili seadme jagamislehele, mitte looma avalikku URL-i.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; selle nimi ja MIME kirjeldavad tegelikku kohalikku faili.

List saved files → Restore saved file → Share selected file pärast seda, kui kasutaja vajutab Share. Säilita salvestatud koopia, kuni ta valib selgesõnaliselt Delete saved copy.

Kasuta `share_status` ja `share_sheet_closed`, et värskendada kasutajaliidest pärast lehe sulgemist. Säilita faili ID järgmise teadliku jagamise jaoks.

Suletud jagamisleht ei tõesta, et e-kiri/sõnum on kohale toimetatud. Käsitle tühistamist ja `files_error` ilma edu teavitamata saajale.

Failid jäävad sellel seadmel, kuni need jagatakse või laaditakse üles eraldi.

Mis töötab praegu

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.

Loo töövoog

Kasuta allpool olevaid saadavalolevaid beetategevusi ja testi tulemust oma sihtseadmetel.

Need näited kasutavad rakenduse kirjeid, nagu Lesson, Message ja Order. Asenda need oma andmetüüpide ja elementide nimedega. Näidismeedia aadresse tuleb asendada oma failidega.

  1. Määra document_context = Current User's unique id või stabiilne väärtus konto ja aruande jaoks. Vali accepted_mime_types_json, max_files ja max_file_bytes.

  2. Käivita Pick files või kasuta Load local source loetava faili jaoks, mille on loonud Photo Editor või Recorder. Pärast selection_changed loe vastavaid faililoendeid; Select picked file valib indeksi.

  3. Käivita Save selection locally. Pärast files_saved hoia saved_file_ids oma rakenduse kohaliku manuse kirjes. List saved files näitab salvestatud koopiaid; Restore saved file avab valitud salvestatud ID.

  4. Share selected file avab süsteemi jagamismenüü. share_sheet_closed tähendab ainult, et menüü sulges. Delete saved copy vajab valitud ID-d ja confirm=yes.

Töövoodiagramm — mitte rakenduse ekraanipilt

Seadista üks kord

Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins. Vali Xodera Offline Files Native, kopeeri selle võti, seejärel ava Bubble → Plugins → Xodera Offline Files Native ja kleebi see licensing_api_key. Salvesta üks kord; seejärel kasuta allolevaid tegevusi. Igal pistikprogrammil igas projektis on oma võti.

Kasuta natiivset rakendust, millel on juurdepääs valitud failidele. Määra konto või aruande jaoks stabiilne document_context, et selle salvestatud failid oleksid õigesti grupeeritud.

Seadista üks kord
  1. Loo või vali oma Bubble rakenduse projekt BestPlugins → Dashboard → Plugins.
  2. Vali see pistikprogramm ja kopeeri selle projekti võti.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Lisa element, vali oma rakenduse andmed ja loo allpool toodud töövoog.
  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.
Paigaldus ja tellimus

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.

Salvesta tulemus oma rakendusse

Näide LocalAttachment: owner, document_context, salvestatud faili ID, display_name, mime_type ja size_bytes. See ID töötab ainult samal seadmel ning sama konto või aruande jaoks. Veebimanuse loomiseks laadi fail eraldi töövooga üles ja salvesta tagastatud veebifaili viide.

Tõrge, tühistamine ja taastamine

Tühistatud valija tagastab operation_cancelled; see ei esita vormi. Kui native_pending=yes, oota, kuni failivalija või jagamismenüü sulgeb, enne kui avad teise. Clear session tühjendab praeguse valiku, kuid säilitab salvestatud koopiad. Kui fail puudub, lase kasutajal see uuesti valida.

Võimekused ja piirangud

Vali korraga 1–20 faili. Faili suuruse piirang: 1 bait–256 MiB; soovi korral määra väiksem piirang. Failitüübi filtrid ei kontrolli viirusi. Seadme faili-ID-d ja teed ei ole pilvefailide allalaadimislingid. Kohalikud koopiad ei ole krüpteeritud salvestusruum ning võivad rakenduse andmete eemaldamisel kaduda.

Seaded, toimingud ja tulemused

Kasuta neid nimesid Bubble-s. Planeeritud funktsioonid on märgitud eraldi.

Saadaolevad beetaversiooni seaded

Elemendi seaded

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

Olekud

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

Sündmused

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Toimingud ja nende sisendid

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
Elemendi seaded · 16
source_uritext · Vaikimisi: ""
Näidisväärtusfile:///app-cache/report.pdf
Bubble avaldise näidePhoto Editor's output_uri
Loetav faili asukoht selles seadmes, mille tagastab teie valija või mõni muu plugin.
display_nametext · Vaikimisi: ""
Näidisväärtusreport-photo.jpg
Bubble avaldise näideSelected Attachment's display_name
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
mime_typetext · Vaikimisi: ""
Näidisväärtusimage/jpeg
Bubble avaldise näidePhoto Editor's output_mime
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
document_contexttext · Vaikimisi: "default"
Näidisväärtus<current-user-id>
Bubble avaldise näideCurrent User's unique id
Stabiilne väärtus selle konto või kirje jaoks. Kasuta sama väärtust selle salvestatud failide või mustandite taastamisel.
selected_file_idtext · Vaikimisi: ""
Näidisväärtus<returned saved file ID>
Bubble avaldise näideSelected LocalAttachment's local_file_id
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
accepted_mime_types_jsontext · Vaikimisi: "[\"*/*\"]"
Näidisväärtus["image/*","application/pdf"]
Bubble avaldise näideReport Settings' accepted_mime_types_json
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
multipleyes_no · Vaikimisi: false
Näidisväärtusyes
Bubble avaldise näideReport Settings' allow_multiple_attachments
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
copy_to_cacheyes_no · Vaikimisi: true
Näidisväärtusyes
Bubble avaldise näideReport Settings' copy_to_cache
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
max_filesnumber · Vaikimisi: 20
Näidisväärtus5
Bubble avaldise näideReport Settings' attachment_limit
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
max_file_bytesnumber · Vaikimisi: 268435456
Näidisväärtus10485760
Bubble avaldise näideReport Settings' max_attachment_bytes
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
is_activeyes_no · Vaikimisi: true
Näidisväärtusyes
Bubble avaldise näideGuideHost's view_is_active (your yes/no custom state)
Määra yes, kui see vaade on avatud. Vaate sulgemisel määra no, et taasesitus või pooleliolev töö saaks peatuda.
disabledyes_no · Vaikimisi: false
Näidisväärtusno
Bubble avaldise näideGuideHost's is_busy (your yes/no custom state)
Keela element, kui teie rakendus on hõivatud või see toiming pole saadaval.
show_controlsyes_no · Vaikimisi: true
Näidisväärtusyes
Bubble avaldise näideApp Settings' show_editor_controls
Kuva või peida sisseehitatud juhtelemente.
languagetext · Vaikimisi: "auto"
Näidisväärtusuk
Bubble avaldise näideCurrent User's preferred_language
Määra language=auto, et kasutada seadme või brauseri keelt, kui see keel on toetatud. Kindla keele valimiseks sisesta toetatud keelekood.
ui_text_jsontext · Vaikimisi: ""
Näidisväärtus{}
Bubble avaldise näideApp Settings' player_labels_json (supported keys only)
Valikuline JSON toetatud nuppude siltidega. Jäta tühjaks, et kasutada sisseehitatud teksti.
titletext · Vaikimisi: ""
NäidisväärtusLesson 4 — review
Bubble avaldise näideSelected Lesson's name
Nähtav rakenduse tekst; tühja väärtuse korral kasutatakse toetatud juhtudel sisseehitatud tõlgitud teksti. Ära sisesta siia juurdepääsuandmeid.
Toimingud ja nende sisendid · 10
Pick files

Ei ole toimingu parameetreid

Load local source
source_uritext · Vaikimisi: —
Näidisväärtusfile:///app-cache/report.pdf
Bubble avaldise näidePhoto Editor's output_uri
Loetav faili asukoht selles seadmes, mille tagastab teie valija või mõni muu plugin.
display_nametext · Vaikimisi: —
Näidisväärtusreport-photo.jpg
Bubble avaldise näideSelected Attachment's display_name
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
mime_typetext · Vaikimisi: —
Näidisväärtusimage/jpeg
Bubble avaldise näidePhoto Editor's output_mime
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Select picked file
indexnumber · Vaikimisi: —
Näidisväärtus0
Bubble avaldise näideSelected row's current_source_index
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Save selection locally

Ei ole toimingu parameetreid

List saved files

Ei ole toimingu parameetreid

Restore saved file
file_idtext · Vaikimisi: —
Näidisväärtus<returned saved file ID>
Bubble avaldise näideSelected LocalAttachment's local_file_id
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Delete saved copy
file_idtext · Vaikimisi: —
Näidisväärtus<returned saved file ID>
Bubble avaldise näideSelected LocalAttachment's local_file_id
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
confirmyes_no · Vaikimisi: —
Näidisväärtusyes — explicit confirmation only
Bubble avaldise näideConfirm Checkbox is checked
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Share selected file
dialog_titletext · Vaikimisi: —
NäidisväärtusShare attachment
Bubble avaldise näideSelected Report's share_title
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
utitext · Vaikimisi: —
Näidisväärtus""
Bubble avaldise näideEmpty unless your iOS integration supplies a proven UTI
Kasutage praeguse ärirekordi väärtust; kontrollige seda allpool toodud piiride suhtes.
Cancel operation

Ei ole toimingu parameetreid

Clear session

Ei ole toimingu parameetreid

Olekud ja sündmused

Olekud

status · text

Selle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.

is_busy · yes_no

Töö on endiselt pooleli. Oota enne järgmise toimingu alustamist.

native_pending · yes_no

Töö on endiselt pooleli. Oota enne järgmise toimingu alustamist.

operation · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

selection_count · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

selected_index · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

file_id · text

Selle üksuse või tegevuse identifikaator. Säilita see vastava rakenduse kirje juures. Kasuta sama päringu identifikaatorit ebakindla tulemuse kordamisel.

local_uri · text

Faili asukoht selles seadmes. Salvesta või laadi fail eraldi üles, kui see peab olema internetis.

display_name · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

mime_type · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

mime_source · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

size_bytes · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

is_saved_locally · yes_no

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

file_ids · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

file_uris · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

file_names · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

file_mime_types · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

file_sizes · number (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

files_json · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

saved_count · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

saved_file_ids · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

saved_file_uris · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

saved_file_names · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

saved_file_mime_types · text (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

saved_file_sizes · number (loend)

Loend valitud failide jaoks. Teistes faililoendites samal indeksil olevad elemendid viitavad samale failile.

saved_files_json · text

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

invalid_saved_count · number

Valitud üksuse praegune väärtus. Loe seda pärast seotud sündmust.

share_status · text

Selle toimingu praegune tulemus. Kasuta sobivat lõpetamise sündmust enne edu salvestamist.

error_code · text

Vea teave viimase toimingu kohta. Kuva abistav sõnum ja paku asjakohast kordamist.

Sündmused

selection_changed

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

files_saved

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

list_loaded

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

file_restored

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

file_deleted

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

share_sheet_closed

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

operation_cancelled

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

files_error

Kui see sündmus toimub, loe seotud olekuid samast elemendist.

Küsimused, mida arendajad esitavad

Kas Share tähendab „saadetud“?

Ei. Operatsioonisüsteem ei paku siin usaldusväärset kättesaaja edu kviitungit. Näita “jagamismenüü suletud”.

Kuidas tellimus töötab?

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.

Seotud juhendid

Abi saamiseks andke meile teada, millist pistikprogrammi ja seadet kasutate, millist toimingut proovisite ning mis juhtus. Kasutage näidet ilma isikuandmeteta. Ärge kunagi jagage oma võtit ega privaatfaile.