Kiolesura cha Offline Files.
Kiolesura cha Offline Files.
← Miongozo yote ya Bubble Native

Xodera Plugins · Bubble Native

Xodera Offline Files Native

Hifadhi viambatisho vya ripoti na faili zilizochaguliwa kwenye kifaa, zirejeshe baadaye na ruhusu mtumiaji kushiriki nakala iliyochaguliwa.

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.

Nyaraka zilizokaguliwa 6 Novemba 2026

Mifano ya vitendo

Panga viambatisho kadhaa vya ndani kabla ya kutuma ripoti

Fomu inahitaji kuonyesha faili zilizochaguliwa na kuruhusu mtumiaji kuweka nakala iliyosimamiwa kabla ya usambazaji wowote wa wingu.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; weka `max_files`, `max_file_bytes` na akaunti/ripoti `document_context`.

Pick files → kagua majina/ukubwa yaliyochaguliwa → Save selection locally. Fomu yako huhifadhi vitambulisho vya faili vilivyotokana hadi mtiririko tofauti wa Submit upakie faili zilizoidhinishwa.

Tumia `selection_count`, `file_names`, `file_sizes` na `saved_file_ids` ili kuonyesha orodha ya mapitio. Nakala inayosimamiwa iliyohifadhiwa haiandiki juu ya faili asili iliyotolewa.

Kichagua kilichoghairi si ripoti iliyowasilishwa. Katika `files_error`, hifadhi vitambulisho vya ndani vilivyokubaliwa tayari na onyesha `error_code`; usiunde kiambatisho cha wingu kutoka URI ya ndani pekee.

Faili hubaki kwenye kifaa hiki hadi zishirikiwa au kupakiwa kando.

Hifadhi matokeo ya kihariri cha picha au kirekodi sauti kwa matumizi baadaye.

Faili ya ndani iliyozalishwa inaweza kuwepo katika eneo la muda; programu inahitaji nakala iliyosimamiwa wazi.

`source_uri = the local output of a separately accepted editor/recorder`; unganisha `display_name` halisi na `mime_type`; tumia `document_context` ya mmiliki huyo.

Load local source → kagua metadata → Save selection locally. Hifadhi kitambulisho cha faili kilichorudishwa tu katika kifaa/muktadha unaolingana, kisha Restore saved file kwa kitambulisho hicho halisi inapohitajika.

Tumia `file_id`, `local_uri`, `size_bytes` na `is_saved_locally`; tumia `file_restored` kutofautisha urejeshaji ulio kamilika na ombi la urejeshaji tu.

Kataa URL ya mbali ya HTTP kama chanzo cha ndani. Ikiwa chanzo kimepotea au urejeshaji umeshindwa, onyesha `error_code` na hifadhi rekodi ya awali ya programu kwa ajili ya urejeshaji.

Faili hubaki kwenye kifaa hiki hadi zishirikiwa au kupakiwa kando.

Ruhusu mtumiaji kushiriki risiti au faili ya export iliyotengenezwa na programu kwenye kifaa.

Programu inapaswa kutoa faili ya ndani iliyochaguliwa kwa menyu ya kushiriki ya kifaa badala ya kuunda URL ya umma.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; jina lake na MIME zinaelezea faili halisi ya ndani.

List saved files → Restore saved file → Share selected file baada ya mtumiaji kubofya Shiriki. Hifadhi nakala iliyohifadhiwa hadi achague Delete saved copy wazi.

Tumia `share_status` na `share_sheet_closed` kusasisha UI baada ya menyu ya kushiriki kufungwa. Hifadhi kitambulisho cha faili kwa ushirikishaji mwingine wa makusudi.

Kufungwa kwa menyu ya kushiriki si ushahidi kwamba barua pepe au ujumbe umefikishwa. Shughulikia kughairi na `files_error` bila kuripoti kuwa ujumbe umefikishwa kwa mpokeaji.

Faili hubaki kwenye kifaa hiki hadi zishirikiwa au kupakiwa kando.

Kinachofanya kazi sasa

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.

Jenga mtiririko wa kazi

Tumia vitendo vya beta vinavyopatikana hapa chini na jaribu matokeo kwenye vifaa unavyolenga.

