Xodera Plugins · Bubble Native

Xodera B2 Files Native

Konservu aldonaĵojn de la aplikaĵo en via propra Backblaze B2-stokado. Permesu al permesitaj uzantoj alŝuti, foliumi kaj elŝuti dosierojn, kaj klare elekti kiam dosiero povas esti publike dividita.

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.

Kreu la laborfluon ↓Kromaĵaj agordoj ↗Native Lab

Dokumentado reviziita 6 novembro 2026

Praktikaj ekzemploj

Konservu aldonaĵon de tasko en la propra privata bucket de la programisto

Bubble Job bezonas daŭran stokreferencon, sen trakti elŝutan URL-on kun limigita validotempo kiel la identecon de la dosiero.

`bucket_binding_id = an allowed binding to your own private bucket`; dinamikaj `local_uri`, `display_name`, `mime_type` kaj `expected_size` priskribas la elektitan lokan dosieron.

Planita: Check local source → Upload file → atendu `upload_verified`. Via laborfluo poste konservas `asset_ref` kaj metadatumojn en la posedata registro Job.

Uzu `asset_ref`, `size_bytes`, `mime_type` kaj `upload_status`. Poste, Resolve private read povas provizi provizoran URL-on por aŭtorizita uzo.

Se konservado en la datumbazo malsukcesas post `upload_verified`, reprovu la DB-ĝisdatigon per la sama dosierreferenco anstataŭ fari alian alŝuton. Kontrolu la rezulton de `upload_pending` per Check or recover upload status kaj la sama alŝuta ID.

Planita. Via B2-konto pagas stokadon kaj elŝutokostojn.

Kreu posedatan aldonaĵan galerion kun daŭraj dosierregistroj.

Dosiergalerio bezonas nomojn, tipojn kaj paĝigadon, kaj ankaŭ manieron malfermi la elektitan aktivaĵon poste.

La registro File de via aplikaĵo konservas akceptitan `asset_ref`, montran nomon, MIME kaj rilaton al posedanto/Job post kontrolita alŝuto; ne uzu lokan URI-on kiel ĝian nuban identecon.

Planita: uzu List my B2 files por konstrui la aldonliston. asset_refs identigas la dosierojn; valoroj ĉe la sama indekso provizas iliajn nomojn kaj tipojn. Elekti dosieron transdonas ĝian asset_ref al Get asset metadata aŭ Download accepted version.

`has_more` kaj `next_cursor` apartenas al la nuna datumserĉo. Finita elŝuto redonas `local_output_uri`; ĝi estas kopio loka al la aparato, ne permanenta publika ligilo.

Restarigu paĝigadon post ŝanĝoj de ligado/konto/datumserĉo. Ĉe `transfer_error`, konservu la ekzistantan File Thing kaj montru `error_code`; ne silente anstataŭigu ĝin per alia versio de la provizanto.

Planita. Via B2-konto pagas stokadon kaj elŝutokostojn.

Faru publikigon kaj forigon de preciza versio intencaj.

Personaro ne devus akcidente eksponi privatan aldonon aŭ forigi ĉiun version kiam ili anstataŭas bildon.

`asset_ref = the selected accepted version`; sitela bindado kaj la dosierpermesoj de la aplikaĵo devas permesi la petitan operacion.

Montru la aktualan videblecon, petu eksplicitan konfirmon, poste Change public sharing. Por forigo, alvoku Delete accepted version kun konfirmo; konservu aplikaĵajn metadatenojn ĝis la konfirmita rezulto estas konata.

Post `share_changed`, uzu `visibility` kaj `public_url` nur kiam publika kunhavigo estis eksplicite rajtigita. Post `delete_completed`, ĝisdatigu la posedatan registron File; `delete_pending` ne estas fina forigo.

Kontrolu la rezulton de operacio kun necerta rezulto anstataŭ supozi sukceson. Legaj URL-oj antaŭe eldonitaj de la provizanto povas resti validaj ĝis la limdato; forigo de DB-vico aŭ malŝalto de kunhavigo ne revokas bajtojn jam elŝutitajn.

Planita. Via B2-konto pagas stokadon kaj elŝutokostojn.

Kio funkcias nun

Planita kromaĵo. Ĝi ankoraŭ ne estas instalita aŭ disponebla por uzo. La suba gvidilo montras la celitan dosieran laborfluon.

