Xodera Plugins · Bubble Native

Xodera B2 Files Native

Simpan lampiran aplikasi di penyimpanan Backblaze B2 milik Anda. Izinkan pengguna yang diizinkan mengunggah, menelusuri, dan mengunduh file, serta pilih secara eksplisit kapan file dapat dibagikan secara publik.

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.

Buat alur kerja ↓Pengaturan plugin ↗Native Lab

Dokumentasi ditinjau 6 November 2026

Contoh praktis

Simpan lampiran pekerjaan di bucket pribadi milik pengembang

Sebuah Pekerjaan Bubble membutuhkan referensi penyimpanan yang tahan lama tanpa memperlakukan URL unduhan yang kedaluwarsa sebagai identitas file.

`bucket_binding_id = an allowed binding to your own private bucket`; `local_uri` dinamis, `display_name`, `mime_type`, dan `expected_size` menggambarkan file lokal yang dipilih.

Direncanakan: Check local source → Upload file → tunggu `upload_verified`. Alur kerja Anda kemudian menyimpan `asset_ref` dan metadata pada catatan Pekerjaan yang dimiliki.

Gunakan `asset_ref`, `size_bytes`, `mime_type`, dan `upload_status`. Nanti, Resolve private read dapat menyediakan URL sementara untuk penggunaan yang diotorisasi.

Jika penyimpanan basis data gagal setelah `upload_verified`, coba lagi pembaruan DB dengan referensi aset yang sama alih-alih unggahan lain. Periksa hasil `upload_pending` menggunakan Check or recover upload status dan ID unggahan yang sama.

Direncanakan. Akun B2 Anda membayar biaya penyimpanan dan unduhan.

Buat galeri lampiran milik dengan catatan file yang tahan lama

Galeri file memerlukan nama, tipe, dan paginasi serta cara untuk membuka aset yang dipilih nanti.

Catatan File aplikasi Anda menyimpan `asset_ref` yang diterima, nama tampilan, MIME, dan hubungan pemilik/pekerjaan setelah unggahan terverifikasi; jangan gunakan URI lokal sebagai identitas cloud-nya.

Direncanakan: gunakan List my B2 files untuk membangun daftar lampiran. asset_refs mengidentifikasi file; nilai pada indeks yang sama memberikan nama dan tipe mereka. Memilih file mengirim asset_ref ke Get asset metadata atau Download accepted version.

`has_more` dan `next_cursor` termasuk dalam kueri saat ini. Unduhan yang selesai mengembalikan `local_output_uri`; itu adalah salinan lokal perangkat, bukan tautan publik permanen.

Setel ulang paginasi setelah perubahan binding/akun/kueri. Pada `transfer_error`, pertahankan File Thing yang ada dan tampilkan `error_code`; jangan diam-diam menggantinya dengan versi penyedia lain.

Direncanakan. Akun B2 Anda membayar biaya penyimpanan dan unduhan.

Jadikan publikasi dan penghapusan versi tepat sebagai tindakan yang disengaja

Staf tidak boleh secara tidak sengaja mengekspos lampiran pribadi atau menghapus semua versi saat mengganti gambar.

`asset_ref = the selected accepted version`; binding bucket dan izin file aplikasi harus mengizinkan operasi yang diminta.

Tampilkan visibilitas saat ini, minta konfirmasi eksplisit, lalu Change public sharing. Untuk penghapusan, panggil Delete accepted version dengan konfirmasi; pertahankan metadata aplikasi sampai hasil yang dikonfirmasi diketahui.

Setelah `share_changed`, gunakan `visibility` dan `public_url` hanya ketika berbagi publik secara eksplisit diotorisasi. Setelah `delete_completed`, perbarui catatan File yang dimiliki; `delete_pending` bukan penghapusan akhir.

Periksa hasil operasi yang tidak pasti alih-alih mengasumsikan keberhasilan. URL baca penyedia yang sebelumnya dikeluarkan mungkin tetap berlaku hingga kedaluwarsa; menghapus baris DB atau menonaktifkan berbagi tidak menarik kembali byte yang sudah diunduh.