Mifano hii inatumia rekodi za programu kama Lesson, Message na Order. Zibadilishe kwa aina zako za data na majina ya vipengele. Anwani za media za mfano lazima zibadilishwe na faili zako.

  1. Weka document_context = Current User's unique id, au thamani thabiti kwa akaunti na ripoti. Chagua accepted_mime_types_json, max_files na max_file_bytes.

  2. Endesha Pick files, au tumia Load local source kwa faili inayoweza kusomwa iliyotengenezwa na Photo Editor au Recorder. Baada ya selection_changed, soma orodha za faili zinazolingana; Select picked file huchagua faharasa.

  3. Endesha Save selection locally. Baada ya files_saved, hifadhi saved_file_ids katika rekodi ya viambatisho vya ndani vya programu yako. List saved files inaonyesha nakala zilizohifadhiwa; Restore saved file inafungua kitambulisho kilichochaguliwa kilichohifadhiwa.

  4. Share selected file hufungua menyu ya kushiriki ya mfumo. share_sheet_closed inamaanisha tu kwamba menyu imefungwa. Delete saved copy inahitaji kitambulisho kilichochaguliwa na confirm=yes.

Mchoro wa mtiririko wa kazi — si picha ya programu

Sanidi mara moja

Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins. Chagua Xodera Offline Files Native, nakili ufunguo wake, kisha fungua Bubble → Plugins → Xodera Offline Files Native na ubandike ndani ya licensing_api_key. Hifadhi mara moja; kisha tumia vitendo hapa chini. Kila plugin katika kila mradi ina ufunguo wake.

Tumia programu ya Bubble Native yenye ufikiaji wa faili zilizochaguliwa. Weka document_context thabiti kwa akaunti au ripoti ili faili zake zilizohifadhiwa ziwe zimepangwa katika makundi sahihi.

Sanidi mara moja
  1. Unda au chagua mradi wako wa Bubble katika BestPlugins → Dashboard → Plugins.
  2. Chagua plugin hii na nakili ufunguo wa mradi wake.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Ongeza kipengele, chagua data ya programu yako na jenga mtiririko wa kazi hapa chini.
  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.
Ufungaji na usajili

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.

Hifadhi matokeo katika programu yako

Mfano LocalAttachment: mmiliki, document_context, kitambulisho cha faili iliyohifadhiwa, display_name, mime_type na size_bytes. Kitambulisho hiki kinatumika tu kwenye kifaa hicho hicho na kwa akaunti au ripoti ile ile. Kwa kiambatisho cha mtandaoni, pakia faili kwa mtiririko tofauti na uhifadhi rejea ya faili ya mtandaoni iliyorejeshwa.

Kushindwa, kughairi na urejeshaji

Kiteuzi kilichoghairiwa kinarejesha operation_cancelled; hakijawasilisha fomu. Wakati native_pending=yes, subiri mpaka kiteuzi cha faili au menyu ya kushiriki ifunge kabla ya kufungua lingine. Clear session husafisha uteuzi wa sasa lakini huhifadhi nakala zilizohifadhiwa. Ikiwa faili haipo, ruhusu mtumiaji iuchague tena.

Uwezo na vikwazo

Chagua faili za 1–20 mara moja. Kikomo cha kila faili: 1 byte–256 MiB, na kikomo cha chini ikiwa utaamua. Vichujio vya aina ya faili havichunguzi faili kutafuta virusi. Kitambulisho cha faili cha kifaa na njia hazifanyi kazi kama viungo vya upakuaji wa wingu. Nakala za ndani si hifadhi iliyosimbwa na zinaweza kupotea ikiwa data ya programu itafutwa.

Mipangilio, vitendo na matokeo

Tumia majina haya katika Bubble. Vipengele vilivyopangwa vimewekwa alama kando.

Mipangilio ya beta inayopatikana

Mipangilio ya kipengele

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

Hali

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

