← Bubble Native буенча барлык кулланмалар

Xodera Plugins · Bubble Native

Xodera B2 Files Native

Кушымта файлларын үз Backblaze B2 саклагычында саклагыз. Рөхсәт ителгән кулланучыларга файлларны йөкләргә, карарга һәм йөкләп алырга мөмкинлек бирегез, һәм файлның җәмәгатькә уртаклашылу вакытын ачык итеп сайлагыз.

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.

Эш агымын төзегез ↓Плагин көйләүләре ↗Native Lab

Документация каралган 6 ноябрь 2026

Практик мисаллар

Эш кушымтасын үстерүченең шәхси бакетында саклагыз

Bubble Job язмасына тотрыклы саклау сылтамасы кирәк; вакыты бетә торган йөкләү URL адресы файлның даими идентификаторы түгел.

`bucket_binding_id = an allowed binding to your own private bucket`; динамик `local_uri`, `display_name`, `mime_type` һәм `expected_size` сайланган локаль файлны тасвирлый.

Планлаштырылган: Check local source → Upload file → `upload_verified` көтегез. Аннары эш процессы `asset_ref` һәм метадатаны кушымтагызга караган Job язмасында саклый.

`asset_ref`, `size_bytes`, `mime_type` һәм `upload_status` кулланыгыз. Соңрак, Resolve private read авторизацияләнгән куллану өчен вакытлы URL бирә ала.

Әгәр база саклау `upload_verified`дан соң уңышсыз булса, башка йөкләү урынына шул ук актив сылтамасы белән DB яңартуын кабатлагыз. `upload_pending` нәтиҗәсен Check or recover upload status һәм шул ук йөкләү ID‑сы белән тикшерегез.

Планлаштырылган. Сезнең B2 хисапыгыз саклау һәм йөкләү түләүләрен каплый.

Тотрыклы файл язмалары белән үзегезнең теркәлгән файл галереясен төзегез.

Файл галереясендә исемнәр, төрләр һәм битләү, шулай ук сайланган активны соңрак ачу ысулы кирәк.

Тикшерелгән йөкләүдән соң кушымтагызның File язмасы кабул ителгән `asset_ref`, күрсәтү исемен, MIME һәм иясе/Job бәйләнешен саклый; аның болыттагы идентификаторы итеп җирле URI кулланмагыз.

Планлаштырылган: List my B2 files кулланып теркәлмәләр исемлеген төзергә. asset_refs файлларны билгели; шул ук индексдагы кыйммәтләр аларның исемнәрен һәм төрләрен бирә. Файлны сайлау аның asset_ref‑ын Get asset metadata яки Download accepted version‑ка җибәрә.

`has_more` һәм `next_cursor` хәзерге сорауга карый. Тәмамланган йөкләү `local_output_uri`‑ны кайтара; ул җайланмада локаль күчермә, даими җәмәгать сылтамасы түгел.

Бәйләнеш/хисап/сорау үзгәрешләреннән соң битләүне яңадан куегыз. `transfer_error` вакытында булган File Thing‑ны саклагыз һәм `error_code`‑ны күрсәтегез; аны башка провайдер версиясе белән тыныч кына алыштырмагыз.

Планлаштырылган. Сезнең B2 хисапыгыз саклау һәм йөкләү түләүләрен каплый.

Бастыруны һәм төгәл версияне бетерүне ниятле итегез

Хезмәткәрләр шәхси файлны очраклы рәвештә ачу яки рәсемне алыштырганда һәр версияне бетерүдән сакланырга тиеш.

`asset_ref = the selected accepted version`; bucket бәйләнеше һәм кушымтаның файл рөхсәтләре соралган операцияне рөхсәт итәргә тиеш.

Актуаль күренешне күрсәтегез, ачык раслануны сорагыз, аннары Change public sharing. Бетерү өчен, раслану белән Delete accepted version чакырыгыз; расланган нәтиҗә билгеле булмаганча кушымта метадатасын саклагыз.

`share_changed` булгач, ачык уртаклашуга махсус рөхсәт бирелгәндә генә `visibility` һәм `public_url` кулланыгыз. `delete_completed` булгач, кушымтагызга караган File язмасын яңартыгыз; `delete_pending` бетерү тәмамланды дигән сүз түгел.

