Xodera Plugins · Bubble Native

Xodera B2 Files Native

Uygulama eklerini kendi Backblaze B2 depolamanızda tutun. İzin verilen kullanıcıların dosya yüklemesine, göz atmasına ve indirmesine izin verin ve bir dosyanın ne zaman herkese açık paylaşılabileceğini açıkça seçin.

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.

İş akışını oluşturun ↓Eklenti ayarları ↗Native Lab

6 belgeleri November 2026 incelendi.

Pratik örnekler

Geliştiricinin kendi özel kovasında bir iş ekini depolayın

Bir Bubble İş, süresi dolan indirme URL'sini dosya kimliği olarak değerlendirmeden dayanıklı bir depolama referansına ihtiyaç duyar.

`bucket_binding_id = an allowed binding to your own private bucket`; dinamik `local_uri`, `display_name`, `mime_type` ve `expected_size` seçilen yerel dosyayı tanımlar.

Planlandı: Check local source → Upload file → `upload_verified` beklenir. İş akışınız daha sonra `asset_ref` ve meta verileri sahip olunan İş kaydına depolar.

`asset_ref`, `size_bytes`, `mime_type` ve `upload_status` kullanın. Daha sonra Resolve private read yetkili kullanım için geçici bir URL sağlayabilir.

Veritabanı kaydı `upload_verified` sonrası başarısız olursa, başka bir yükleme yerine aynı varlık referansı ile DB güncellemesini yeniden deneyin. `upload_pending` sonucunu Check or recover upload status ve aynı yükleme kimliğiyle kontrol edin.

Planlandı. B2 hesabınız depolama ve indirme ücretlerini öder.

Dayanıklı dosya kayıtlarıyla sahip olunan ek dosya galerisini oluşturun

Bir dosya galerisinin adlara, türlere, sayfalamaya ve seçilen varlığı daha sonra açma yoluna ihtiyacı vardır.

Uygulamanızın Dosya kaydı, doğrulanmış bir yüklemeden sonra kabul edilen `asset_ref`, görüntüleme adı, MIME ve sahip/iş ilişkisini depolar; yerel URI'yi bulut kimliği olarak kullanmayın.

Planlandı: ek dosya listesini oluşturmak için List my B2 files kullanın. asset_refs dosyaları tanımlar; aynı indeksdeki değerler adlarını ve türlerini sağlar. Bir dosya seçildiğinde, onun asset_ref'i Get asset metadata veya Download accepted version'e iletilir.

`has_more` ve `next_cursor` mevcut sorguya aittir. Tamamlanmış bir indirme `local_output_uri`'i döndürür; bu, cihazda yerel bir kopyadır, kalıcı bir genel bağlantı değildir.

Bağlama/hesap/sorgu değişikliklerinden sonra sayfalamayı sıfırlayın. `transfer_error` üzerinde mevcut Dosya Nesnesini koruyun ve `error_code`'i gösterin; sessizce başka bir sağlayıcı sürümüyle değiştirmeyin.

Planlandı. B2 hesabınız depolama ve indirme ücretlerini öder.

Yayınlamayı ve kesin sürüm silmeyi kasıtlı hale getirin

Personel, bir görüntüyü değiştirirken özel bir eki yanlışlıkla ortaya çıkarmamalı veya tüm sürümleri silmemelidir.

`asset_ref = the selected accepted version`; kova bağlaması ve uygulamanın dosya izinleri istenen işlemi izin vermelidir.

Mevcut görünürlüğü gösterin, açık onay isteyin, ardından Change public sharing yapın. Kaldırma için, onayla birlikte Delete accepted version'i çağırın; onaylı sonuç bilinene kadar uygulama meta verilerini tutun.

`share_changed`'den sonra, yalnızca kamu paylaşımı açıkça yetkilendirildiğinde `visibility` ve `public_url`'i tüketin. `delete_completed`'den sonra, sahip olunan Dosya kaydını güncelleyin; `delete_pending` son silme değildir.

Başarı varsaymak yerine belirsiz bir işlemin sonucunu kontrol edin. Daha önce verilen sağlayıcı okuma URL'leri süresi dolana kadar geçerli kalabilir; bir DB satırını kaldırmak veya paylaşımı devre dışı bırakmak zaten indirilmiş baytları geri alamaz.