Kreu la laborfluon

Planita

Planita laborfluo. Ankoraŭ ne disponebla en la nuna beta.

Ĉi tiuj ekzemploj uzas aplikaĵajn rekordojn kiel Lesson, Message kaj Order. Anstataŭigu ilin per viaj propraj datumtipoj kaj elementnomoj. Ekzemplaj aŭdvida adresoj devas esti anstataŭigitaj per viaj propraj dosieroj.

Planita: en la agordoj de via projekto, elektu vian B2-stokadon kaj permesitan sitelon. Agordu ĝian privatecon, dosierujan prefikson kaj akceptitajn dosiertipojn kaj grandecojn.
Uzu List B2 bindings por montri permesitajn stokajn elektojn. Uzu List my B2 files por montri la dosierojn de la nuna uzanto kaj Get my B2 file info por detaloj.
Elektu dosieron. Agordu bucket_binding_id, local_uri, display_name, mime_type kaj expected_size, poste ruligu Upload file. Montru progreson, sed atendu upload_verified antaŭ konsideri la dosieron konservita.
Konservu asset_ref en via aplikaĵa registro. Uzu ĝin por Get asset metadata, Resolve private read aŭ Download accepted version. Change public sharing kaj Delete accepted version postulas apartan konfirmon.

Laborflua diagramo — ne aplikaĵa ekrankopio

Agordu unufoje

Ŝlosila aktivigo estas planita por ĉi tiu kromaĵo. Kreu aŭ elektu vian Bubble-aplikaĵan projekton en BestPlugins → Dashboard → Plugins. Elektu Xodera B2 Files Native, kopiu ĝian ŝlosilon, tiam malfermu Bubble → Plugins → Xodera B2 Files Native kaj algluu ĝin en project_api_key. Konservu unufoje; poste uzu la subajn agojn. Ĉiu kromaĵo en ĉiu projekto havas sian propran ŝlosilon.

Uzu vian propran Backblaze B2-konton kaj elektu la sitelon por ĉi tiu aplikaĵo. Decidu kiu povas legi kaj alŝuti dosierojn. Konservu la nomojn de la koncernaj uzantaj jes/ne kampoj en b2_reader_permission_field kaj b2_writer_permission_field; aprioraj valoroj estas b2_files_reader kaj b2_files_writer. Nur rajtigita administranto devus ŝanĝi tiujn uzantajn permesojn.

Agordu unufoje

Kreu aŭ elektu vian Bubble-aplikaĵan projekton ĉe BestPlugins → Dashboard → Plugins.
Elektu ĉi tiun kromaĵon kaj kopiu ĝian projektan ŝlosilon.
Planita: Malfermu Bubble → Plugins → Xodera B2 Files Native; algluu la ŝlosilon en project_api_key kaj konservu.
Aldonu la elementon, elektu viajn aplikaĵajn datumojn kaj konstruu la suban laborfluon.
Privata beta-aliro nur por nun. Publika instalado kaj paga aktivigo ankoraŭ ne estas disponeblaj.

Instalado kaj abono

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.

Konservu la rezulton en via aplikaĵo

Ekzemplo Attachment: asset_ref, rilata raporto/mendo, owner, display_name, mime_type kaj size_bytes. Konservu ĉi tiujn post upload_verified. Uzu asset_ref por remalfermi la dosieron poste; provizora legadreso aŭ vojo sur unu aparato ne estas permanenta dosierreferenco. Se konservado de la datumbaza registro malsukcesas, reprovu konservi tiun registron anstataŭ denove alŝuti la dosieron.

Malsukceso, nuligo kaj restaŭro

Se alŝuta rezulto estas nekonata, retenu upload_id kaj uzu Check or recover upload status. Ne alŝutu alian kopion aŭtomate. Nuligo influas la nefinitan transdonon, ne jam konservitan dosieron. Se aliro eksvalidiĝas, petu la dosieron denove anstataŭ reuzi malnovan provizoran adreson.

Kapabloj kaj limoj

Planita maksimuma dosiera grandeco: 256 MiB, aŭ pli malalta sitela limo kiun vi elektas. Backblaze-stokado kaj elŝutaj kotizoj apartenas al via B2-konto. Dosieroj en publika sitelo estas publikaj eĉ kiam la rilata aplikaĵa registro estas privata. Neniu promeso pri virus-scano, multparta alŝuto, paŭzo aŭ restaŭro post aplikaĵa finigo.