Matukio

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Vitendo na ingizo lake

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
Mipangilio ya kipengele · 16
source_uritext · Chaguo-msingi: ""
Thamani ya mfanofile:///app-cache/report.pdf
Mfano wa usemi BubblePhoto Editor's output_uri
Mahali pa faili inayoweza kusomwa kwenye kifaa hiki, lililorejeshwa na kichagua chako au kiendelezi kingine.
display_nametext · Chaguo-msingi: ""
Thamani ya mfanoreport-photo.jpg
Mfano wa usemi BubbleSelected Attachment's display_name
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
mime_typetext · Chaguo-msingi: ""
Thamani ya mfanoimage/jpeg
Mfano wa usemi BubblePhoto Editor's output_mime
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
document_contexttext · Chaguo-msingi: "default"
Thamani ya mfano<current-user-id>
Mfano wa usemi BubbleCurrent User's unique id
Thamani thabiti kwa akaunti au rekodi hii. Tumia thamani ileile wakati wa kurejesha faili au rasimu zake zilizohifadhiwa.
selected_file_idtext · Chaguo-msingi: ""
Thamani ya mfano<returned saved file ID>
Mfano wa usemi BubbleSelected LocalAttachment's local_file_id
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
accepted_mime_types_jsontext · Chaguo-msingi: "[\"*/*\"]"
Thamani ya mfano["image/*","application/pdf"]
Mfano wa usemi BubbleReport Settings' accepted_mime_types_json
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
multipleyes_no · Chaguo-msingi: false
Thamani ya mfanoyes
Mfano wa usemi BubbleReport Settings' allow_multiple_attachments
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
copy_to_cacheyes_no · Chaguo-msingi: true
Thamani ya mfanoyes
Mfano wa usemi BubbleReport Settings' copy_to_cache
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
max_filesnumber · Chaguo-msingi: 20
Thamani ya mfano5
Mfano wa usemi BubbleReport Settings' attachment_limit
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
max_file_bytesnumber · Chaguo-msingi: 268435456
Thamani ya mfano10485760
Mfano wa usemi BubbleReport Settings' max_attachment_bytes
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
is_activeyes_no · Chaguo-msingi: true
Thamani ya mfanoyes
Mfano wa usemi BubbleGuideHost's view_is_active (your yes/no custom state)
Weka yes (ndiyo) wakati mwonekano huu uko wazi. Weka no (hapana) unapoondoka, ili uchezaji au kazi ya sasa viweze kusimamishwa.
disabledyes_no · Chaguo-msingi: false
Thamani ya mfanono
Mfano wa usemi BubbleGuideHost's is_busy (your yes/no custom state)
Zima kipengele wakati programu yako ina shughuli au kitendo hiki hakipatikani.
show_controlsyes_no · Chaguo-msingi: true
Thamani ya mfanoyes
Mfano wa usemi BubbleApp Settings' show_editor_controls
Onyesha au ficha vidhibiti vilivyojengwa.
languagetext · Chaguo-msingi: "auto"
Thamani ya mfanouk
Mfano wa usemi BubbleCurrent User's preferred_language
Weka language=auto ili kufuata lugha inayotumika ya kifaa au kivinjari. Ingiza msimbo wa lugha inayotumika ili kuichagua mwenyewe.
ui_text_jsontext · Chaguo-msingi: ""
Thamani ya mfano{}
Mfano wa usemi BubbleApp Settings' player_labels_json (supported keys only)
JSON ya hiari yenye lebo za vitufe zinazotumika. Iache tupu ili kutumia maandishi yaliyojengewa ndani.
titletext · Chaguo-msingi: ""
Thamani ya mfanoLesson 4 — review
Mfano wa usemi BubbleSelected Lesson's name
Maandishi yanayoonekana katika programu; ukiacha tupu, maandishi yaliyotafsiriwa na kujengewa ndani hutumika panapoungwa mkono. Usiweke taarifa za siri za kuingia.
Vitendo na ingizo lake · 10
Pick files

Hakuna vigezo vya kitendo

Load local source
source_uritext · Chaguo-msingi: —
Thamani ya mfanofile:///app-cache/report.pdf
Mfano wa usemi BubblePhoto Editor's output_uri
Mahali pa faili inayoweza kusomwa kwenye kifaa hiki, lililorejeshwa na kichagua chako au kiendelezi kingine.
display_nametext · Chaguo-msingi: —
Thamani ya mfanoreport-photo.jpg
Mfano wa usemi BubbleSelected Attachment's display_name
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
mime_typetext · Chaguo-msingi: —
Thamani ya mfanoimage/jpeg
Mfano wa usemi BubblePhoto Editor's output_mime
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Select picked file
indexnumber · Chaguo-msingi: —
Thamani ya mfano0
Mfano wa usemi BubbleSelected row's current_source_index
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Save selection locally

