Xodera Plugins · Bubble Native

Xodera B2 Files Native

Simpan lampiran aplikasi dalam storan Backblaze B2 anda sendiri. Benarkan pengguna yang dibenarkan memuat naik, melayari dan memuat turun fail, serta pilih secara jelas bila fail boleh dikongsi secara awam.

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.

Bina aliran kerja ↓Tetapan plugin ↗Native Lab

Dokumentasi disemak 6 November 2026

Contoh praktikal

Simpan lampiran kerja dalam bucket peribadi pemaju sendiri

Sebuah Bubble Job memerlukan rujukan storan yang tahan lama tanpa memperlakukan URL muat turun yang akan tamat tempoh sebagai identiti fail.

`bucket_binding_id = an allowed binding to your own private bucket`; `local_uri` dinamik, `display_name`, `mime_type` dan `expected_size` menerangkan fail tempatan yang dipilih.

Dirancang: Check local source → Upload file → tunggu `upload_verified`. Aliran kerja anda kemudian menyimpan `asset_ref` dan metadata pada rekod Job yang dimiliki.

Gunakan `asset_ref`, `size_bytes`, `mime_type` dan `upload_status`. Kemudian, Resolve private read boleh menyediakan URL sementara untuk penggunaan yang dibenarkan.

Jika simpanan pangkalan data gagal selepas `upload_verified`, cuba lagi kemas kini DB dengan rujukan aset yang sama dan bukannya muat naik lain. Periksa hasil `upload_pending` menggunakan Check or recover upload status dan ID muat naik yang sama.

Dirancang. Akaun B2 anda membayar caj storan dan muat turun.

Bina galeri lampiran milik dengan rekod fail yang tahan lama

Galeri fail memerlukan nama, jenis dan paginasi serta cara untuk membuka aset terpilih kemudian.

Rekod Fail aplikasi anda menyimpan `asset_ref` yang diterima, nama paparan, MIME dan hubungan pemilik/job selepas muat naik yang disahkan; jangan gunakan URI tempatan sebagai identiti awan.

Dirancang: gunakan List my B2 files untuk membina senarai lampiran. asset_refs mengenal pasti fail; nilai pada indeks yang sama memberikan nama dan jenisnya. Memilih fail menghantar asset_ref kepada Get asset metadata atau Download accepted version.

`has_more` dan `next_cursor` termasuk dalam pertanyaan semasa. Muat turun yang selesai mengembalikan `local_output_uri`; ia adalah salinan tempatan peranti, bukan pautan awam kekal.

Tetapkan semula paginasi selepas perubahan ikatan/akaun/pertanyaan. Pada `transfer_error`, kekalkan File Thing yang sedia ada dan tunjukkan `error_code`; jangan diam-diam menggantikannya dengan versi lain pada pihak pembekal.

Dirancang. Akaun B2 anda membayar caj storan dan muat turun.

Jadikan penerbitan dan pemadaman versi tepat secara sengaja

Kakitangan tidak seharusnya secara tidak sengaja mendedahkan lampiran peribadi atau memadam semua versi semasa menggantikan imej.

`asset_ref = the selected accepted version`; ikatan bucket dan kebenaran fail aplikasi mesti membenarkan operasi yang diminta.

Tunjukkan kebolehlihatan semasa, minta pengesahan jelas, kemudian Change public sharing. Untuk penghapusan, panggil Delete accepted version dengan pengesahan; simpan metadata aplikasi sehingga hasil yang disahkan diketahui.

Selepas `share_changed`, gunakan `visibility` dan `public_url` hanya apabila perkongsian awam telah dibenarkan secara jelas. Selepas `delete_completed`, kemas kini rekod Fail yang dimiliki; `delete_pending` bukan pemadaman akhir.

Periksa hasil operasi yang tidak pasti daripada menganggap berjaya. URL bacaan pembekal yang dikeluarkan sebelum ini mungkin tetap sah sehingga tamat tempoh; mengeluarkan baris DB atau mematikan perkongsian tidak menarik semula bait yang sudah dimuat turun.

Dirancang. Akaun B2 anda membayar caj storan dan muat turun.

Apa yang berfungsi sekarang

Pemalam dirancang. Ia belum dipasang atau tersedia untuk digunakan. Panduan di bawah menunjukkan aliran kerja fail yang dimaksudkan.

