Offline Files felület.
Offline Files felület.
← Minden natív útmutató

Xodera Plugins · Bubble Native

Xodera Offline Files Native

Tartsa a jelentés mellékleteit és a kiválasztott fájlokat az eszközön, állítsa vissza később, és engedje a felhasználónak, hogy megosszon egy kiválasztott másolatot.

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.

Dokumentáció felülvizsgált 6 november 2026

Gyakorlati példák

Készítsen elő több helyi mellékletet a jelentés benyújtása előtt

Az űrlapnak meg kell jelenítenie, mely fájlok lettek kiválasztva, és lehetővé kell tennie a felhasználó számára, hogy felhőben történő benyújtás előtt egy kezelt másolatot megőrizzen.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; állítsa be a `max_files`, `max_file_bytes` és egy fiók/jelentés `document_context` értékeket.

Pick files → ellenőrizze a kiválasztott neveket/méreteket → Save selection locally. Az űrlap megőrzi a kapott fájlazonosítókat, amíg a külön Submit munkafolyamat feltölti a jóváhagyott fájlokat.

Használja a `selection_count`, `file_names`, `file_sizes` és `saved_file_ids` elemeket a felülvizsgálati lista megjelenítéséhez. Egy mentett kezelt másolat megőrzi a hívó eredeti példányát.

A törölt kiválasztó nem benyújtott jelentés. A `files_error` esetén tartsa meg a már elfogadott helyi azonosítókat, és jelenítse meg a `error_code`-et; soha ne hozzon létre felhőmellékletet csak egy helyi URI alapján.

A fájlok ezen az eszközön maradnak, amíg külön nem osztják meg vagy töltik fel.

Tartsa meg a fénykép-szerkesztő vagy felvevő kimenetét későbbi használatra

A létrehozott helyi fájl ideiglenes helyen tárolódhat; az alkalmazásnak explicit kezelt másolatra van szüksége.

`source_uri = the local output of a separately accepted editor/recorder`; kössön hozzá a valódi `display_name` és `mime_type` értékeket; használja ugyanannak a tulajdonosnak a `document_context`-et.

Load local source → metaadatok ellenőrzése → Save selection locally. Tárolja a visszakapott fájlazonosítót csak a megfelelő eszköz/környezetben, majd szükség esetén a Restore saved file a pontos azonosítóval.

Használja a `file_id`, `local_uri`, `size_bytes` és `is_saved_locally` elemeket; a `file_restored` segítségével különböztesse meg a befejezett visszaállítást a csak kérés állapotától.

Utasítsa el a távoli HTTP URL-t helyi forrásként. Ha a forrás eltűnik vagy a visszaállítás sikertelen, jelenítse meg a `error_code`-et, és őrizze meg az eredeti alkalmazásrekordot a helyreállításhoz.

A fájlok ezen az eszközön maradnak, amíg külön nem osztják meg vagy töltik fel.

Engedje meg a felhasználónak, hogy megosszon egy alkalmazás által generált helyi nyugtát vagy exportot

Az alkalmazásnak a kiválasztott helyi fájlt a készülék megosztási lapjára kell átadnia, ahelyett, hogy nyilvános URL-t hozna létre.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; neve és a MIME leírják a valódi helyi fájlt.

List saved files → Restore saved file → Share selected file a felhasználó a Megosztás gombra kattintása után. Tartsa meg a mentett másolatot, amíg a felhasználó kifejezetten nem választja a Delete saved copy-et.

Használja a `share_status` és `share_sheet_closed` elemeket a felhasználói felület frissítéséhez a lap bezárása után. Tartsa meg a fájlazonosítót egy további szándékos megosztáshoz.

A bezárt megosztási lap nem bizonyítja, hogy az e-mail/üzenet kézbesítésre került. Kezelje a leállítást és a `files_error`-et anélkül, hogy sikeresnek jelentené a címzettnek.

A fájlok ezen az eszközön maradnak, amíg külön nem osztják meg vagy töltik fel.

Mi működik most

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.