Planlandı. B2 hesabınız depolama ve indirme ücretlerini öder.

Şu anda çalışanlar

Planlanan eklenti. Henüz kurulmuş veya kullanıma hazır değil. Aşağıdaki kılavuz, amaçlanan dosya iş akışını gösterir.

İş akışını oluşturun

Planlandı

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

Bu örnekler Lesson, Message ve Order gibi uygulama kayıtlarını kullanır. Bunları kendi veri tipleriniz ve öğe adlarınızla değiştirin. Örnek medya adresleri kendi dosyalarınızla değiştirilmelidir.

Planlandı: proje ayarlarınızda B2 depolamanızı ve izin verilen kovayı seçin. Gizliliğini, klasör önekini ve kabul edilen dosya türlerini ve boyutlarını ayarlayın.
İzin verilen depolama seçeneklerini göstermek için List B2 bindings'yi kullanın. Mevcut kullanıcının dosyalarını göstermek için List my B2 files'yi ve ayrıntılar için Get my B2 file info'yi kullanın.
Bir dosya seçin. bucket_binding_id, local_uri, display_name, mime_type ve expected_size'yi ayarlayın, ardından Upload file'yi çalıştırın. İlerlemeyi gösterin, ancak dosyayı kaydedilmiş olarak kabul etmeden önce upload_verified'yi bekleyin.
asset_ref'yi uygulama kaydınızda kaydedin. Get asset metadata, Resolve private read veya Download accepted version için kullanın. Change public sharing ve Delete accepted version ayrı bir onay gerektirir.

İş akışı diyagramı — uygulama ekran görüntüsü değil

Bir kez yapılandırın

Bu eklenti için anahtar etkinleştirme planlanıyor. BestPlugins → Dashboard → Plugins içinde Bubble uygulama projenizi oluşturun veya seçin. Xodera B2 Files Native'yi seçin, anahtarını kopyalayın, ardından Bubble → Plugins → Xodera B2 Files Native'yi açın ve project_api_key içine yapıştırın. Bir kez kaydedin; ardından aşağıdaki eylemleri kullanın. Her proje içindeki her eklentinin kendi anahtarı vardır.

Kendi Backblaze B2 hesabınızı kullanın ve bu uygulama için kovayı seçin. Dosyaları kimlerin okuyabileceğine ve yükleyebileceğine karar verin. İlgili Kullanıcı evet/hayır alanlarının adlarını b2_reader_permission_field ve b2_writer_permission_field içinde saklayın; varsayılanlar b2_files_reader ve b2_files_writer'tir. Yalnızca yetkili bir yönetici bu kullanıcı izinlerini değiştirmelidir.

Bir kez yapılandırın

Bubble uygulama projenizi BestPlugins → Dashboard → Plugins içinde oluşturun veya seçin.
Bu eklentiyi seçin ve proje anahtarını kopyalayın.
Planlandı: Bubble → Plugins → Xodera B2 Files Native'yi açın; anahtarı project_api_key'ye yapıştırın ve kaydedin.
Öğeyi ekleyin, uygulama verilerinizi seçin ve aşağıdaki iş akışını oluşturun.
Şimdilik yalnızca özel beta erişimi. Genel kurulum ve ücretli aktivasyon henüz açık değil.

Kurulum ve abonelik

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.

Sonucu uygulamanıza kaydedin

Örnek Ek: asset_ref, ilgili rapor/sipariş, sahibi, display_name, mime_type ve size_bytes. Bunları upload_verified sonrası kaydedin. Daha sonra bir dosyayı yeniden açmak için asset_ref'yi kullanın; geçici bir okuma adresi veya bir cihazdaki yol kalıcı bir dosya referansı değildir. Veritabanı kaydı kaydedilemezse, dosyayı tekrar yüklemek yerine o kaydı yeniden kaydetmeyi deneyin.

Başarısızlık, iptal ve kurtarma

Yükleme sonucu bilinmiyorsa, upload_id'yi tutun ve Check or recover upload status'yi kullanın. Başka bir kopyayı otomatik olarak yüklemeyin. İptal, tamamlanmamış aktarımı etkiler, zaten kaydedilmiş bir dosyayı değil. Erişim süresi dolarsa, eski geçici adresi yeniden kullanmak yerine dosyayı yeniden isteyin.