Уңышлы дип уйлап кына түгел, билгесез операция нәтиҗәсен тикшерегез. Алдан бирелгән провайдер укый торган URL‑лар вакытына кадәр гамәлдә кала ала; DB юлларын бетерү яки уртаклашуны сүндерү инде йөкләнгән байтларны кире кайтармый.

Планлаштырылган. Сезнең B2 хисапыгыз саклау һәм йөкләү түләүләрен каплый.

Хәзер эшли торганнар

Планлаштырылган плагин. Ул әле урнаштырылмаган яки куллану өчен әзер түгел. Түбәндәге кулланма планлаштырылган файл эш агымын күрсәтә.

Эш агымын төзегез

Планлаштырылган

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

Бу мисалларда Lesson, Message һәм Order кебек кушымта язмалары кулланыла. Аларны үзегезнең мәгълүмат төрләрегез һәм элемент исемнәрегез белән алыштырыгыз. Мисал медиа адресларын үз файлларыгыз белән алыштырырга кирәк.

Планлаштырылган: проект көйләүләрендә B2 саклагычыгызны һәм рөхсәт ителгән бакетны сайлагыз. Аның шәхси статусын, папка префиксын һәм кабул ителә торган файл төрләрен һәм зурлыкларын билгеләгез.
Рөхсәт ителгән саклау вариантларын күрсәтү өчен List B2 bindings‑ны кулланыгыз. Хәзерге кулланучының файлларын күрсәтү өчен List my B2 files‑ны, ә детальләр өчен Get my B2 file info‑ны кулланыгыз.
Файлны сайлагыз. bucket_binding_id, local_uri, display_name, mime_type һәм expected_size кую, аннары Upload file эшләтегез. Прогрессны күрсәтегез, ләкин файлны сакланган итеп карамаска upload_verified көтегез.
asset_refны кушымта язмасында саклагыз. Аны Get asset metadata, Resolve private read яки Download accepted version өчен кулланыгыз. Change public sharing һәм Delete accepted version аерым раслау таләп итә.

Эш агымы схемасы — кушымта скриншоты түгел

Бер тапкыр көйләгез

Бу плагин өчен ачкычны активлаштыру планлаштырылган. Bubble кушымта проектын BestPlugins → Dashboard → Plugins эчендә булдырыгыз яки сайлагыз. Xodera B2 Files Native сайлагыз, аның ачкычын күчерегез, аннары Bubble → Plugins → Xodera B2 Files Native ачыгыз һәм project_api_key эченә кертегез. Бер тапкыр саклагыз; аннары түбәндәге гамәлләрне кулланыгыз. Һәр плагин һәр проектта үз ачкычына ия.

Үз Backblaze B2 аккаунтыгызны һәм бу кушымта өчен бакетны сайлагыз. Файлларны кем укый һәм кем йөкли ала икәнен билгеләгез. Тиешле User yes/no кырларының исемнәрен b2_reader_permission_field һәм b2_writer_permission_field эчендә саклагыз; килешүләр b2_files_reader һәм b2_files_writer. Бу кулланучы рөхсәтләрен вәкаләтле администратор гына үзгәртергә тиеш.

Бер тапкыр көйләгез

BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз.
Бу плагинны сайлагыз һәм аның проект ачкычын күчерегез.
Планлаштырылган: Bubble ачыгыз → Plugins → Xodera B2 Files Native; ачкычны project_api_key‑ка кертеп саклагыз.
Элементны өстәгез, кушымта мәгълүматларын сайлагыз һәм түбәндәге эш агымын төзегез.
Хәзер өчен генә шәхси бета керү. Җәмәгатькә урнаштыру һәм түләүле активлаштыру әле ачык түгел.

Урнаштыру һәм язылу

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.

Нәтиҗәне кушымтагызда саклагыз

Мисал файл: asset_ref, бәйле хисап/заказ, иясе, display_name, mime_type һәм size_bytes. Аларны upload_verified‑тан соң саклагыз. Файлны соңрак ачу өчен asset_ref‑ны кулланыгыз; вакытлы укылыш адресы яки бер җайланмадагы юл даими файл сылтамасы түгел. Мәгълүмат базасы язмасын саклау уңышсыз булса, файлны яңадан йөкләү урынына язманы кабат сакларга тырышыгыз.

Уңышсызлык, гамәлне туктату һәм торгызу

Йөкләү нәтиҗәсе билгесез булса, upload_id саклагыз һәм Check or recover upload status кулланыгыз. Башка күчермәне автоматик рәвештә йөкләмәгез. Cancel тәмамланмаган тапшыруга гына кагыла, инде сакланган файлга түгел. Керү вакыты бетсә, иске вакытлы адресны яңадан куллану урынына файлны яңадан сорагыз.