A munkafolyamat felépítése

Használja az alább elérhető béta műveleteket, és tesztelje az eredményt a céleszközein.

Ezek a példák olyan alkalmazásrekordokat használnak, mint a Lesson, Message és Order. Cserélje ki őket saját adat típusokra és elemnevekre. A példaként megadott média címeket saját fájljaival kell helyettesíteni.

  1. Állítson be document_context = Current User's unique id értéket, vagy egy stabil értéket a fiókhoz és jelentéshez. Válassza ki accepted_mime_types_json, max_files és max_file_bytes.

  2. Futtassa a Pick files parancsot, vagy használja a Load local source-t egy a Fotószerkesztő vagy Rekordertól származó olvasható fájlhoz. selection_changed után olvassa be a megfelelő fájllistákat; Select picked file egy indexet választ.

  3. Futtassa a Save selection locally parancsot. files_saved után tartsa a saved_file_ids értéket az alkalmazás helyi mellékletrekordjában. List saved files megjeleníti a mentett másolatokat; Restore saved file megnyitja a kiválasztott mentett azonosítót.

  4. A Share selected file megnyitja a rendszer megosztási menüt. A share_sheet_closed csak azt jelenti, hogy a menü bezárult. A Delete saved copy a kiválasztott azonosítót és a confirm=yes-t igényli.

Munkafolyamat diagram — nem alkalmazás képernyőkép

Egyszeri beállítás

Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt. Válassza ki a Xodera Offline Files Native-t, másolja a kulcsát, majd nyissa meg a Bubble → Plugins → Xodera Offline Files Native-t, és illessze be a licensing_api_key-be. Mentse el egyszer; ezután használja az alábbi műveleteket. Minden bővítmény minden projektben saját kulccsal rendelkezik.

Használjon natív alkalmazást a kiválasztott fájlok eléréséhez. Állítson be egy stabil document_context értéket a fiókhoz vagy jelentéshez, hogy a mentett fájlok helyesen csoportosuljanak.

Egyszeri beállítás
  1. Hozzon létre vagy válasszon egy Bubble alkalmazásprojektet a BestPlugins → Dashboard → Plugins alatt.
  2. Válassza ki ezt a bővítményt, és másolja a projekt kulcsát.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Adja hozzá az elemet, válassza ki az alkalmazásadatait, és építse fel az alábbi munkafolyamatot.
  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.
Telepítés és előfizetés

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.

Eredmény mentése az alkalmazásodba

Példa LocalAttachment: tulajdonos, document_context, mentett fájlazonosító, display_name, mime_type és size_bytes. Ez az azonosító csak ugyanazon az eszközön és ugyanahhoz a fiókhoz vagy jelentéshez működik. Online melléklet esetén töltse fel a fájlt egy külön munkafolyamattal, és mentse el a visszakapott online fájl hivatkozást.

Hiba, megszakítás és helyreállítás

Egy megszakított választó operation_cancelled értéket ad vissza; nem küldi el az űrlapot. Amíg native_pending=yes, várja meg, hogy a fájlválasztó vagy megosztási menü bezáruljon, mielőtt újat nyitna. Clear session törli a jelenlegi kiválasztást, de megtartja a mentett másolatokat. Ha egy fájl hiányzik, engedje a felhasználónak, hogy újra kiválassza.

Képességek és korlátok

Válasszon egyszerre 1–20 fájlokat. Fájlonkénti korlát: 1 byte–256 MiB, alacsonyabb korlát is beállítható. A fájltípus-szűrők nem ellenőrzik a fájlokat vírusok szempontjából. Az eszköz fájlazonosítói és útvonalai nem működnek felhőletöltési hivatkozásként. A helyi másolatok nem titkosított tárolók, és elveszhetnek, ha az alkalmazás adatai törlődnek.

Beállítások, műveletek és eredmények

Használja ezeket a neveket a Bubble-ben. A tervezett funkciók külön vannak jelölve.

Elérhető béta beállítások

Elem beállítások

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

Állapotok

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