Yetenekler ve sınırlamalar

Planlanan maksimum dosya boyutu: 256 MiB, veya seçtiğiniz daha düşük kova limiti. Backblaze depolama ve indirme ücretleri B2 hesabınıza aittir. Genel bir kovadaki dosyalar, ilgili uygulama kaydı özel olsa bile genel olarak görünür. Virüs tarama garantisi, çok parçalı yükleme, duraklatma veya uygulama sonlandırıldıktan sonra kurtarma yok.

Ayarlar, eylemler ve sonuçlar

Bu adları Bubble içinde kullanın. Planlanan özellikler ayrı olarak işaretlenmiştir.

Kullanılabilir beta ayarları

Öğe ayarları

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

Durumlar

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

Olaylar

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Eylemler ve girdileri

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

Öğe ayarları · 14

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

bucket_binding_idtext · Varsayılan: "": Örnek değer<binding returned by List B2 bindings>; Örnek Bubble ifadesiSelected Binding's binding_id; List B2 bindings tarafından döndürülen depolama seçimi. Bu dosya için kimliğini kullanın.

local_uritext · Varsayılan: "": Örnek değerfile:///app-cache/attachment.jpg; Örnek Bubble ifadesiOffline Files' local_uri; Bu cihazdaki okunabilir dosya konumu. Bu bir çevrimiçi indirme bağlantısı değildir.

display_nametext · Varsayılan: "": Örnek değerreport-photo.jpg; Örnek Bubble ifadesiSelected Attachment's display_name; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

mime_typetext · Varsayılan: "": Örnek değerimage/jpeg; Örnek Bubble ifadesiPhoto Editor's output_mime; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

expected_sizenumber · Varsayılan: 0: Örnek değer246975; Örnek Bubble ifadesiOffline Files' size_bytes; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

metadata_jsontext · Varsayılan: "": Örnek değer{"label":"field-report"}; Örnek Bubble ifadesiSelected Attachment's safe_metadata_json; Rapor etiketi gibi uygulama bilgileri içeren isteğe bağlı JSON. Küçük tutun ve kişisel verilerden kaçının.

asset_reftext · Varsayılan: "": Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

is_activeyes_no · Varsayılan: true: Örnek değeryes; Örnek Bubble ifadesiGuideHost's view_is_active (your yes/no custom state); Bu görünüm açıkken evet ayarlayın. Ayrılırken hayır ayarlayın, böylece oynatma veya mevcut çalışma durabilir.

disabledyes_no · Varsayılan: false: Örnek değerno; Örnek Bubble ifadesiGuideHost's is_busy (your yes/no custom state); Uygulamanız meşgulken veya bu eylem kullanılamazken öğeyi devre dışı bırakın.

languagetext · Varsayılan: "auto": Örnek değeruk; Örnek Bubble ifadesiCurrent User's preferred_language; language=auto'yi desteklenen bir cihazı veya tarayıcı dilini izlemek için ayarlayın. Açıkça seçmek için desteklenen bir dil kodu girin.

ui_text_jsontext · Varsayılan: "": Örnek değer{}; Örnek Bubble ifadesiApp Settings' player_labels_json (supported keys only); Desteklenen düğme etiketleriyle isteğe bağlı JSON. Yerleşik metni kullanmak için boş bırakın.

titletext · Varsayılan: "": Örnek değerLesson 4 — review; Örnek Bubble ifadesiSelected Lesson's name; Görünür uygulama metni; boş bırakıldığında destekleniyorsa yerleşik yerelleştirilmiş kopya kullanılır. Kimlik bilgileri yok.

show_previewyes_no · Varsayılan: false: Örnek değeryes; Örnek Bubble ifadesiApp Settings' b2_preview; Dosya önizlemesini göster veya gizle.

show_provider_browseyes_no · Varsayılan: false: Örnek değerno; Örnek Bubble ifadesiCurrent User's authorized_browse_UI (presentation only); İzin verilen kullanıcılar için depolama gezinme kontrollerini göster veya gizle.

Eylemler ve girdileri · 20

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