Bina aliran kerja

Dirancang

Alur kerja yang dirancang. Belum tersedia dalam beta semasa.

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.

Dirancang: dalam tetapan projek anda, pilih storan B2 dan bucket yang dibenarkan. Tetapkan privasinya, awalan folder serta jenis dan saiz fail yang diterima.
Gunakan List B2 bindings untuk memaparkan pilihan storan yang dibenarkan. Gunakan List my B2 files untuk memaparkan fail pengguna semasa dan Get my B2 file info untuk butiran.
Pilih fail. Tetapkan bucket_binding_id, local_uri, display_name, mime_type dan expected_size, kemudian jalankan Upload file. Tunjukkan kemajuan, tetapi tunggu upload_verified sebelum menganggap fail telah disimpan.
Simpan asset_ref dalam rekod aplikasi anda. Gunakan untuk Get asset metadata, Resolve private read atau Download accepted version. Change public sharing dan Delete accepted version memerlukan pengesahan berasingan.

Diagram aliran kerja — bukan tangkapan skrin aplikasi

Konfigurasi sekali

Pengaktifan kunci dirancang untuk plugin ini. Buat atau pilih projek aplikasi Bubble anda dalam BestPlugins → Dashboard → Plugins. Pilih Xodera B2 Files Native, salin kuncinya, kemudian buka Bubble → Plugins → Xodera B2 Files Native dan tampal ke dalam project_api_key. Simpan sekali; kemudian gunakan tindakan di bawah. Setiap plugin dalam setiap projek mempunyai kuncinya sendiri.

Gunakan akaun Backblaze B2 anda sendiri dan pilih bucket untuk aplikasi ini. Tentukan siapa yang boleh membaca dan memuat naik fail. Simpan nama medan Ya/Tidak Pengguna yang berkaitan dalam b2_reader_permission_field dan b2_writer_permission_field; nilai lalai ialah b2_files_reader dan b2_files_writer. Hanya pentadbir yang dibenarkan harus mengubah kebenaran pengguna tersebut.

Konfigurasi sekali

Buat atau pilih projek aplikasi Bubble anda di BestPlugins → Dashboard → Plugins.
Pilih plugin ini dan salin kunci projeknya.
Dirancang: Buka Bubble → Plugins → Xodera B2 Files Native; tampal kunci ke dalam project_api_key dan simpan.
Tambah elemen, pilih data aplikasi anda dan bina alur kerja di bawah.
Akses beta peribadi hanya untuk sekarang. Pemasangan awam dan pengaktifan berbayar belum dibuka.

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

Lampiran Contoh: asset_ref, laporan/pesanan berkaitan, pemilik, display_name, mime_type dan size_bytes. Simpan ini selepas upload_verified. Gunakan asset_ref untuk membuka semula fail kemudian; alamat baca sementara atau laluan pada satu peranti bukan rujukan fail tetap. Jika penyimpanan rekod pangkalan data gagal, cuba semula menyimpan rekod tersebut dan bukannya memuat naik fail lagi.

Kegagalan, pembatalan dan pemulihan

Jika hasil muat naik tidak diketahui, simpan upload_id dan gunakan Check or recover upload status. Jangan muat naik salinan lain secara automatik. Pembatalan mempengaruhi pemindahan yang belum selesai, bukan fail yang sudah disimpan. Jika akses luput, minta fail sekali lagi dan jangan gunakan alamat sementara lama.

Keupayaan dan had

Saiz maksimum fail yang dirancang: 256 MiB, atau had bucket yang lebih rendah mengikut pilihan anda. Caj storan dan muat turun Backblaze menjadi tanggungjawab akaun B2 anda. Fail dalam bucket awam adalah awam walaupun rekod aplikasi yang berkaitan bersifat peribadi. Tiada jaminan pengimbasan virus, muat naik berbilang bahagian, jeda atau pemulihan selepas penamatan aplikasi.

Tetapan, tindakan dan hasil

Gunakan nama-nama ini dalam Bubble. Ciri yang dirancang ditandakan secara berasingan.

Tetapan beta tersedia

Tetapan elemen

bucket_binding_id · textlocal_uri · textdisplay_name · textmime_type · textexpected_size · numbermetadata_json · textasset_ref · textis_active · yes_nodisabled · yes_nolanguage · textui_text_json · texttitle · textshow_preview · yes_noshow_provider_browse · yes_no