Direncanakan. Akun B2 Anda membayar biaya penyimpanan dan unduhan.

Apa yang berfungsi sekarang

Plugin yang direncanakan. Belum terpasang atau tersedia untuk digunakan. Panduan di bawah menunjukkan alur kerja file yang dimaksud.

Buat alur kerja

Direncanakan

Alur kerja yang direncanakan. Belum tersedia dalam beta saat ini.

Contoh-contoh ini menggunakan catatan aplikasi seperti Lesson, Message, dan Order. Ganti mereka dengan tipe data dan nama elemen Anda sendiri. Alamat media contoh harus diganti dengan file Anda sendiri.

Direncanakan: dalam pengaturan proyek Anda, pilih penyimpanan B2 dan bucket yang diizinkan. Atur privasinya, awalan folder, serta tipe dan ukuran file yang diterima.
Gunakan List B2 bindings untuk menampilkan pilihan penyimpanan yang diizinkan. Gunakan List my B2 files untuk menampilkan file pengguna saat ini dan Get my B2 file info untuk detail.
Pilih file. Atur bucket_binding_id, local_uri, display_name, mime_type, dan expected_size, lalu jalankan Upload file. Tampilkan progres, tetapi tunggu upload_verified sebelum menganggap file telah disimpan.
Simpan asset_ref dalam catatan aplikasi Anda. Gunakan untuk Get asset metadata, Resolve private read, atau Download accepted version. Change public sharing dan Delete accepted version memerlukan konfirmasi terpisah.

Diagram alur kerja — bukan tangkapan layar aplikasi

Konfigurasi sekali saja

Aktivasi kunci direncanakan untuk plugin ini. Buat atau pilih proyek aplikasi Bubble Anda di BestPlugins → Dashboard → Plugins. Pilih Xodera B2 Files Native, salin kuncinya, lalu buka Bubble → Plugins → Xodera B2 Files Native dan tempelkan ke project_api_key. Simpan sekali; kemudian gunakan aksi di bawah. Setiap plugin dalam setiap proyek memiliki kunci masing‑masing.

Gunakan akun Backblaze B2 Anda sendiri dan pilih bucket untuk aplikasi ini. Tentukan siapa yang dapat membaca dan mengunggah file. Simpan nama bidang Ya/Tidak pengguna yang relevan di b2_reader_permission_field dan b2_writer_permission_field; nilai default adalah b2_files_reader dan b2_files_writer. Hanya administrator yang berwenang yang boleh mengubah izin pengguna tersebut.

Konfigurasi sekali saja

Buat atau pilih proyek aplikasi Bubble Anda di BestPlugins → Dashboard → Plugins.
Pilih plugin ini dan salin kunci proyeknya.
Direncanakan: Buka Bubble → Plugins → Xodera B2 Files Native; tempelkan kunci ke project_api_key dan simpan.
Tambahkan elemen, pilih data aplikasi Anda, dan bangun alur kerja di bawah ini.
Akses beta pribadi hanya untuk saat ini. Instalasi publik dan aktivasi berbayar belum dibuka.

Instalasi 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 di aplikasi Anda

Contoh Lampiran: asset_ref, laporan/pesanan terkait, pemilik, display_name, mime_type, dan size_bytes. Simpan ini setelah upload_verified. Gunakan asset_ref untuk membuka kembali file nanti; alamat baca sementara atau jalur pada satu perangkat bukan referensi file permanen. Jika penyimpanan catatan basis data gagal, coba lagi menyimpan catatan tersebut alih-alih mengunggah file lagi.

Kegagalan, pembatalan, dan pemulihan

Jika hasil unggahan tidak diketahui, pertahankan upload_id dan gunakan Check or recover upload status. Jangan mengunggah salinan lain secara otomatis. Membatalkan memengaruhi transfer yang belum selesai, bukan file yang sudah disimpan. Jika akses kedaluwarsa, minta file lagi alih-alih menggunakan kembali alamat sementara lama.

Kemampuan dan batasan