List allowed buckets

Eylem parametresi yok

Select bucket binding

binding_idtext · Varsayılan: —: Örnek değer<returned allowed binding ID>; Örnek Bubble ifadesiSelected Binding's binding_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Check local source

Eylem parametresi yok

Upload file

acknowledge_public_bytesyes_no · Varsayılan: —: Örnek değerno; Örnek Bubble ifadesiPublic bucket disclosure Checkbox is checked (private bucket: no); Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

confirm_retryyes_no · Varsayılan: —: Örnek değerno; Örnek Bubble ifadesiRetry Checkbox is checked after confirmed clean pending status; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Check or recover upload status

upload_idtext · Varsayılan: —: Örnek değer<original returned upload_id>; Örnek Bubble ifadesiCurrent UploadIntent's upload_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Cancel owned transfer

Eylem parametresi yok

Clear local session

Eylem parametresi yok

List application files

Eylem parametresi yok

Refresh application files

Eylem parametresi yok

Load more application files

Eylem parametresi yok

Select asset reference

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

Get asset metadata

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

Resolve private read

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

Download accepted version

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

Browse provider files

prefixtext · Varsayılan: —: Örnek değer""; Örnek Bubble ifadesiAuthorized Browse Settings' prefix; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

load_moreyes_no · Varsayılan: —: Örnek değerno; Örnek Bubble ifadesiLoad More button only, for unchanged query; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Change public sharing

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

enabledyes_no · Varsayılan: —: Örnek değerno; Örnek Bubble ifadesiPublic Share Checkbox is checked after separate confirmation; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

confirmyes_no · Varsayılan: —: Örnek değeryes — explicit confirmation only; Örnek Bubble ifadesiConfirm Checkbox is checked; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

Delete accepted version

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

confirmyes_no · Varsayılan: —: Örnek değeryes — explicit confirmation only; Örnek Bubble ifadesiConfirm Checkbox is checked; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

List B2 bindings

environmenttext · Varsayılan: —: Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

İadeler

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

List my B2 files

environmenttext · Varsayılan: —: Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

binding_idtext · Varsayılan: —: Örnek değer<returned allowed binding ID>; Örnek Bubble ifadesiSelected Binding's binding_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

limitnumber · Varsayılan: —: Örnek değer50; Örnek Bubble ifadesiGallery Settings' page_size; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

cursortext · Varsayılan: —: Örnek değer""; Örnek Bubble ifadesiPrevious List my B2 files result's next_cursor; empty on first page; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

İadeler

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 · Varsayılan: —: Örnek değerdevelopment; Örnek Bubble ifadesiApp Settings' selected_environment; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

binding_idtext · Varsayılan: —: Örnek değer<returned allowed binding ID>; Örnek Bubble ifadesiSelected Binding's binding_id; Mevcut iş kaydının değerini kullanın; aşağıdaki sınırlara karşı doğrulayın.

asset_reftext · Varsayılan: —: Örnek değer<returned asset_ref>; Örnek Bubble ifadesiSelected B2Asset's asset_ref; Servisten gelen sabit, opak kabul edilmiş varlık kimliği. Seçmek, kullanıcı yetkilendirmesini asla atlamaz.

İadeler

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

Durumlar ve olaylar

Planlanan iş akışı. Şu anki beta sürümünde henüz mevcut değil.

Durumlar

status · text

Bu eylemin mevcut sonucu. Başarıyı kaydetmeden önce eşleşen tamamlama olayını kullanın.

is_busy · yes_no

İş hâlâ devam ediyor. Başka bir eyleme başlamadan önce bekleyin.

upload_id · text

Bu öğe veya eylem için tanımlayıcı. Eşleşen uygulama kaydıyla birlikte tutun. Belirsiz bir sonucu yeniden denerken aynı istek tanımlayıcısını kullanın.

upload_status · text

Bu eylemin mevcut sonucu. Başarıyı kaydetmeden önce eşleşen tamamlama olayını kullanın.

asset_ref · text

Bu öğe veya eylem için tanımlayıcı. Eşleşen uygulama kaydıyla birlikte tutun. Belirsiz bir sonucu yeniden denerken aynı istek tanımlayıcısını kullanın.

display_name · text