Agordoj, agoj kaj rezultoj

Uzu ĉi tiujn nomojn en Bubble. Planitaj funkcioj estas markitaj aparte.

Disponeblaj beta-agordoj

Elementaj agordoj

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

Statoj

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

Eventoj

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Agoj kaj iliaj enigoj

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

Elementaj agordoj · 14

Planita laborfluo. Ankoraŭ ne disponebla en la nuna beta.

bucket_binding_idtext · Defaŭlto: "": Ekzempla valoro<binding returned by List B2 bindings>; Ekzemplo Bubble esprimoSelected Binding's binding_id; Stokelektaĵo revenita de List B2 bindings. Uzu ĝian ID‑on por ĉi tiu dosiero.

local_uritext · Defaŭlto: "": Ekzempla valorofile:///app-cache/attachment.jpg; Ekzemplo Bubble esprimoOffline Files' local_uri; Legebla dosierlokado en ĉi tiu aparato. Ĝi ne estas interreta elŝuta ligilo.

display_nametext · Defaŭlto: "": Ekzempla valororeport-photo.jpg; Ekzemplo Bubble esprimoSelected Attachment's display_name; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

mime_typetext · Defaŭlto: "": Ekzempla valoroimage/jpeg; Ekzemplo Bubble esprimoPhoto Editor's output_mime; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

expected_sizenumber · Defaŭlto: 0: Ekzempla valoro246975; Ekzemplo Bubble esprimoOffline Files' size_bytes; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

metadata_jsontext · Defaŭlto: "": Ekzempla valoro{"label":"field-report"}; Ekzemplo Bubble esprimoSelected Attachment's safe_metadata_json; Opcionala JSON kun aplikaĵaj informoj kiel raporta etikedo. Tenadu ĝin malgranda kaj evitu personajn datumojn.

asset_reftext · Defaŭlto: "": Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

is_activeyes_no · Defaŭlto: true: Ekzempla valoroyes; Ekzemplo Bubble esprimoGuideHost's view_is_active (your yes/no custom state); Agordu jes dum ĉi tiu vido estas malfermita. Agordu ne kiam forlasas, por ke reproduktado aŭ nuna laboro povas ĉesi.

disabledyes_no · Defaŭlto: false: Ekzempla valorono; Ekzemplo Bubble esprimoGuideHost's is_busy (your yes/no custom state); Malebligu la elementon dum via aplikaĵo estas okupata aŭ ĉi tiu ago ne disponeblas.

languagetext · Defaŭlto: "auto": Ekzempla valorouk; Ekzemplo Bubble esprimoCurrent User's preferred_language; Agordu language=auto por sekvi subtenatan lingvon de la aparato aŭ retumilo. Enigu subtenatan lingvokodon por elekti ĝin eksplicite.

ui_text_jsontext · Defaŭlto: "": Ekzempla valoro{}; Ekzemplo Bubble esprimoApp Settings' player_labels_json (supported keys only); Nedeviga JSON kun subtenataj butonetiketoj. Lasu malplena por uzi la enkonstruitan tekston.

titletext · Defaŭlto: "": Ekzempla valoroLesson 4 — review; Ekzemplo Bubble esprimoSelected Lesson's name; Videbla teksto de la aplikaĵo; malplena valoro uzas la enkonstruitan tradukitan tekston, kie tio estas subtenata. Ne enmetu akreditaĵojn.

show_previewyes_no · Defaŭlto: false: Ekzempla valoroyes; Ekzemplo Bubble esprimoApp Settings' b2_preview; Montri aŭ kaŝi la dosieran antaŭrigardon.

show_provider_browseyes_no · Defaŭlto: false: Ekzempla valorono; Ekzemplo Bubble esprimoCurrent User's authorized_browse_UI (presentation only); Montri aŭ kaŝi la stokumajn foliumadajn kontrolojn por permesitaj uzantoj.

Agoj kaj iliaj enigoj · 20

Planita laborfluo. Ankoraŭ ne disponebla en la nuna beta.

List allowed buckets

Neniuj ago-parametroj

Select bucket binding

binding_idtext · Defaŭlto: —: Ekzempla valoro<returned allowed binding ID>; Ekzemplo Bubble esprimoSelected Binding's binding_id; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Check local source

