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. Сезнең форма нәтиҗә файл ID‑ларын аерым 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‑ын тик туры килгән җайланма/контекстта гына саклагыз, аннары кирәк булганда шул төгәл ID буенча Restore saved file.
`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 төймәсенә баскач кына Share selected file эшләтегез. Delete saved copy гамәлен үзе ачык сайлаганчы сакланган күчермәне калдырыгыз.
`share_status` һәм `share_sheet_closed` кулланыгыз UI‑ны яңарту өчен лист ябылганнан соң. Икенче ниятле уртаклашу өчен файл 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 эшләтегез, яки Photo Editor яки Recorder тарафыннан ясалган укыла торган файл өчен Load local source кулланыгыз. selection_changed соң, туры килгән файл исемлекләрен укыгыз; Select picked file индексны сайлый.
Save selection locally эшләтегез. files_saved соң, saved_file_ids‑ны кушымтаның җирле кушымта язмасында саклагыз. List saved files сакланган күчермәләрне күрсәтә; Restore saved file сайланган сакланган ID‑ны ача.
Share selected file система бүлешү менюсын ача. share_sheet_closed бары тик менюның ябылуын аңлата. Delete saved copy сайланган ID‑ны һәм confirm=yes‑ны таләп итә.
Бер тапкыр көйләгез
BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз. Xodera Offline Files Native сайлагыз, аның ачкычын күчерегез, аннары Bubble → Plugins → Xodera Offline Files Native ачыгыз һәм licensing_api_key эченә кертегез. Бер тапкыр саклагыз; аннары түбәндәге гамәлләрне кулланыгыз. Һәр проекттагы һәр плагинның үз ачкычы бар.
Сайланган файлларга керү мөмкинлеге булган Bubble Native кушымтасын кулланыгыз. Сакланган файллар дөрес төркемләнсен өчен, аккаунт яки хисап буенча тотрыклы document_context куегыз.
Бер тапкыр көйләгез
- BestPlugins → Dashboard → Plugins эчендә үз Bubble кушымта проектын булдырыгыз яки сайлагыз.
- Бу плагинны сайлагыз һәм аның проект ачкычын күчерегез.
- 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, сакланган файл ID, display_name, mime_type һәм size_bytes. Бу ID бары тик шул ук җайланмада һәм шул ук аккаунт яки хисап өчен генә эшли. Онлайн кушымта өчен файлны аерым эш агымы белән йөкләгез һәм кайтарылган онлайн файл сылтамасын саклагыз.
Уңышсызлык, гамәлне туктату һәм торгызу
Файл сайлауны туктату operation_cancelled кайтара; ул форманы җибәрми. native_pending=yes вакытында башкасын ачканчы файл сайлау яки уртаклашу менюсының ябылуын көтегез. Clear session хәзерге сайланманы чистарта, ләкин сакланган күчермәләрне калдыра. Файл югалса, кулланучы аны яңадан сайласын.
Мөмкинлекләр һәм чикләүләр
1–20 файлларын берьюлы сайлагыз. Файлга бер лимит: 1 байт‑256 MiB, кирәк булса түбәнрәк чик куя аласыз. Файл‑төре фильтрлары вирусларны тикшермиләр. Җайланма файл ID‑лары һәм юллары болыт йөкләү сылтамалары буларак эшләми. Җирле күчермәләр шифрланган саклау түгел һәм кушымта мәгълүматлары бетерелгәндә югалырга мөмкин.
Көйләүләр, гамәлләр һәм нәтиҗәләр
Бу исемнәрне 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) - Бу күренеш ачык булганда yes куегыз. Чыкканда no куегыз, шулай итеп уйнату яки хәзерге эш туктый ала.
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 “җибәрелде” дигәнне аңлатамы?
Юк. Операцион система монда хәбәрнең алучыга уңышлы барып җитүен ышанычлы расламый. «Уртаклашу тәрәзәсе ябылды» күрсәтегез.
Абонентлык ничек эшли?
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.
Бәйләнешле кулланмалар
Ярдәм өчен, кулланган плагин һәм җайланмагыз, тырышкан гамәлегез һәм нәтиҗәсен безгә хәбәр итегез. Шәхси мәгълүматсыз мисал кулланыгыз. Ачкычыгызны яки шәхси файлларыгызны беркайчан да уртаклашмагыз.