Xodera Plugins · Bubble Native
Xodera Offline Files Native
Simpan lampiran laporan dan fail terpilih pada peranti, pulihkan kemudian dan benarkan pengguna berkongsi salinan terpilih.
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.
Dokumentasi disemak 6 November 2026
Contoh praktikal
Susun beberapa lampiran setempat sebelum menghantar laporan
Borang perlu memaparkan fail yang dipilih dan membenarkan pengguna menyimpan salinan terurus sebelum sebarang penghantaran ke awan.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; tetapkan `max_files`, `max_file_bytes` dan akaun/laporan `document_context`.
Pick files → periksa nama/saiz terpilih → Save selection locally. Borang anda menyimpan ID fail yang terhasil sehingga aliran kerja Submit berasingan memuat naik fail yang diluluskan.
Gunakan `selection_count`, `file_names`, `file_sizes` dan `saved_file_ids` untuk memaparkan senarai untuk semakan. Salinan terurus yang disimpan mengekalkan fail asal pihak pemanggil.
Pemilih yang dibatalkan bukan laporan yang dihantar. Pada `files_error`, kekalkan ID tempatan yang sudah diterima dan paparkan `error_code`; jangan sekali-kali mencipta lampiran awan daripada URI tempatan sahaja.
Fail kekal pada peranti ini sehingga dikongsi atau dimuat naik secara berasingan.
Simpan output penyunting foto atau perakam untuk kegunaan kemudian
Fail tempatan yang dijana mungkin berada di lokasi sementara; aplikasi memerlukan salinan terurus yang jelas.
`source_uri = the local output of a separately accepted editor/recorder`; ikat `display_name` dan `mime_type` yang sebenar; gunakan `document_context` pemilik yang sama.
Load local source → periksa metadata → Save selection locally. Simpan ID fail yang dikembalikan hanya dalam peranti/konteks yang sepadan, kemudian Restore saved file dengan ID tepat itu bila diperlukan.
Gunakan `file_id`, `local_uri`, `size_bytes` dan `is_saved_locally`; gunakan `file_restored` untuk membezakan pemulihan selesai daripada sekadar permintaan.
Tolak URL HTTP jauh sebagai sumber tempatan. Jika sumber hilang atau pemulihan gagal, paparkan `error_code` dan kekalkan rekod aplikasi asal untuk pemulihan.
Fail kekal pada peranti ini sehingga dikongsi atau dimuat naik secara berasingan.
Benarkan pengguna berkongsi resit tempatan yang dijana aplikasi atau eksport
Aplikasi harus menyerahkan fail tempatan terpilih kepada helaian kongsi peranti dan bukannya mencipta URL awam.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; namanya dan MIME menerangkan fail tempatan yang sebenar.
List saved files → Restore saved file → Share selected file selepas pengguna menekan Kongsi. Simpan salinan yang disimpan sehingga mereka secara jelas memilih Delete saved copy.
Gunakan `share_status` dan `share_sheet_closed` untuk mengemas kini UI selepas helaian ditutup. Simpan ID fail untuk perkongsian sengaja yang lain.
Helaian kongsi yang ditutup bukan bukti bahawa penerima telah menerima e-mel/mesej. Tangani pembatalan dan `files_error` tanpa melaporkan bahawa penghantaran kepada penerima berjaya.
Fail kekal pada peranti ini sehingga dikongsi atau dimuat naik secara berasingan.
Apa yang berfungsi sekarang
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.
Bina aliran kerja
Gunakan tindakan beta yang tersedia di bawah dan uji hasilnya pada peranti sasaran anda.
Contoh-contoh ini menggunakan rekod aplikasi seperti Lesson, Message dan Order. Gantikan mereka dengan jenis data dan nama elemen anda sendiri. Alamat media contoh mesti diganti dengan fail anda sendiri.
Tetapkan document_context = Current User's unique id, atau nilai stabil untuk akaun dan laporan. Pilih accepted_mime_types_json, max_files dan max_file_bytes.
Jalankan Pick files, atau gunakan Load local source untuk fail boleh baca yang dihasilkan oleh Penyunting Foto atau Rakaman. Selepas selection_changed, baca senarai fail yang sepadan; Select picked file memilih indeks.
Jalankan Save selection locally. Selepas files_saved, simpan saved_file_ids dalam rekod lampiran setempat aplikasi anda. List saved files memaparkan salinan tersimpan; Restore saved file membuka ID tersimpan yang dipilih.
Share selected file membuka menu perkongsian sistem. share_sheet_closed hanya bermakna menu ditutup. Delete saved copy memerlukan ID terpilih dan confirm=yes.
Konfigurasi sekali
Buat atau pilih projek aplikasi Bubble anda dalam BestPlugins → Dashboard → Plugins. Pilih Xodera Offline Files Native, salin kuncinya, kemudian buka Bubble → Plugins → Xodera Offline Files Native dan tampal ke dalam licensing_api_key. Simpan sekali; kemudian gunakan tindakan di bawah. Setiap plugin dalam setiap projek mempunyai kunci masing‑masing.
Gunakan aplikasi asli dengan akses kepada fail terpilih. Tetapkan document_context yang stabil untuk akaun atau laporan supaya fail yang disimpan dikelompokkan dengan betul.
Konfigurasi sekali
- Buat atau pilih projek aplikasi Bubble anda di BestPlugins → Dashboard → Plugins.
- Pilih plugin ini dan salin kunci projeknya.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Tambah elemen, pilih data aplikasi anda dan bina alur kerja di bawah.
- 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.
Pemasangan dan langganan
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.
Simpan hasil dalam aplikasi anda
Contoh LocalAttachment: pemilik, document_context, ID fail tersimpan, display_name, mime_type dan size_bytes. ID ini berfungsi hanya pada peranti yang sama dan untuk akaun atau laporan yang sama. Untuk lampiran dalam talian, muat naik fail dengan aliran kerja berasingan dan simpan rujukan fail dalam talian yang dikembalikan.
Kegagalan, pembatalan dan pemulihan
Pemilih yang dibatalkan mengembalikan operation_cancelled; ia tidak menghantar borang. Semasa native_pending=yes, tunggu menu pemilih fail atau perkongsian ditutup sebelum membuka yang lain. Clear session membersihkan pilihan semasa tetapi mengekalkan salinan tersimpan. Jika fail tiada, benarkan pengguna memilihnya semula.
Keupayaan dan had
Pilih fail 1–20 sekaligus. Had per fail: 1 bait–256 MiB, dengan had lebih rendah jika anda pilih. Penapis jenis fail tidak memeriksa virus. ID dan laluan fail peranti tidak berfungsi sebagai pautan muat turun awan. Salinan setempat bukan storan terenkripsi dan boleh hilang jika data aplikasi dipadam.
Tetapan, tindakan dan hasil
Gunakan nama-nama ini dalam Bubble. Ciri yang dirancang ditandakan secara berasingan.
Tetapan beta tersedia
Tetapan elemen
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 · textKeadaan
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 (senarai)file_uris · text (senarai)file_names · text (senarai)file_mime_types · text (senarai)file_sizes · number (senarai)files_json · textsaved_count · numbersaved_file_ids · text (senarai)saved_file_uris · text (senarai)saved_file_names · text (senarai)saved_file_mime_types · text (senarai)saved_file_sizes · number (senarai)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textAcara
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorTindakan dan inputnya
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionTetapan elemen · 16
source_uritext · Lalai: ""- Nilai contoh
file:///app-cache/report.pdf - Contoh ungkapan Bubble
Photo Editor's output_uri - Lokasi fail yang boleh dibaca pada peranti ini, dipulangkan oleh pemilih anda atau plugin lain.
display_nametext · Lalai: ""- Nilai contoh
report-photo.jpg - Contoh ungkapan Bubble
Selected Attachment's display_name - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
mime_typetext · Lalai: ""- Nilai contoh
image/jpeg - Contoh ungkapan Bubble
Photo Editor's output_mime - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
document_contexttext · Lalai: "default"- Nilai contoh
<current-user-id> - Contoh ungkapan Bubble
Current User's unique id - Nilai stabil untuk akaun atau rekod ini. Gunakan nilai yang sama semasa memulihkan fail atau draf yang disimpan.
selected_file_idtext · Lalai: ""- Nilai contoh
<returned saved file ID> - Contoh ungkapan Bubble
Selected LocalAttachment's local_file_id - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
accepted_mime_types_jsontext · Lalai: "[\"*/*\"]"- Nilai contoh
["image/*","application/pdf"] - Contoh ungkapan Bubble
Report Settings' accepted_mime_types_json - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
multipleyes_no · Lalai: false- Nilai contoh
yes - Contoh ungkapan Bubble
Report Settings' allow_multiple_attachments - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
copy_to_cacheyes_no · Lalai: true- Nilai contoh
yes - Contoh ungkapan Bubble
Report Settings' copy_to_cache - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
max_filesnumber · Lalai: 20- Nilai contoh
5 - Contoh ungkapan Bubble
Report Settings' attachment_limit - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
max_file_bytesnumber · Lalai: 268435456- Nilai contoh
10485760 - Contoh ungkapan Bubble
Report Settings' max_attachment_bytes - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
is_activeyes_no · Lalai: true- Nilai contoh
yes - Contoh ungkapan Bubble
GuideHost's view_is_active (your yes/no custom state) - Tetapkan ya semasa pandangan ini dibuka. Tetapkan tidak apabila keluar, supaya main semula atau kerja semasa dapat dihentikan.
disabledyes_no · Lalai: false- Nilai contoh
no - Contoh ungkapan Bubble
GuideHost's is_busy (your yes/no custom state) - Lumpuhkan elemen semasa aplikasi anda sibuk atau tindakan ini tidak tersedia.
show_controlsyes_no · Lalai: true- Nilai contoh
yes - Contoh ungkapan Bubble
App Settings' show_editor_controls - Tunjukkan atau sembunyikan kawalan terbina.
languagetext · Lalai: "auto"- Nilai contoh
uk - Contoh ungkapan Bubble
Current User's preferred_language - Tetapkan language=auto untuk mengikuti peranti atau bahasa pelayar yang disokong. Masukkan kod bahasa yang disokong untuk memilihnya secara eksplisit.
ui_text_jsontext · Lalai: ""- Nilai contoh
{} - Contoh ungkapan Bubble
App Settings' player_labels_json (supported keys only) - JSON pilihan dengan label butang yang disokong. Biarkan kosong untuk menggunakan teks terbina dalam.
titletext · Lalai: ""- Nilai contoh
Lesson 4 — review - Contoh ungkapan Bubble
Selected Lesson's name - Teks aplikasi yang dipaparkan; jika dikosongkan, teks terbina dalam yang dilokalkan digunakan jika disokong. Jangan masukkan maklumat pengesahan.
Tindakan dan inputnya · 10
Pick files
Tiada parameter tindakan
Load local source
source_uritext · Lalai: —- Nilai contoh
file:///app-cache/report.pdf - Contoh ungkapan Bubble
Photo Editor's output_uri - Lokasi fail yang boleh dibaca pada peranti ini, dipulangkan oleh pemilih anda atau plugin lain.
display_nametext · Lalai: —- Nilai contoh
report-photo.jpg - Contoh ungkapan Bubble
Selected Attachment's display_name - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
mime_typetext · Lalai: —- Nilai contoh
image/jpeg - Contoh ungkapan Bubble
Photo Editor's output_mime - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Select picked file
indexnumber · Lalai: —- Nilai contoh
0 - Contoh ungkapan Bubble
Selected row's current_source_index - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Save selection locally
Tiada parameter tindakan
List saved files
Tiada parameter tindakan
Restore saved file
file_idtext · Lalai: —- Nilai contoh
<returned saved file ID> - Contoh ungkapan Bubble
Selected LocalAttachment's local_file_id - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Delete saved copy
file_idtext · Lalai: —- Nilai contoh
<returned saved file ID> - Contoh ungkapan Bubble
Selected LocalAttachment's local_file_id - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
confirmyes_no · Lalai: —- Nilai contoh
yes — explicit confirmation only - Contoh ungkapan Bubble
Confirm Checkbox is checked - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Share selected file
dialog_titletext · Lalai: —- Nilai contoh
Share attachment - Contoh ungkapan Bubble
Selected Report's share_title - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
utitext · Lalai: —- Nilai contoh
"" - Contoh ungkapan Bubble
Empty unless your iOS integration supplies a proven UTI - Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Cancel operation
Tiada parameter tindakan
Clear session
Tiada parameter tindakan
Keadaan dan peristiwa
Keadaan
status · textKeputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.
is_busy · yes_noKerja masih dalam proses. Tunggu sebelum memulakan tindakan lain.
native_pending · yes_noKerja masih dalam proses. Tunggu sebelum memulakan tindakan lain.
operation · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
selection_count · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
selected_index · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
file_id · textPengenal untuk item atau tindakan ini. Simpan bersama rekod aplikasi yang sepadan. Gunakan pengenal permintaan yang sama semasa mencuba semula hasil yang tidak pasti.
local_uri · textLokasi fail pada peranti ini. Simpan atau muat naik fail secara berasingan jika ia perlu disimpan dalam talian.
display_name · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
mime_type · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
mime_source · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
size_bytes · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
is_saved_locally · yes_noNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
file_ids · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
file_uris · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
file_names · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
file_mime_types · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
file_sizes · number (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
files_json · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
saved_count · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
saved_file_ids · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
saved_file_uris · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
saved_file_names · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
saved_file_mime_types · text (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
saved_file_sizes · number (senarai)Senarai untuk fail terpilih. Item pada indeks yang sama dalam senarai fail lain merujuk kepada fail yang sama.
saved_files_json · textNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
invalid_saved_count · numberNilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.
share_status · textKeputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.
error_code · textMaklumat ralat untuk tindakan terakhir. Tunjukkan mesej bantuan dan tawarkan percubaan semula yang relevan.
Acara
selection_changedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
files_savedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
list_loadedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
file_restoredApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
file_deletedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
share_sheet_closedApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
operation_cancelledApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
files_errorApabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.
Soalan yang ditanya pembangun
Adakah Share bermaksud “dihantar”?
Tidak. OS tidak menyediakan resit kejayaan penerima yang boleh dipercayai di sini. Paparkan “share sheet closed”.
Bagaimana langganan berfungsi?
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.
Panduan berkaitan
Untuk bantuan, beritahu kami plugin dan peranti yang anda gunakan, tindakan yang anda cuba serta apa yang terjadi. Gunakan contoh tanpa data peribadi. Jangan sekali-kali kongsikan kunci atau fail peribadi anda.