Мөмкинлекләр һәм чикләүләр

Планлаштырылган максималь файл зурлыгы: 256 MiB, яки сез сайлаган түбәнрәк бакет чикләве. Backblaze саклау һәм йөкләү түләүләре сезнең B2 хисап язмагызга карый. Җәмәгать бакетындагы файллар бәйле кушымта язмасы шәхси булса да, җәмәгатьчелеккә ачык кала. Вирус сканлау вәгъдәләре, күп өлешле йөкләү, туктату яки кушымта туктатылганнан соң торгызу юк.

Көйләүләр, гамәлләр һәм нәтиҗәләр

Бу исемнәрне Bubble эчендә кулланыгыз. Планлаштырылган функцияләр аерым билгеләнгән.

Кулланыла торган бета көйләүләре

Элемент көйләүләре

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 · 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

Вакыйгалар

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Гамәлләр һәм аларның кертемнәре

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

Элемент көйләүләре · 14

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

bucket_binding_idtext · Стандарт: "": Мисал кыйммәте<binding returned by List B2 bindings>; Мисал Bubble ифадәсеSelected Binding's binding_id; Саклау варианты List B2 bindings тарафыннан кайтарылды. Бу файл өчен аның ID‑сын кулланыгыз.

local_uritext · Стандарт: "": Мисал кыйммәтеfile:///app-cache/attachment.jpg; Мисал Bubble ифадәсеOffline Files' local_uri; Бу җайланмада укыла торган файл урыны. Бу онлайн йөкләү сылтамасы түгел.

display_nametext · Стандарт: "": Мисал кыйммәтеreport-photo.jpg; Мисал Bubble ифадәсеSelected Attachment's display_name; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

mime_typetext · Стандарт: "": Мисал кыйммәтеimage/jpeg; Мисал Bubble ифадәсеPhoto Editor's output_mime; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

expected_sizenumber · Стандарт: 0: Мисал кыйммәте246975; Мисал Bubble ифадәсеOffline Files' size_bytes; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

metadata_jsontext · Стандарт: "": Мисал кыйммәте{"label":"field-report"}; Мисал Bubble ифадәсеSelected Attachment's safe_metadata_json; Отчет тамгасы кебек кушымта мәгълүматлары булган өстәмә JSON. Аны кыска тотыгыз һәм шәхси мәгълүматлардан сакланыгыз.

asset_reftext · Стандарт: "": Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

is_activeyes_no · Стандарт: true: Мисал кыйммәтеyes; Мисал Bubble ифадәсеGuideHost's view_is_active (your yes/no custom state); Бу күренеш ачык булганда yes куегыз. Чыкканда no куегыз, шулай итеп уйнату яки хәзерге эш туктый ала.

disabledyes_no · Стандарт: false: Мисал кыйммәтеno; Мисал Bubble ифадәсеGuideHost's is_busy (your yes/no custom state); Кушымтагыз мәшгуль булганда яки бу гамәл кулланылмый торганда элементны сүндерегез.

languagetext · Стандарт: "auto": Мисал кыйммәтеuk; Мисал Bubble ифадәсеCurrent User's preferred_language; language=auto җайланма яки браузер теленә ярдәм булганда шул телне куллана. Телне ачык сайлау өчен ярдәм ителгән тел кодын кертегез.

ui_text_jsontext · Стандарт: "": Мисал кыйммәте{}; Мисал Bubble ифадәсеApp Settings' player_labels_json (supported keys only); Ярдәм ителгән төймә язмалары булган ихтыяри JSON. Эчке текстны куллану өчен буш калдырыгыз.

titletext · Стандарт: "": Мисал кыйммәтеLesson 4 — review; Мисал Bubble ифадәсеSelected Lesson's name; Кушымтада күренә торган текст; буш калдырылса, ярдәм булган урыннарда эчке тәрҗемә кулланыла. Монда керү өчен яшерен мәгълүмат кертмәгез.

show_previewyes_no · Стандарт: false: Мисал кыйммәтеyes; Мисал Bubble ифадәсеApp Settings' b2_preview; Файл алдан карауны күрсәтү яки яшерү.