Ukuran file maksimum yang direncanakan: 256 MiB, atau batas bucket lebih rendah yang Anda pilih. Biaya penyimpanan dan unduhan Backblaze menjadi milik akun B2 Anda. File dalam bucket publik bersifat publik meskipun catatan aplikasi terkait bersifat pribadi. Tidak ada jaminan pemindaian virus, unggahan multipart, jeda, atau pemulihan setelah aplikasi dihentikan.

Pengaturan, tindakan, dan hasil

Gunakan nama-nama ini di Bubble. Fitur yang direncanakan ditandai secara terpisah.

Pengaturan beta yang tersedia

Pengaturan 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

Status

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

Pengaturan elemen · 14

Alur kerja yang direncanakan. Belum tersedia dalam beta saat ini.

bucket_binding_idtext · Bawaan: "": Nilai contoh<binding returned by List B2 bindings>; Contoh ekspresi BubbleSelected Binding's binding_id; Pilihan penyimpanan yang dikembalikan oleh List B2 bindings. Gunakan ID-nya untuk file ini.

local_uritext · Bawaan: "": Nilai contohfile:///app-cache/attachment.jpg; Contoh ekspresi BubbleOffline Files' local_uri; Lokasi file yang dapat dibaca pada perangkat ini. Itu bukan tautan unduhan daring.

display_nametext · Bawaan: "": Nilai contohreport-photo.jpg; Contoh ekspresi BubbleSelected Attachment's display_name; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

mime_typetext · Bawaan: "": Nilai contohimage/jpeg; Contoh ekspresi BubblePhoto Editor's output_mime; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

expected_sizenumber · Bawaan: 0: Nilai contoh246975; Contoh ekspresi BubbleOffline Files' size_bytes; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

metadata_jsontext · Bawaan: "": Nilai contoh{"label":"field-report"}; Contoh ekspresi BubbleSelected Attachment's safe_metadata_json; JSON opsional dengan informasi aplikasi seperti label laporan. Jaga tetap kecil dan hindari data pribadi.

asset_reftext · Bawaan: "": Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

is_activeyes_no · Bawaan: true: Nilai contohyes; Contoh ekspresi BubbleGuideHost's view_is_active (your yes/no custom state); Setel ya saat tampilan ini terbuka. Setel tidak saat keluar, sehingga pemutaran atau pekerjaan saat ini dapat berhenti.

disabledyes_no · Bawaan: false: Nilai contohno; Contoh ekspresi BubbleGuideHost's is_busy (your yes/no custom state); Nonaktifkan elemen saat aplikasi Anda sibuk atau tindakan ini tidak tersedia.

languagetext · Bawaan: "auto": Nilai contohuk; Contoh ekspresi BubbleCurrent User's preferred_language; Set language=auto untuk mengikuti perangkat atau bahasa peramban yang didukung. Masukkan kode bahasa yang didukung untuk memilihnya secara eksplisit.

ui_text_jsontext · Bawaan: "": Nilai contoh{}; Contoh ekspresi BubbleApp Settings' player_labels_json (supported keys only); JSON opsional dengan label tombol yang didukung. Biarkan kosong untuk menggunakan teks bawaan.

titletext · Bawaan: "": Nilai contohLesson 4 — review; Contoh ekspresi BubbleSelected Lesson's name; Teks aplikasi yang terlihat; kosong akan menggunakan salinan terlokalisasi bawaan bila didukung. Tanpa kredensial.

show_previewyes_no · Bawaan: false: Nilai contohyes; Contoh ekspresi BubbleApp Settings' b2_preview; Tampilkan atau sembunyikan pratinjau berkas.

show_provider_browseyes_no · Bawaan: false: Nilai contohno; Contoh ekspresi BubbleCurrent User's authorized_browse_UI (presentation only); Tampilkan atau sembunyikan kontrol penelusuran penyimpanan untuk pengguna yang diizinkan.

Tindakan dan inputnya · 20

Alur kerja yang direncanakan. Belum tersedia dalam beta saat ini.

List allowed buckets

Tidak ada parameter aksi

Select bucket binding

binding_idtext · Bawaan: —: Nilai contoh<returned allowed binding ID>; Contoh ekspresi BubbleSelected Binding's binding_id; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Check local source

Tidak ada parameter aksi

Upload file

