Xodera Plugins · Bubble Native
Xodera Offline Files Native
Säilytä raportin liitteet ja valitut tiedostot laitteella, palauta ne myöhemmin ja anna käyttäjän jakaa valittu kopio.
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.
Dokumentaatio tarkistettu 6 marraskuussa 2026
Käytännön esimerkit
Valmistele useita paikallisia liitteitä ennen raportin lähettämistä
Lomakkeessa täytyy näyttää, mitkä tiedostot valittiin, ja antaa käyttäjän pitää hallinnoitu kopio ennen mitään pilvipalveluun lähettämistä.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; aseta `max_files`, `max_file_bytes` ja tilin/raportin `document_context`.
Pick files → tarkastele valittuja nimiä/kokoja → Save selection locally. Lomakkeesi säilyttää tuloksena saadut tiedoston ID:t, kunnes sen erillinen Lähetä-työnkulku lataa hyväksytyt tiedostot.
Käytä `selection_count`, `file_names`, `file_sizes` ja `saved_file_ids` arvostelulistan näyttämiseen. Tallennettu hallittu kopio säilyttää kutsujan alkuperäisen.
Peruutettu valitsin ei ole lähetetty raportti. `files_error`:ssa pidä jo hyväksytyt paikalliset tunnisteet ja näytä `error_code`; älä koskaan luo pilvitiedostoa pelkästään paikallisesta URI:sta.
Tiedostot pysyvät laitteella, kunnes ne jaetaan tai ladataan erikseen.
Säilytä valokuva-editorin tai tallentimen tuotos myöhempää käyttöä varten
Luotu paikallinen tiedosto voi sijaita tilapäisessä paikassa; sovellus tarvitsee erillisen hallitun kopion.
`source_uri = the local output of a separately accepted editor/recorder`; liitä sen todellinen `display_name` ja `mime_type`; käytä saman omistajan `document_context`.
Load local source → tarkastele metatietoja → Save selection locally. Tallenna palautettu tiedostotunnus vain vastaavaan laitteeseen/kontekstiin, ja sitten Restore saved file kyseisellä tunnuksella tarvittaessa.
Käytä `file_id`, `local_uri`, `size_bytes` ja `is_saved_locally`; hyödynnä `file_restored` erottamaan valmis palautus pelkän pyynnön sijasta.
Hylkää etä-URL HTTP paikallisena lähteenä. Jos lähde katoaa tai palautus epäonnistuu, näytä `error_code` ja säilytä alkuperäinen sovelluksen tietue palautusta varten.
Tiedostot pysyvät laitteella, kunnes ne jaetaan tai ladataan erikseen.
Salli käyttäjän jakaa sovelluksen luoma paikallinen kuitti tai vienti
Sovelluksen tulisi antaa valittu paikallinen tiedosto laitteen jakolevylle sen sijaan, että se keksii julkisen URL-osoitteen.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; sen nimi ja MIME kuvaavat todellista paikallista tiedostoa.
List saved files → Restore saved file → Share selected file sen jälkeen, kun käyttäjä napauttaa Jaa. Säilytä tallennettu kopio, kunnes hän valitsee nimenomaan Delete saved copy.
Käytä `share_status` ja `share_sheet_closed` käyttöliittymän päivittämiseen sen jälkeen, kun levylle on suljettu. Säilytä tiedostotunnus myöhempää tarkoituksellista jakamista varten.
Suljettu jakolevy ei ole todiste siitä, että sähköposti/viesti on toimitettu. Käsittele peruutus ja `files_error` ilman onnistumisen ilmoittamista vastaanottajalle.
Tiedostot pysyvät laitteella, kunnes ne jaetaan tai ladataan erikseen.
Mikä toimii nyt
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.
Rakenna työnkulku
Käytä alla olevia saatavilla olevia beta‑toimintoja ja testaa tulosta kohdelaitteillasi.
Nämä esimerkit käyttävät sovellustietueita, kuten Lesson, Message ja Order. Korvaa ne omilla tietotyypeilläsi ja elementtien nimillä. Esimerkkimediaosoitteet on korvattava omilla tiedostoillasi.
Aseta document_context = Current User's unique id tai vakaa arvo tilille ja raportille. Valitse accepted_mime_types_json, max_files ja max_file_bytes.
Suorita Pick files tai käytä Load local source luettavassa tiedostossa, jonka Photo Editor tai Recorder on tuottanut. selection_changed jälkeen lue vastaavat tiedostolistat; Select picked file valitsee indeksin.
Suorita Save selection locally. files_saved jälkeen pidä saved_file_ids sovelluksesi paikallisessa liitekirjassa. List saved files näyttää tallennetut kopiot; Restore saved file avaa valitun tallennetun ID:n.
Share selected file avaa järjestelmän jakamismenun. share_sheet_closed tarkoittaa vain, että valikko sulkeutui. Delete saved copy tarvitsee valitun ID:n ja confirm=yes.
Määritä kerran
Luo tai valitse Bubble‑sovellusprojekti BestPlugins → Dashboard → Plugins. Valitse Xodera Offline Files Native, kopioi sen avain, avaa sitten Bubble → Plugins → Xodera Offline Files Native ja liitä se licensing_api_key:ään. Tallenna kerran; käytä sitten alla olevia toimintoja. Jokaisella liitännäisellä jokaisessa projektissa on oma avain.
Käytä natiivisovellusta, jolla on pääsy valittuihin tiedostoihin. Aseta vakaa document_context tilille tai raportille, jotta sen tallennetut tiedostot pysyvät ryhmittyneinä oikein.
Määritä kerran
- Luo tai valitse Bubble‑sovellusprojekti BestPlugins → Dashboard → Plugins.
- Valitse tämä liitännäinen ja kopioi sen projektin avain.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Lisää elementti, valitse sovellustietosi ja rakenna alla oleva työnkulku.
- 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.
Asennus ja tilaus
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.
Tallenna tulos sovellukseesi
Esimerkki LocalAttachment: omistaja, document_context, tallennettu tiedoston ID, display_name, mime_type ja size_bytes. Tämä ID toimii vain samassa laitteessa ja samalle tilille tai raportille. Verkkoliitteelle lataa tiedosto erillisellä työnkululla ja tallenna palautettu verkkotiedoston viite.
Epäonnistuminen, peruutus ja palautus
Peruutettu valitsin palauttaa operation_cancelled; se ei lähetä lomaketta. Kun native_pending=yes, odota tiedostovalitsimen tai jakamismenun sulkeutumista ennen toisen avaamista. Clear session tyhjentää nykyisen valinnan mutta säilyttää tallennetut kopiot. Jos tiedosto puuttuu, anna käyttäjän valita se uudelleen.
Ominaisuudet ja rajoitukset
Valitse 1–20 tiedostoa kerralla. Tiedostokohtainen raja: 1 tavua–256 MiB, alhaisempi raja mahdollinen. Tiedostotyyppisuodattimet eivät tarkista tiedostoja viruksilta. Laitteen tiedosto-ID:t ja polut eivät toimi pilvilatauslinkkeinä. Paikalliset kopiot eivät ole salattua tallennusta ja voivat kadota, jos sovelluksen data poistetaan.
Asetukset, toiminnot ja tulokset
Käytä näitä nimiä Bubble:ssa. Suunnitellut ominaisuudet on merkitty erikseen.
Käytettävissä olevat beta-asetukset
Elementin asetukset
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 · textTilat
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 (luettelo)file_uris · text (luettelo)file_names · text (luettelo)file_mime_types · text (luettelo)file_sizes · number (luettelo)files_json · textsaved_count · numbersaved_file_ids · text (luettelo)saved_file_uris · text (luettelo)saved_file_names · text (luettelo)saved_file_mime_types · text (luettelo)saved_file_sizes · number (luettelo)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textTapahtumat
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorToiminnot ja niiden syötteet
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionElementin asetukset · 16
source_uritext · Oletus: ""- Esimerkkisarvo
file:///app-cache/report.pdf - Esimerkki Bubble -lauseke
Photo Editor's output_uri - Luettavissa oleva tiedoston sijainti tällä laitteella, jonka valintatyökalu tai toinen liitännäinen palauttaa.
display_nametext · Oletus: ""- Esimerkkisarvo
report-photo.jpg - Esimerkki Bubble -lauseke
Selected Attachment's display_name - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
mime_typetext · Oletus: ""- Esimerkkisarvo
image/jpeg - Esimerkki Bubble -lauseke
Photo Editor's output_mime - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
document_contexttext · Oletus: "default"- Esimerkkisarvo
<current-user-id> - Esimerkki Bubble -lauseke
Current User's unique id - Vakaa arvo tälle tilille tai tietueelle. Käytä samaa arvoa sen tallennettujen tiedostojen tai luonnosten palauttamisessa.
selected_file_idtext · Oletus: ""- Esimerkkisarvo
<returned saved file ID> - Esimerkki Bubble -lauseke
Selected LocalAttachment's local_file_id - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
accepted_mime_types_jsontext · Oletus: "[\"*/*\"]"- Esimerkkisarvo
["image/*","application/pdf"] - Esimerkki Bubble -lauseke
Report Settings' accepted_mime_types_json - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
multipleyes_no · Oletus: false- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
Report Settings' allow_multiple_attachments - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
copy_to_cacheyes_no · Oletus: true- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
Report Settings' copy_to_cache - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
max_filesnumber · Oletus: 20- Esimerkkisarvo
5 - Esimerkki Bubble -lauseke
Report Settings' attachment_limit - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
max_file_bytesnumber · Oletus: 268435456- Esimerkkisarvo
10485760 - Esimerkki Bubble -lauseke
Report Settings' max_attachment_bytes - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
is_activeyes_no · Oletus: true- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
GuideHost's view_is_active (your yes/no custom state) - Aseta kyllä, kun tämä näkymä on auki. Aseta ei, kun poistutaan, jotta toisto tai nykyinen työ voi pysähtyä.
disabledyes_no · Oletus: false- Esimerkkisarvo
no - Esimerkki Bubble -lauseke
GuideHost's is_busy (your yes/no custom state) - Poista elementti käytöstä, kun sovelluksesi on kiireinen tai tämä toiminto ei ole saatavilla.
show_controlsyes_no · Oletus: true- Esimerkkisarvo
yes - Esimerkki Bubble -lauseke
App Settings' show_editor_controls - Näytä tai piilota sisäänrakennetut ohjaimet.
languagetext · Oletus: "auto"- Esimerkkisarvo
uk - Esimerkki Bubble -lauseke
Current User's preferred_language - Aseta language=auto seuraamaan tuettua laitetta tai selaimen kieltä. Syötä tuettu kielikoodi valitaksesi sen eksplisiittisesti.
ui_text_jsontext · Oletus: ""- Esimerkkisarvo
{} - Esimerkki Bubble -lauseke
App Settings' player_labels_json (supported keys only) - Valinnainen JSON tuetuilla painikkeen teksteillä. Jätä tyhjäksi käyttääksesi sisäänrakennettua tekstiä.
titletext · Oletus: ""- Esimerkkisarvo
Lesson 4 — review - Esimerkki Bubble -lauseke
Selected Lesson's name - Näkyvä sovellusteksti; tyhjä käyttää sisäänrakennettua lokalisoitua tekstiä, jos tuettu. Ei tunnistetietoja.
Toiminnot ja niiden syötteet · 10
Pick files
Ei toiminto‑parametreja
Load local source
source_uritext · Oletus: —- Esimerkkisarvo
file:///app-cache/report.pdf - Esimerkki Bubble -lauseke
Photo Editor's output_uri - Luettavissa oleva tiedoston sijainti tällä laitteella, jonka valintatyökalu tai toinen liitännäinen palauttaa.
display_nametext · Oletus: —- Esimerkkisarvo
report-photo.jpg - Esimerkki Bubble -lauseke
Selected Attachment's display_name - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
mime_typetext · Oletus: —- Esimerkkisarvo
image/jpeg - Esimerkki Bubble -lauseke
Photo Editor's output_mime - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Select picked file
indexnumber · Oletus: —- Esimerkkisarvo
0 - Esimerkki Bubble -lauseke
Selected row's current_source_index - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Save selection locally
Ei toiminto‑parametreja
List saved files
Ei toiminto‑parametreja
Restore saved file
file_idtext · Oletus: —- Esimerkkisarvo
<returned saved file ID> - Esimerkki Bubble -lauseke
Selected LocalAttachment's local_file_id - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Delete saved copy
file_idtext · Oletus: —- Esimerkkisarvo
<returned saved file ID> - Esimerkki Bubble -lauseke
Selected LocalAttachment's local_file_id - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
confirmyes_no · Oletus: —- Esimerkkisarvo
yes — explicit confirmation only - Esimerkki Bubble -lauseke
Confirm Checkbox is checked - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Share selected file
dialog_titletext · Oletus: —- Esimerkkisarvo
Share attachment - Esimerkki Bubble -lauseke
Selected Report's share_title - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
utitext · Oletus: —- Esimerkkisarvo
"" - Esimerkki Bubble -lauseke
Empty unless your iOS integration supplies a proven UTI - Käytä nykyisen liiketoimintatietueen arvoa; tarkista se alla olevia rajoja vastaan.
Cancel operation
Ei toiminto‑parametreja
Clear session
Ei toiminto‑parametreja
Tilat ja tapahtumat
Tilat
status · textTämän toiminnon nykyinen tulos. Käytä vastaavaa valmistumistapahtumaa ennen onnistuneen tallennuksen tekemistä.
is_busy · yes_noTyö on vielä kesken. Odota ennen kuin aloitat toisen toiminnon.
native_pending · yes_noTyö on vielä kesken. Odota ennen kuin aloitat toisen toiminnon.
operation · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
selection_count · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
selected_index · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
file_id · textTunniste tälle kohteelle tai toiminnolle. Säilytä se vastaavan sovellustietueen kanssa. Käytä samaa pyyntö‑tunnistetta, kun yrität epävarmaa tulosta uudelleen.
local_uri · textTiedoston sijainti tällä laitteella. Tallenna tai lataa tiedosto erikseen, jos se on pidettävä verkossa.
display_name · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
mime_type · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
mime_source · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
size_bytes · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
is_saved_locally · yes_noValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
file_ids · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
file_uris · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
file_names · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
file_mime_types · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
file_sizes · number (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
files_json · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
saved_count · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
saved_file_ids · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
saved_file_uris · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
saved_file_names · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
saved_file_mime_types · text (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
saved_file_sizes · number (luettelo)Lista valituista tiedostoista. Samassa indeksissä olevat kohteet muissa tiedostolistoissa viittaavat samaan tiedostoon.
saved_files_json · textValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
invalid_saved_count · numberValitun kohteen nykyinen arvo. Lue se liittyvän tapahtuman jälkeen.
share_status · textTämän toiminnon nykyinen tulos. Käytä vastaavaa valmistumistapahtumaa ennen onnistuneen tallennuksen tekemistä.
error_code · textViimeisen toiminnon virhetiedot. Näytä hyödyllinen viesti ja tarjoa asiaankuuluva uudelleenyritys.
Tapahtumat
selection_changedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
files_savedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
list_loadedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
file_restoredKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
file_deletedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
share_sheet_closedKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
operation_cancelledKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
files_errorKun tämä tapahtuma tapahtuu, lue siihen liittyvät tilat samasta elementistä.
Kysymykset, joita kehittäjät esittävät
Tarkoittaako Jaa “lähetetty”?
Ei. Käyttöjärjestelmä ei tarjoa luotettavaa vastaanottajan onnistumisen vahvistusta tässä. Näytä “jakovalikko sulkeutui”.
Miten tilaus toimii?
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.
Aiheeseen liittyvät oppaat
Avun saamiseksi kerro, mitä lisäosaa ja laitetta käytät, mitä toimintoa yritit ja mitä tapahtui. Käytä esimerkkiä ilman henkilötietoja. Älä koskaan jaa avaintasi tai yksityisiä tiedostoja.