Események

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Műveletek és azok bemenetei

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
Elem beállítások · 16
source_uritext · Alapértelmezett: ""
Példaértékfile:///app-cache/report.pdf
Példa Bubble kifejezésPhoto Editor's output_uri
Olvasható fájlhely ezen az eszközön, amelyet a kiválasztója vagy egy másik bővítmény ad vissza.
display_nametext · Alapértelmezett: ""
Példaértékreport-photo.jpg
Példa Bubble kifejezésSelected Attachment's display_name
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
mime_typetext · Alapértelmezett: ""
Példaértékimage/jpeg
Példa Bubble kifejezésPhoto Editor's output_mime
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
document_contexttext · Alapértelmezett: "default"
Példaérték<current-user-id>
Példa Bubble kifejezésCurrent User's unique id
Stabil érték ehhez a fiókhoz vagy rekordhoz. Használja ugyanazt az értéket a mentett fájlok vagy vázlatok visszaállításakor.
selected_file_idtext · Alapértelmezett: ""
Példaérték<returned saved file ID>
Példa Bubble kifejezésSelected LocalAttachment's local_file_id
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
accepted_mime_types_jsontext · Alapértelmezett: "[\"*/*\"]"
Példaérték["image/*","application/pdf"]
Példa Bubble kifejezésReport Settings' accepted_mime_types_json
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
multipleyes_no · Alapértelmezett: false
Példaértékyes
Példa Bubble kifejezésReport Settings' allow_multiple_attachments
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
copy_to_cacheyes_no · Alapértelmezett: true
Példaértékyes
Példa Bubble kifejezésReport Settings' copy_to_cache
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
max_filesnumber · Alapértelmezett: 20
Példaérték5
Példa Bubble kifejezésReport Settings' attachment_limit
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
max_file_bytesnumber · Alapértelmezett: 268435456
Példaérték10485760
Példa Bubble kifejezésReport Settings' max_attachment_bytes
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
is_activeyes_no · Alapértelmezett: true
Példaértékyes
Példa Bubble kifejezésGuideHost's view_is_active (your yes/no custom state)
Állítsa igent, amíg ez a nézet nyitva van. Állítsa nemet a kilépéskor, hogy a lejátszás vagy a jelenlegi munka leállhasson.
disabledyes_no · Alapértelmezett: false
Példaértékno
Példa Bubble kifejezésGuideHost's is_busy (your yes/no custom state)
Tiltja le az elemet, amíg az alkalmazás foglalt vagy a művelet nem érhető el.
show_controlsyes_no · Alapértelmezett: true
Példaértékyes
Példa Bubble kifejezésApp Settings' show_editor_controls
Beépített vezérlők megjelenítése vagy elrejtése.
languagetext · Alapértelmezett: "auto"
Példaértékuk
Példa Bubble kifejezésCurrent User's preferred_language
Állítsa be a language=auto-t, hogy egy támogatott eszköz vagy böngésző nyelvét kövesse. Adjon meg egy támogatott nyelvkódot a kifejezett kiválasztáshoz.
ui_text_jsontext · Alapértelmezett: ""
Példaérték{}
Példa Bubble kifejezésApp Settings' player_labels_json (supported keys only)
Választható JSON a támogatott gombcímkékkel. Hagyja üresen a beépített szöveg használatához.
titletext · Alapértelmezett: ""
PéldaértékLesson 4 — review
Példa Bubble kifejezésSelected Lesson's name
Látható alkalmazás szöveg; üres esetén a beépített lokalizált szöveg kerül felhasználásra, ahol támogatott. Nincsenek hitelesítő adatok.
Műveletek és azok bemenetei · 10
Pick files

Nincsenek műveletparaméterek