acknowledge_public_bytesyes_no · Bawaan: —: Nilai contohno; Contoh ekspresi BubblePublic bucket disclosure Checkbox is checked (private bucket: no); Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

confirm_retryyes_no · Bawaan: —: Nilai contohno; Contoh ekspresi BubbleRetry Checkbox is checked after confirmed clean pending status; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Check or recover upload status

upload_idtext · Bawaan: —: Nilai contoh<original returned upload_id>; Contoh ekspresi BubbleCurrent UploadIntent's upload_id; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Cancel owned transfer

Tidak ada parameter aksi

Clear local session

Tidak ada parameter aksi

List application files

Tidak ada parameter aksi

Refresh application files

Tidak ada parameter aksi

Load more application files

Tidak ada parameter aksi

Select asset reference

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

Get asset metadata

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

Resolve private read

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

Download accepted version

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

Browse provider files

prefixtext · Bawaan: —: Nilai contoh""; Contoh ekspresi BubbleAuthorized Browse Settings' prefix; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

load_moreyes_no · Bawaan: —: Nilai contohno; Contoh ekspresi BubbleLoad More button only, for unchanged query; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Change public sharing

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

enabledyes_no · Bawaan: —: Nilai contohno; Contoh ekspresi BubblePublic Share Checkbox is checked after separate confirmation; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

confirmyes_no · Bawaan: —: Nilai contohyes — explicit confirmation only; Contoh ekspresi BubbleConfirm Checkbox is checked; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Delete accepted version

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

confirmyes_no · Bawaan: —: Nilai contohyes — explicit confirmation only; Contoh ekspresi BubbleConfirm Checkbox is checked; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

List B2 bindings

environmenttext · Bawaan: —: Nilai contohdevelopment; Contoh ekspresi BubbleApp Settings' selected_environment; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Pengembalian

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

List my B2 files

environmenttext · Bawaan: —: Nilai contohdevelopment; Contoh ekspresi BubbleApp Settings' selected_environment; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

binding_idtext · Bawaan: —: Nilai contoh<returned allowed binding ID>; Contoh ekspresi BubbleSelected Binding's binding_id; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

limitnumber · Bawaan: —: Nilai contoh50; Contoh ekspresi BubbleGallery Settings' page_size; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

cursortext · Bawaan: —: Nilai contoh""; Contoh ekspresi BubblePrevious List my B2 files result's next_cursor; empty on first page; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

Pengembalian

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 · Bawaan: —: Nilai contohdevelopment; Contoh ekspresi BubbleApp Settings' selected_environment; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

binding_idtext · Bawaan: —: Nilai contoh<returned allowed binding ID>; Contoh ekspresi BubbleSelected Binding's binding_id; Gunakan nilai catatan bisnis saat ini; validasi terhadap batas di bawah.

asset_reftext · Bawaan: —: Nilai contoh<returned asset_ref>; Contoh ekspresi BubbleSelected B2Asset's asset_ref; Identitas aset yang diterima yang stabil dan tidak transparan dari layanan. Memilihnya tidak pernah melewati otorisasi pengguna.

Pengembalian

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

Status dan peristiwa

Alur kerja yang direncanakan. Belum tersedia dalam beta saat ini.

Status

status · text

Hasil saat ini dari tindakan ini. Gunakan peristiwa penyelesaian yang cocok sebelum menyimpan keberhasilan.

is_busy · yes_no

Pekerjaan masih dalam proses. Tunggu sebelum memulai tindakan lain.

upload_id · text

Pengidentifikasi untuk item atau tindakan ini. Simpan bersama catatan aplikasi yang cocok. Gunakan pengidentifikasi permintaan yang sama saat mencoba kembali hasil yang tidak pasti.

upload_status · text

Hasil saat ini dari tindakan ini. Gunakan peristiwa penyelesaian yang cocok sebelum menyimpan keberhasilan.

asset_ref · text

Pengidentifikasi untuk item atau tindakan ini. Simpan bersama catatan aplikasi yang cocok. Gunakan pengidentifikasi permintaan yang sama saat mencoba kembali hasil yang tidak pasti.

display_name · text