Keadaan

status · textis_busy · yes_noupload_id · textupload_status · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numberbytes_sent · numberprogress · numberprogress_indeterminate · yes_notemporary_read_url · textread_expires_at · textlocal_output_uri · textpublic_url · textvisibility · textnext_cursor · texthas_more · yes_noquery_revision · textfiles_json · textbuckets_json · textremote_files_json · textremote_next_cursor · textremote_has_more · yes_noremote_query_revision · textbucket_binding_id · textcleanup_pending · yes_noerror_code · texterror_message · text

Acara

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Tindakan dan inputnya

List allowed bucketsSelect bucket bindingCheck local sourceUpload fileCheck or recover upload statusCancel owned transferClear local sessionList application filesRefresh application filesLoad more application filesSelect asset referenceGet asset metadataResolve private readDownload accepted versionBrowse provider filesChange public sharingDelete accepted version

Tetapan elemen · 14

Alur kerja yang dirancang. Belum tersedia dalam beta semasa.

bucket_binding_idtext · Lalai: "": Nilai contoh<binding returned by List B2 bindings>; Contoh ungkapan BubbleSelected Binding's binding_id; Pilihan storan yang dikembalikan oleh List B2 bindings. Gunakan IDnya untuk fail ini.

local_uritext · Lalai: "": Nilai contohfile:///app-cache/attachment.jpg; Contoh ungkapan BubbleOffline Files' local_uri; Lokasi fail yang boleh dibaca pada peranti ini. Ia bukan pautan muat turun dalam talian.

display_nametext · Lalai: "": Nilai contohreport-photo.jpg; Contoh ungkapan BubbleSelected Attachment's display_name; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

mime_typetext · Lalai: "": Nilai contohimage/jpeg; Contoh ungkapan BubblePhoto Editor's output_mime; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

expected_sizenumber · Lalai: 0: Nilai contoh246975; Contoh ungkapan BubbleOffline Files' size_bytes; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

metadata_jsontext · Lalai: "": Nilai contoh{"label":"field-report"}; Contoh ungkapan BubbleSelected Attachment's safe_metadata_json; JSON pilihan dengan maklumat aplikasi seperti label laporan. Pastikan ia kecil dan elakkan data peribadi.

asset_reftext · Lalai: "": Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

is_activeyes_no · Lalai: true: Nilai contohyes; Contoh ungkapan BubbleGuideHost'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 contohno; Contoh ungkapan BubbleGuideHost's is_busy (your yes/no custom state); Lumpuhkan elemen semasa aplikasi anda sibuk atau tindakan ini tidak tersedia.

languagetext · Lalai: "auto": Nilai contohuk; Contoh ungkapan BubbleCurrent 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 BubbleApp Settings' player_labels_json (supported keys only); JSON pilihan dengan label butang yang disokong. Biarkan kosong untuk menggunakan teks terbina dalam.

titletext · Lalai: "": Nilai contohLesson 4 — review; Contoh ungkapan BubbleSelected Lesson's name; Teks aplikasi yang dipaparkan; jika dikosongkan, teks terbina dalam yang dilokalkan digunakan jika disokong. Jangan masukkan maklumat pengesahan.

show_previewyes_no · Lalai: false: Nilai contohyes; Contoh ungkapan BubbleApp Settings' b2_preview; Tunjuk atau sembunyikan pratonton fail.

show_provider_browseyes_no · Lalai: false: Nilai contohno; Contoh ungkapan BubbleCurrent User's authorized_browse_UI (presentation only); Tunjuk atau sembunyikan kawalan pelayaran storan untuk pengguna yang dibenarkan.

Tindakan dan inputnya · 20

Alur kerja yang dirancang. Belum tersedia dalam beta semasa.

List allowed buckets

Tiada parameter tindakan

Select bucket binding

binding_idtext · Lalai: —: Nilai contoh<returned allowed binding ID>; Contoh ungkapan BubbleSelected Binding's binding_id; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Check local source

Tiada parameter tindakan

Upload file

acknowledge_public_bytesyes_no · Lalai: —: Nilai contohno; Contoh ungkapan BubblePublic bucket disclosure Checkbox is checked (private bucket: no); Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