Load local source
source_uritext · Alapértelmezett: —
Példaértékfile:///app-cache/report.pdf
Példa Bubble kifejezésPhoto Editor's output_uri
Olvasható fájlhely ezen az eszközön, amelyet a kiválasztója vagy egy másik bővítmény ad vissza.
display_nametext · Alapértelmezett: —
Példaértékreport-photo.jpg
Példa Bubble kifejezésSelected Attachment's display_name
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
mime_typetext · Alapértelmezett: —
Példaértékimage/jpeg
Példa Bubble kifejezésPhoto Editor's output_mime
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Select picked file
indexnumber · Alapértelmezett: —
Példaérték0
Példa Bubble kifejezésSelected row's current_source_index
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Save selection locally

Nincsenek műveletparaméterek

List saved files

Nincsenek műveletparaméterek

Restore saved file
file_idtext · Alapértelmezett: —
Példaérték<returned saved file ID>
Példa Bubble kifejezésSelected LocalAttachment's local_file_id
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Delete saved copy
file_idtext · Alapértelmezett: —
Példaérték<returned saved file ID>
Példa Bubble kifejezésSelected LocalAttachment's local_file_id
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
confirmyes_no · Alapértelmezett: —
Példaértékyes — explicit confirmation only
Példa Bubble kifejezésConfirm Checkbox is checked
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Share selected file
dialog_titletext · Alapértelmezett: —
PéldaértékShare attachment
Példa Bubble kifejezésSelected Report's share_title
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
utitext · Alapértelmezett: —
Példaérték""
Példa Bubble kifejezésEmpty unless your iOS integration supplies a proven UTI
Használja az aktuális üzleti rekord értékét; ellenőrizze a lenti határok szerint.
Cancel operation

Nincsenek műveletparaméterek

Clear session

Nincsenek műveletparaméterek

Állapotok és események

Állapotok

status · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

is_busy · yes_no

A munka még folyamatban van. Várjon, mielőtt újabb műveletet indítana.

native_pending · yes_no

A munka még folyamatban van. Várjon, mielőtt újabb műveletet indítana.

operation · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

selection_count · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

selected_index · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

file_id · text

Az elem vagy művelet azonosítója. Tartsa meg a megfelelő alkalmazásrekorddal. Használja ugyanazt a kérésazonosítót bizonytalan eredmény újrapróbálásakor.

local_uri · text

Fájl helye ezen az eszközön. Mentse vagy töltse fel a fájlt külön, ha online kell maradnia.

display_name · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

mime_type · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

mime_source · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

size_bytes · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

is_saved_locally · yes_no

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

file_ids · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

file_uris · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

file_names · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

file_mime_types · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

file_sizes · number (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

files_json · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

saved_count · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

saved_file_ids · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

saved_file_uris · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

saved_file_names · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

saved_file_mime_types · text (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

saved_file_sizes · number (lista)

A kiválasztott fájlok listája. Azonos indexű elemek a többi fájllistában ugyanarra a fájlra vonatkoznak.

saved_files_json · text

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

invalid_saved_count · number

A kiválasztott elem jelenlegi értéke. Olvassa el a kapcsolódó esemény után.

share_status · text

A művelet jelenlegi eredménye. Használja a megfelelő befejezési eseményt a siker mentése előtt.

error_code · text

Hibainformáció az utolsó műveletről. Mutasson hasznos üzenetet és kínálja a megfelelő újrapróbálást.

Események

selection_changed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

files_saved

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

list_loaded

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

file_restored

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

file_deleted

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

share_sheet_closed

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

operation_cancelled

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

files_error

Amikor ez az esemény bekövetkezik, olvassa ki a kapcsolódó állapotokat ugyanabból az elemből.

Fejlesztők által feltett kérdések

A Megosztás jelentése „elküldve”?

Nem. Az operációs rendszer itt nem biztosít megbízható címzett-siker visszaigazolást. Mutassa a „megosztási lap bezárult” üzenetet.

Hogyan működik az előfizetés?

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.

Kapcsolódó útmutatók

Segítségért mondja el, melyik plugint és eszközt használja, milyen műveletet próbált és mi történt. Használjon személyes adatokat nem tartalmazó példát. Soha ne ossza meg a kulcsát vagy privát fájljait.