Neniuj ago-parametroj

Upload file

acknowledge_public_bytesyes_no · Defaŭlto: —: Ekzempla valorono; Ekzemplo Bubble esprimoPublic bucket disclosure Checkbox is checked (private bucket: no); Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

confirm_retryyes_no · Defaŭlto: —: Ekzempla valorono; Ekzemplo Bubble esprimoRetry Checkbox is checked after confirmed clean pending status; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Check or recover upload status

upload_idtext · Defaŭlto: —: Ekzempla valoro<original returned upload_id>; Ekzemplo Bubble esprimoCurrent UploadIntent's upload_id; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Cancel owned transfer

Neniuj ago-parametroj

Clear local session

Neniuj ago-parametroj

List application files

Neniuj ago-parametroj

Refresh application files

Neniuj ago-parametroj

Load more application files

Neniuj ago-parametroj

Select asset reference

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

Get asset metadata

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

Resolve private read

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

Download accepted version

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

Browse provider files

prefixtext · Defaŭlto: —: Ekzempla valoro""; Ekzemplo Bubble esprimoAuthorized Browse Settings' prefix; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

load_moreyes_no · Defaŭlto: —: Ekzempla valorono; Ekzemplo Bubble esprimoLoad More button only, for unchanged query; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Change public sharing

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

enabledyes_no · Defaŭlto: —: Ekzempla valorono; Ekzemplo Bubble esprimoPublic Share Checkbox is checked after separate confirmation; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

confirmyes_no · Defaŭlto: —: Ekzempla valoroyes — explicit confirmation only; Ekzemplo Bubble esprimoConfirm Checkbox is checked; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Delete accepted version

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

confirmyes_no · Defaŭlto: —: Ekzempla valoroyes — explicit confirmation only; Ekzemplo Bubble esprimoConfirm Checkbox is checked; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

List B2 bindings

environmenttext · Defaŭlto: —: Ekzempla valorodevelopment; Ekzemplo Bubble esprimoApp Settings' selected_environment; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Redonataj valoroj

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

List my B2 files

environmenttext · Defaŭlto: —: Ekzempla valorodevelopment; Ekzemplo Bubble esprimoApp Settings' selected_environment; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

binding_idtext · Defaŭlto: —: Ekzempla valoro<returned allowed binding ID>; Ekzemplo Bubble esprimoSelected Binding's binding_id; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

limitnumber · Defaŭlto: —: Ekzempla valoro50; Ekzemplo Bubble esprimoGallery Settings' page_size; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

cursortext · Defaŭlto: —: Ekzempla valoro""; Ekzemplo Bubble esprimoPrevious List my B2 files result's next_cursor; empty on first page; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

Redonataj valoroj

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 · Defaŭlto: —: Ekzempla valorodevelopment; Ekzemplo Bubble esprimoApp Settings' selected_environment; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

binding_idtext · Defaŭlto: —: Ekzempla valoro<returned allowed binding ID>; Ekzemplo Bubble esprimoSelected Binding's binding_id; Uzu la valoron de la nuna komerca registro; validigu ĝin kontraŭ la subaj limoj.

asset_reftext · Defaŭlto: —: Ekzempla valoro<returned asset_ref>; Ekzemplo Bubble esprimoSelected B2Asset's asset_ref; Stabila opaka identigilo de akceptita dosiero, donita de la servo. Elekto de ĝi neniam preterpasas la rajtigon de la uzanto.

Redonataj valoroj

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

Statoj kaj eventoj

Planita laborfluo. Ankoraŭ ne disponebla en la nuna beta.

Statoj

status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

is_busy · yes_no

Laboro ankoraŭ progresas. Atendu antaŭ ol komenci alian agon.

upload_id · text

Identigilo por ĉi tiu elemento aŭ ago. Konservu ĝin kun la kongrua registro de la aplikaĵo. Uzu la saman petidentigilon kiam vi reprovas operacion kun necerta rezulto.

upload_status · text

Nuna rezulto de ĉi tiu ago. Uzu la kongruan finigan eventon antaŭ ol konservi sukceson.

asset_ref · text

Identigilo por ĉi tiu elemento aŭ ago. Konservu ĝin kun la kongrua registro de la aplikaĵo. Uzu la saman petidentigilon kiam vi reprovas operacion kun necerta rezulto.

display_name · text