show_provider_browseyes_no · Стандарт: false: Мисал кыйммәтеno; Мисал Bubble ифадәсеCurrent User's authorized_browse_UI (presentation only); Рөхсәт ителгән кулланучылар өчен саклау карау элементларын күрсәтү яки яшерү.

Гамәлләр һәм аларның кертемнәре · 20

Планлаштырылган эш агымы. Хәзерге бетада әле бар түгел.

List allowed buckets

Эш параметрлары юк

Select bucket binding

binding_idtext · Стандарт: —: Мисал кыйммәте<returned allowed binding ID>; Мисал Bubble ифадәсеSelected Binding's binding_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Check local source

Эш параметрлары юк

Upload file

acknowledge_public_bytesyes_no · Стандарт: —: Мисал кыйммәтеno; Мисал Bubble ифадәсеPublic bucket disclosure Checkbox is checked (private bucket: no); Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

confirm_retryyes_no · Стандарт: —: Мисал кыйммәтеno; Мисал Bubble ифадәсеRetry Checkbox is checked after confirmed clean pending status; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Check or recover upload status

upload_idtext · Стандарт: —: Мисал кыйммәте<original returned upload_id>; Мисал Bubble ифадәсеCurrent UploadIntent's upload_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Cancel owned transfer

Эш параметрлары юк

Clear local session

Эш параметрлары юк

List application files

Эш параметрлары юк

Refresh application files

Эш параметрлары юк

Load more application files

Эш параметрлары юк

Select asset reference

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

Get asset metadata

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

Resolve private read

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

Download accepted version

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

Browse provider files

prefixtext · Стандарт: —: Мисал кыйммәте""; Мисал Bubble ифадәсеAuthorized Browse Settings' prefix; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

load_moreyes_no · Стандарт: —: Мисал кыйммәтеno; Мисал Bubble ифадәсеLoad More button only, for unchanged query; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Change public sharing

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

enabledyes_no · Стандарт: —: Мисал кыйммәтеno; Мисал Bubble ифадәсеPublic Share Checkbox is checked after separate confirmation; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

confirmyes_no · Стандарт: —: Мисал кыйммәтеyes — explicit confirmation only; Мисал Bubble ифадәсеConfirm Checkbox is checked; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Delete accepted version

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

confirmyes_no · Стандарт: —: Мисал кыйммәтеyes — explicit confirmation only; Мисал Bubble ифадәсеConfirm Checkbox is checked; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

List B2 bindings

environmenttext · Стандарт: —: Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Кайтарыла торган кыйммәтләр

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

List my B2 files

environmenttext · Стандарт: —: Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

binding_idtext · Стандарт: —: Мисал кыйммәте<returned allowed binding ID>; Мисал Bubble ифадәсеSelected Binding's binding_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

limitnumber · Стандарт: —: Мисал кыйммәте50; Мисал Bubble ифадәсеGallery Settings' page_size; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

cursortext · Стандарт: —: Мисал кыйммәте""; Мисал Bubble ифадәсеPrevious List my B2 files result's next_cursor; empty on first page; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

Кайтарыла торган кыйммәтләр

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 · Стандарт: —: Мисал кыйммәтеdevelopment; Мисал Bubble ифадәсеApp Settings' selected_environment; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

binding_idtext · Стандарт: —: Мисал кыйммәте<returned allowed binding ID>; Мисал Bubble ифадәсеSelected Binding's binding_id; Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.

asset_reftext · Стандарт: —: Мисал кыйммәте<returned asset_ref>; Мисал Bubble ифадәсеSelected B2Asset's asset_ref; Хезмәттән алынган тотрыклы, ачык булмаган кабул ителгән актив идентификаторы. Аны сайлау кулланучы рөхсәтен беркайчан да узып китми.

Кайтарыла торган кыйммәтләр

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 · text

Бу гамәлнең хәзерге нәтиҗәсе. Уңышлы саклау алдыннан туры килгән тәмамлану вакыйгасын кулланыгыз.

is_busy · yes_no

Эш әле дә бара. Яңа гамәлне башлар алдыннан көтегез.

upload_id · text

Бу элемент яки гамәл өчен идентификатор. Аны туры килгән кушымта язмасында саклагыз. Билгесез нәтиҗәне кабатлау вакытында шул ук сорау идентификаторын кулланыгыз.

upload_status · text

Бу гамәлнең хәзерге нәтиҗәсе. Уңышлы саклау алдыннан туры килгән тәмамлану вакыйгасын кулланыгыз.

asset_ref · text

display_name · text