Xodera Plugins · Bubble Native
Xodera Offline Files Native
Захоўвайце далучэнні да справаздачы і выбраныя файлы на прыладзе, аднаўляйце іх пазней і дазваляйце карыстальніку падзяліцца абранай копіяй.
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.
Дакументацыя праверана 6 лістапада 2026
Практычныя прыклады
Падрыхтуйце некалькі лакальных далучэнняў перад адпраўкай справаздачы
Форма павінна паказваць, якія файлы былі выбраны, і дазваляць карыстальніку захоўваць кіраваную копію перад любой адпраўкай у воблака.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; устанавіць `max_files`, `max_file_bytes` і ўліковы запіс/справаздачу `document_context`.
Pick files → праверце выбраныя назвы/памеры → Save selection locally. Ваша форма захоўвае атрыманыя ідэнтыфікатары файлаў, пакуль асобны працэс Submit не загрузіць зацверджаныя файлы.
Выкарыстоўвайце `selection_count`, `file_names`, `file_sizes` і `saved_file_ids` для адлюстравання спісу для праверкі. Захаваная кіраваная копія захоўвае арыгінал выклікаючага.
Адменены выбаршчык не з'яўляецца адпраўленым справаздачай. На `files_error` захоўвайце ўжо прынятыя лакальныя ID і паказвайце `error_code`; ніколі не стварайце воблачнае далучэнне толькі з лакальнага URI.
Файлы застаюцца на гэтай прыладзе, пакуль не будуць падзеленыя або загружаныя асобна.
Захоўвайце вынік фота-рэдактара або запісвальніка для будучага выкарыстання.
Згенераваны лакальны файл можа знаходзіцца ў часовай папцы; прыкладанню патрэбна яўная кіраваная копія.
`source_uri = the local output of a separately accepted editor/recorder`; звяжыце яго рэальныя `display_name` і `mime_type`; выкарыстоўвайце той жа ўласнік `document_context`.
Load local source → праверце метаданыя → Save selection locally. Захоўвайце вернуты ID файла толькі ў адпаведнай прыладзе/кантэксце, затым Restore saved file па гэтым дакладным ID па неабходнасці.
Выкарыстоўвайце `file_id`, `local_uri`, `size_bytes` і `is_saved_locally`; выкарыстоўвайце `file_restored`, каб адрозніць завершанае аднаўленне ад простага запыту.
Адхіліце аддалены HTTP URL як лакальны крыніца. Калі крыніца знікла або аднаўленне не ўдалося, пакажыце `error_code` і захоўвайце арыгінальны запіс прыкладання для аднаўлення.
Файлы застаюцца на гэтай прыладзе, пакуль не будуць падзеленыя або загружаныя асобна.
Дазвольце карыстальніку падзяліцца лакальнай квітанцыяй або экспартам, створаным прыкладаннем.
Праграма павінна перадаць выбраны лакальны файл у сістэмны ліст падзелу, а не ствараць публічны URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; яго назва і MIME апісваюць рэальны лакальны файл.
List saved files → Restore saved file → Share selected file пасля таго, як карыстальнік націсне «Падзяліцца». Захоўвайце захаваную копію, пакуль яны яўна не выберуць Delete saved copy.
Выкарыстоўвайце `share_status` і `share_sheet_closed`, каб абнавіць інтэрфейс пасля закрыцця ліста. Захоўвайце ID файла для наступнага свядомага падзелу.
Закрыты ліст падзелу не з'яўляецца доказам дастаўкі электроннай пошты/паведамлення. Апрацоўвайце адмену і `files_error` без паведамлення аб поспеху атрымальніку.
Файлы застаюцца на гэтай прыладзе, пакуль не будуць падзеленыя або загружаныя асобна.
Што працуе зараз
Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.
Стварыце працоўны паток
Выкарыстоўвайце даступныя бэта-дзействы ніжэй і праверце вынік на вашых мэтавых прыладах.
Гэтыя прыклады выкарыстоўваюць запісы прыкладання, такія як Lesson, Message і Order. Заменіце іх уласнымі тыпамі даных і назвамі элементаў. Прыклады медыя-адрасоў трэба замяніць вашымі файламі.
Усталюйце document_context = Current User's unique id або стабільнае значэнне для ўліковага запісу і справаздачы. Выберыце accepted_mime_types_json, max_files і max_file_bytes.
Запусціце Pick files або выкарыстоўвайце Load local source для чытальнага файла, створанага Фота-рэдактарам або Запісвальнікам. Пасля selection_changed прачытайце адпаведныя спісы файлаў; Select picked file выбірае індэкс.
Запусціце Save selection locally. Пасля files_saved захоўвайце saved_file_ids у лакальным рэестры прыкладання. List saved files паказвае захаваныя копіі; Restore saved file адкрывае выбраны захаваны ідэнтыфікатар.
Share selected file адкрывае сістэмнае меню падзелу. share_sheet_closed азначае толькі, што меню закрылася. Delete saved copy патрабуе выбраны ідэнтыфікатар і confirm=yes.
Наладзьце адзін раз
Стварыце або выберыце ваш праект прыкладання Bubble у BestPlugins → Dashboard → Plugins. Выберыце Xodera Offline Files Native, скапіруйце яго ключ, затым адкрыйце Bubble → Plugins → Xodera Offline Files Native і ўстаўце яго ў licensing_api_key. Захавайце адзін раз; пасля выкарыстоўвайце дзеянні ніжэй. Кожны плагін у кожным праекце мае свой уласны ключ.
Выкарыстоўвайце натыўную праграму з доступам да выбраных файлаў. Усталюйце стабільны document_context для ўліковага запісу або справаздачы, каб яго захаваныя файлы заставаліся згрупаванымі правільна.
Наладзьце адзін раз
- Стварыце або выберыце ваш праект прыкладання Bubble у BestPlugins → Dashboard → Plugins.
- Выберыце гэты плагін і скапіруйце яго ключ праекта.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- Дадайце элемент, выберыце вашы дадзеныя прыкладання і пабудуйце працэс ніжэй.
- In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
Усталяванне і падпіска
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.
Захавайце вынік у вашым дадатку
Прыклад LocalAttachment: уладальнік, document_context, ідэнтыфікатар захаванага файла, display_name, mime_type і size_bytes. Гэты ідэнтыфікатар працуе толькі на тым жа прыладзе і для таго ж уліковага запісу або справаздачы. Для онлайн‑прыкладаў загрузіце файл асобным працэсам і захавайце вернутую спасылку на онлайн‑файл.
Памылка, адмена і аднаўленне
Адменены выбарнік вяртае operation_cancelled; ён не адпраўляе форму. Пакуль native_pending=yes, чакайце, пакуль выбарнік файлаў або меню падзелу закрыецца, перш чым адкрываць іншы. Clear session ачыстіць бягучы выбар, але захоўвае захаваныя копіі. Калі файл адсутнічае, дазвольце карыстальніку выбраць яго зноў.
Магчымасці і абмежаванні
Выберыце файлы 1–20 адразу. Ліміт на файл: 1 байт–256 MiB, з ніжэйшым лімітам, калі вы выбіраеце. Фільтры тыпаў файлаў не правяраюць файлы на вірусы. Ідэнтыфікатары і шляхі файлаў прылады не працуюць як спасылкі для загрузкі з воблака. Лакальныя копіі не з'яўляюцца зашыфраваным сховішчам і могуць быць страчаны, калі дадзеныя праграмы выдаляюцца.
Налады, дзеянні і вынікі
Выкарыстоўвайце гэтыя назвы ў Bubble. Планаваныя функцыі пазначаны асобна.
Даступныя бэта-налады
Налады элемента
source_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · textСтані
status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (спіс)file_uris · text (спіс)file_names · text (спіс)file_mime_types · text (спіс)file_sizes · number (спіс)files_json · textsaved_count · numbersaved_file_ids · text (спіс)saved_file_uris · text (спіс)saved_file_names · text (спіс)saved_file_mime_types · text (спіс)saved_file_sizes · number (спіс)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textПадзеі
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorДзеянні і іх уводы
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionНалады элемента · 16
source_uritext · Па змаўчанні: ""- Прыкладнае значэнне
file:///app-cache/report.pdf - Прыклад Bubble выраз
Photo Editor's output_uri - Чытальная размяшчэнне файла на гэтай прыладзе, вернутая вашым выбаршчыкам або іншым плагінам.
display_nametext · Па змаўчанні: ""- Прыкладнае значэнне
report-photo.jpg - Прыклад Bubble выраз
Selected Attachment's display_name - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
mime_typetext · Па змаўчанні: ""- Прыкладнае значэнне
image/jpeg - Прыклад Bubble выраз
Photo Editor's output_mime - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
document_contexttext · Па змаўчанні: "default"- Прыкладнае значэнне
<current-user-id> - Прыклад Bubble выраз
Current User's unique id - Стабільнае значэнне для гэтага акаўнта або запісу. Выкарыстоўвайце тое ж значэнне пры аднаўленні яго захаваных файлаў або чарнавікоў.
selected_file_idtext · Па змаўчанні: ""- Прыкладнае значэнне
<returned saved file ID> - Прыклад Bubble выраз
Selected LocalAttachment's local_file_id - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
accepted_mime_types_jsontext · Па змаўчанні: "[\"*/*\"]"- Прыкладнае значэнне
["image/*","application/pdf"] - Прыклад Bubble выраз
Report Settings' accepted_mime_types_json - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
multipleyes_no · Па змаўчанні: false- Прыкладнае значэнне
yes - Прыклад Bubble выраз
Report Settings' allow_multiple_attachments - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
copy_to_cacheyes_no · Па змаўчанні: true- Прыкладнае значэнне
yes - Прыклад Bubble выраз
Report Settings' copy_to_cache - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
max_filesnumber · Па змаўчанні: 20- Прыкладнае значэнне
5 - Прыклад Bubble выраз
Report Settings' attachment_limit - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
max_file_bytesnumber · Па змаўчанні: 268435456- Прыкладнае значэнне
10485760 - Прыклад Bubble выраз
Report Settings' max_attachment_bytes - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
is_activeyes_no · Па змаўчанні: true- Прыкладнае значэнне
yes - Прыклад Bubble выраз
GuideHost's view_is_active (your yes/no custom state) - Усталюйце «так», пакуль гэтае прадстаўленне адкрыта. Усталюйце «не», пры закрыцці, каб прайграванне або бягучая праца маглі спыніцца.
disabledyes_no · Па змаўчанні: false- Прыкладнае значэнне
no - Прыклад Bubble выраз
GuideHost's is_busy (your yes/no custom state) - Адключыце элемент, пакуль ваш дадатак заняты або гэта дзеянне недаступна.
show_controlsyes_no · Па змаўчанні: true- Прыкладнае значэнне
yes - Прыклад Bubble выраз
App Settings' show_editor_controls - Паказаць або схаваць убудаваныя элементы кіравання.
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 - Бачны тэкст прыкладання; пустое поле выкарыстоўвае ўбудаваную лакалізаваную копію, дзе падтрымліваецца. Без уліковых даных.
Дзеянні і іх уводы · 10
Pick files
Адсутнічаюць параметры дзеяння
Load local source
source_uritext · Па змаўчанні: —- Прыкладнае значэнне
file:///app-cache/report.pdf - Прыклад Bubble выраз
Photo Editor's output_uri - Чытальная размяшчэнне файла на гэтай прыладзе, вернутая вашым выбаршчыкам або іншым плагінам.
display_nametext · Па змаўчанні: —- Прыкладнае значэнне
report-photo.jpg - Прыклад Bubble выраз
Selected Attachment's display_name - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
mime_typetext · Па змаўчанні: —- Прыкладнае значэнне
image/jpeg - Прыклад Bubble выраз
Photo Editor's output_mime - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
Select picked file
indexnumber · Па змаўчанні: —- Прыкладнае значэнне
0 - Прыклад Bubble выраз
Selected row's current_source_index - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
Save selection locally
Адсутнічаюць параметры дзеяння
List saved files
Адсутнічаюць параметры дзеяння
Restore saved file
file_idtext · Па змаўчанні: —- Прыкладнае значэнне
<returned saved file ID> - Прыклад Bubble выраз
Selected LocalAttachment's local_file_id - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
Delete saved copy
file_idtext · Па змаўчанні: —- Прыкладнае значэнне
<returned saved file ID> - Прыклад Bubble выраз
Selected LocalAttachment's local_file_id - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
confirmyes_no · Па змаўчанні: —- Прыкладнае значэнне
yes — explicit confirmation only - Прыклад Bubble выраз
Confirm Checkbox is checked - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
Share selected file
dialog_titletext · Па змаўчанні: —- Прыкладнае значэнне
Share attachment - Прыклад Bubble выраз
Selected Report's share_title - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
utitext · Па змаўчанні: —- Прыкладнае значэнне
"" - Прыклад Bubble выраз
Empty unless your iOS integration supplies a proven UTI - Выкарыстоўвайце значэнне бягучага бізнес-запісу; праверце яго супраць ніжэйшых межаў.
Cancel operation
Адсутнічаюць параметры дзеяння
Clear session
Адсутнічаюць параметры дзеяння
Стані і падзеі
Стані
status · textБягучы вынік гэтага дзеяння. Выкарыстоўвайце адпаведную падзею завяршэння перад захаваннем поспеху.
is_busy · yes_noПраца яшчэ працягваецца. Пачакайце, перш чым пачынаць іншае дзеянне.
native_pending · yes_noПраца яшчэ працягваецца. Пачакайце, перш чым пачынаць іншае дзеянне.
operation · textБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
selection_count · numberБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
selected_index · numberБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
file_id · textІдэнтыфікатар гэтага элемента або дзеяння. Захоўвайце яго разам з адпаведным запісам у дадатку. Выкарыстоўвайце той жа ідэнтыфікатар запыту пры паўторнай спробе няпэўнага выніку.
local_uri · textРазмяшчэнне файла на гэтым прыладзе. Захавайце або загрузіце файл асобна, калі яго трэба трымаць у інтэрнэце.
display_name · textБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
mime_type · textБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
mime_source · textБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
size_bytes · numberБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
is_saved_locally · yes_noБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
file_ids · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
file_uris · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
file_names · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
file_mime_types · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
file_sizes · number (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
files_json · textБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
saved_count · numberБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
saved_file_ids · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
saved_file_uris · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
saved_file_names · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
saved_file_mime_types · text (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
saved_file_sizes · number (спіс)Спіс выбраных файлаў. Элементы з тым жа індэксам у іншых спісах файлаў адносяцца да таго ж файла.
saved_files_json · textБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
invalid_saved_count · numberБягучае значэнне выбранага элемента. Чытайце яго пасля адпаведнай падзеі.
share_status · textБягучы вынік гэтага дзеяння. Выкарыстоўвайце адпаведную падзею завяршэння перад захаваннем поспеху.
error_code · textІнфармацыя пра памылку апошняга дзеяння. Пакажыце карыснае паведамленне і прапануйце адпаведную паўторную спробу.
Падзеі
selection_changedКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
files_savedКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
list_loadedКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
file_restoredКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
file_deletedКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
share_sheet_closedКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
operation_cancelledКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
files_errorКалі адбываецца гэта падзея, прачытайце адпаведныя стану з таго ж элемента.
Пытанні, якія задаюць распрацоўшчыкі
Ці азначае Share «адпраўлена»?
Не. Аперацыйная сістэма не прадастаўляе надзейнага пацвярджэння паспяховасці атрымальніка. Пакажыце “share sheet closed”.
Як працуе падпіска?
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.
Звязаныя кіраўніцтва
Для дапамогі паведаміце, які плагін і прыладу вы выкарыстоўваеце, якую дзею спрабавалі і што адбылося. Выкарыстоўвайце прыклад без асабістых даных. Ніколі не дзяліцеся вашым ключом або прыватнымі файламі.