Hakuna vigezo vya kitendo

List saved files

Hakuna vigezo vya kitendo

Restore saved file
file_idtext · Chaguo-msingi: —
Thamani ya mfano<returned saved file ID>
Mfano wa usemi BubbleSelected LocalAttachment's local_file_id
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Delete saved copy
file_idtext · Chaguo-msingi: —
Thamani ya mfano<returned saved file ID>
Mfano wa usemi BubbleSelected LocalAttachment's local_file_id
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
confirmyes_no · Chaguo-msingi: —
Thamani ya mfanoyes — explicit confirmation only
Mfano wa usemi BubbleConfirm Checkbox is checked
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Share selected file
dialog_titletext · Chaguo-msingi: —
Thamani ya mfanoShare attachment
Mfano wa usemi BubbleSelected Report's share_title
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
utitext · Chaguo-msingi: —
Thamani ya mfano""
Mfano wa usemi BubbleEmpty unless your iOS integration supplies a proven UTI
Tumia thamani ya rekodi ya biashara ya sasa; thibitisha dhidi ya mipaka ifuatayo.
Cancel operation

Hakuna vigezo vya kitendo

Clear session

Hakuna vigezo vya kitendo

Hali na matukio

Hali

status · text

Matokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio.

is_busy · yes_no

Kazi bado inaendelea. Subiri kabla ya kuanza kitendo kingine.

native_pending · yes_no

Kazi bado inaendelea. Subiri kabla ya kuanza kitendo kingine.

operation · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

selection_count · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

selected_index · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

file_id · text

Kitambulisho cha kipengele hiki au kitendo. Kihifadhi pamoja na rekodi inayolingana ya programu. Tumia kitambulisho hicho hicho cha ombi wakati wa kujaribu tena matokeo yasiyo na uhakika.

local_uri · text

Mahali pa faili kwenye kifaa hiki. Hifadhi au pakia faili kando ikiwa lazima iwe kwenye mtandaoni.

display_name · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

mime_type · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

mime_source · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

size_bytes · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

is_saved_locally · yes_no

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

file_ids · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

file_uris · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

file_names · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

file_mime_types · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

file_sizes · number (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

files_json · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

saved_count · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

saved_file_ids · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

saved_file_uris · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

saved_file_names · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

saved_file_mime_types · text (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

saved_file_sizes · number (orodha)

Orodha ya faili zilizochaguliwa. Vipengele vilivyoko kwenye faharasa sawa katika orodha zingine za faili vinarejelea faili ile ile.

saved_files_json · text

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

invalid_saved_count · number

Thamani ya sasa ya kipengele kilichochaguliwa. Isome baada ya tukio linalohusiana.

share_status · text

Matokeo ya sasa ya kitendo hiki. Tumia tukio la kukamilika linalolingana kabla ya kuhifadhi mafanikio.

error_code · text

Taarifa ya hitilafu ya kitendo cha mwisho. Onyesha ujumbe wenye msaada na utoe chaguo linalofaa la kujaribu tena.

Matukio

selection_changed

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

files_saved

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

list_loaded

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

file_restored

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

file_deleted

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

share_sheet_closed

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

operation_cancelled

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

files_error

Wakati tukio hili litapotokea, soma hali husika kutoka kwa kipengele hicho.

Maswali yanayoulizwa na wasanidi programu

Je, Share inamaanisha “imetumwa”?

Hapana. Mfumo wa uendeshaji hautoi uthibitisho wa kuaminika hapa kwamba faili imefikishwa kwa mpokeaji. Onyesha “share sheet closed”.

Usajili unafanya kazi vipi?

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.

Miongozo husika

Kwa msaada, tuambie plugin na kifaa unachotumia, kitendo ulichojaribu na kilichotokea. Tumia mfano usio na data binafsi. Usishiriki ufunguo wako wala faili za kibinafsi.