confirm_retryyes_no · Lalai: —: Nilai contohno; Contoh ungkapan BubbleRetry Checkbox is checked after confirmed clean pending status; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Check or recover upload status

upload_idtext · Lalai: —: Nilai contoh<original returned upload_id>; Contoh ungkapan BubbleCurrent UploadIntent's upload_id; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Cancel owned transfer

Tiada parameter tindakan

Clear local session

Tiada parameter tindakan

List application files

Tiada parameter tindakan

Refresh application files

Tiada parameter tindakan

Load more application files

Tiada parameter tindakan

Select asset reference

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

Get asset metadata

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

Resolve private read

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

Download accepted version

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

Browse provider files

prefixtext · Lalai: —: Nilai contoh""; Contoh ungkapan BubbleAuthorized Browse Settings' prefix; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

load_moreyes_no · Lalai: —: Nilai contohno; Contoh ungkapan BubbleLoad More button only, for unchanged query; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Change public sharing

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

enabledyes_no · Lalai: —: Nilai contohno; Contoh ungkapan BubblePublic Share Checkbox is checked after separate confirmation; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

confirmyes_no · Lalai: —: Nilai contohyes — explicit confirmation only; Contoh ungkapan BubbleConfirm Checkbox is checked; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Delete accepted version

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

confirmyes_no · Lalai: —: Nilai contohyes — explicit confirmation only; Contoh ungkapan BubbleConfirm Checkbox is checked; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

List B2 bindings

environmenttext · Lalai: —: Nilai contohdevelopment; Contoh ungkapan BubbleApp Settings' selected_environment; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Pulangan

ok · yes/nostatus · texterror_code · textbinding_ids · text listlabels · text listprivacy · text listmax_size_bytes · number list

List my B2 files

environmenttext · Lalai: —: Nilai contohdevelopment; Contoh ungkapan BubbleApp Settings' selected_environment; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

binding_idtext · Lalai: —: Nilai contoh<returned allowed binding ID>; Contoh ungkapan BubbleSelected Binding's binding_id; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

limitnumber · Lalai: —: Nilai contoh50; Contoh ungkapan BubbleGallery Settings' page_size; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

cursortext · Lalai: —: Nilai contoh""; Contoh ungkapan BubblePrevious List my B2 files result's next_cursor; empty on first page; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

Pulangan

ok · yes/nostatus · texterror_code · textasset_refs · text listdisplay_names · text listmime_types · text listsize_bytes · number listcreated_ats · text listvisibility · text listpublic_urls · text listprovider_status · text listinspection_status · text listmetadata_labels · text listhas_more · yes/nonext_cursor · textquery_revision · text

Get my B2 file info

environmenttext · Lalai: —: Nilai contohdevelopment; Contoh ungkapan BubbleApp Settings' selected_environment; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

binding_idtext · Lalai: —: Nilai contoh<returned allowed binding ID>; Contoh ungkapan BubbleSelected Binding's binding_id; Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.

asset_reftext · Lalai: —: Nilai contoh<returned asset_ref>; Contoh ungkapan BubbleSelected B2Asset's asset_ref; Identiti aset diterima yang stabil dan tidak telus daripada perkhidmatan. Memilihnya tidak sekali-kali melangkaui kebenaran pengguna.

Pulangan

ok · yes/nostatus · texterror_code · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numbercreated_at · textvisibility · textpublic_url · textprovider_status · textinspection_status · textmetadata_label · text

Keadaan dan peristiwa

Alur kerja yang dirancang. Belum tersedia dalam beta semasa.

Keadaan

status · text

Keputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.

is_busy · yes_no

Kerja masih dalam proses. Tunggu sebelum memulakan tindakan lain.

upload_id · text

Pengenal untuk item atau tindakan ini. Simpan bersama rekod aplikasi yang sepadan. Gunakan pengenal permintaan yang sama semasa mencuba semula hasil yang tidak pasti.

upload_status · text

Keputusan semasa tindakan ini. Gunakan acara selesai yang sepadan sebelum menyimpan kejayaan.

asset_ref · text

Pengenal untuk item atau tindakan ini. Simpan bersama rekod aplikasi yang sepadan. Gunakan pengenal permintaan yang sama semasa mencuba semula hasil yang tidak pasti.

display_name · text