Xodera Plugins · Bubble Native
Xodera Photo Editor 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
Практик мисаллар
Йөкләү алдыннан бертөрле профиль аватарлары
Кулланучылар үз фотосының кайсы өлеше квадрат профиль рәсемендә күрсәтелергә тиешлеген сайларга тиеш, очраклы кисүне кабул итү урынына.
`source_url = selected profile image`; `crop_aspect = "1:1"`; `document_context = the account’s stable reference`.
`source_loaded` көтегез; Begin crop → Apply crop, кирәк булганда Rotate яки Undo белән. Ачык саклау вакытында, Export image.
Тик `export_completed` вакытында, `output_uri`, `output_width`, `output_height` һәм `output_mime` ны файл йөкләү эш агымына кертем буларак кулланыгыз. Аннары аның тотрыклы сылтамасын Профильгә саклагыз.
Кулланучы гамәлне туктатса яки `editor_error` булса, иске аватарны саклагыз. Башка кулланучы караламаны күрмәсен өчен, аккаунт үзгәргәндә сессияне чистартыгыз.
Төзәтү җирле күчермәне булдыра. Кушымтагыз аны ничек сакларга яки йөкләргә икәнен сайлый.
Бертөрле базар яки каталог фотоларын әзерләгез
Төрле кысалар һәм зуррак рәсемнәр каталогны тигезсез итә һәм йөкләү күләмен арттыра.
`source_url = selected item photo`; `crop_aspect = the app’s chosen ratio`; `export_max_dimension`, `export_format` һәм `export_quality` сезнең йөкләү сәясәтегездән килә.
Кирәкле өлешне кисеп алыгыз, кирәк булса Resize кулланыгыз, аннары кулланучы раслагач Export image гамәлен башкарыгыз. Оригиналь файлны яки аңа сылтаманы аерым саклагыз.
Серверга йөкләү эш процессы нәтиҗәне саклаганчы, `output_width`, `output_height`, `output_bytes` һәм `output_mime` кыйммәтләрен тикшерегез. Нәтиҗәдәге рәсемгә сылтаманы Item язмасында саклагыз.
Әгәр экспорт уңышсыз булса яки нәтиҗә йөкләү кагыйдәләрегезгә туры килмәсә, `error_code` күрсәтегез һәм кулланучыга рәсемне үзгәртергә мөмкинлек бирегез. Йөкләү расланганчы, Item язмасындагы элекке рәсемне алыштырмагыз.
Төзәтү җирле күчермәне булдыра. Кушымтагыз аны ничек сакларга яки йөкләргә икәнен сайлый.
Урында башкарылган эш турындагы хисап өчен рәсемнең кирәкле өлеше күренгән күчермәсен ясагыз
Техникка, хисаптагы оригиналь рәсемне саклап, зыян күргән бер детальнең якыннан төшерелгән сурәте кирәк булырга мөмкин.
`source_url = Current Report Photo’s source`; `document_context = the report/account reference`; кисү нисбәте чикләнмәгән булып кала ала.
Begin crop → Apply crop, аннары Undo/Redo кулланып үзгәрешләрне чагыштырыгыз. Export image үзгәртелгән күчермәне булдыра; кушымтагыз бу күчермәне Хисапка кертүне сорау итә.
`has_changes`, `can_undo`, `can_redo` һәм `output_uri` кулланыгыз. Уңышлы йөкләүдән соң оригиналь һәм үзгәртелгән сылтамаларны аерым кушымта кырына саклагыз.
Cancel crop яки Reset edits редакция юлын торгызый; кире кагу оригиналь Хисап кушымтасын үзгәртмәскә тиеш.
Төзәтү җирле күчермәне булдыра. Кушымтагыз аны ничек сакларга яки йөкләргә икәнен сайлый.
Хәзер эшли торганнар
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 кебек кушымта язмалары кулланыла. Аларны үзегезнең мәгълүмат төрләрегез һәм элемент исемнәрегез белән алыштырыгыз. Мисал медиа адресларын үз файлларыгыз белән алыштырырга кирәк.
source_url‑ны сайланган рәсемгә куегыз. document_context‑ны мөхәррирләнгән аккаунт һәм язманы ачыклау өчен кулланыгыз, шуңа күрә язманы үзгәртү элекке фотоны бетерә.
source_loaded‑дан соң Begin crop‑ны эшләтегез. Аватар өчен 1:1 сайлагыз, кисүне көйләгез һәм Apply crop‑ны кулланыгыз. Cancel crop рәсемне үзгәрешсез калдыра.
Кирәк булса Rotate, Flip яки Resize‑ны кулланыгыз. Undo һәм Redo тәмамланган төзәтүләр арасында хәрәкәт итә; Reset edits оригиналь рәсемне торгызый.
Export image‑ны эшләтегез. export_completed өстендә output_uri, output_width, output_height һәм output_mime укыгыз. Сайланган файл саклау эш агымы белән шул күчермәне саклагыз яки йөкләгез, аннары сакланган файлны язмага кертегез.
Бер тапкыр көйләгез
Бу плагин өчен ачкычны активлаштыру планлаштырылган. Bubble кушымта проектын BestPlugins → Dashboard → Plugins эчендә булдырыгыз яки сайлагыз. Xodera Photo Editor Native сайлагыз, аның ачкычын күчерегез, аннары Bubble → Plugins → Xodera Photo Editor Native ачыгыз һәм licensing_api_key эченә кертегез. Бер тапкыр саклагыз; аннары түбәндәге гамәлләрне кулланыгыз. Һәр плагин һәр проектта үз ачкычына ия.
Алды белән кушымтагыз белән рәсемне сайлагыз яки төшерегез. Редакторга алынган укыла торган рәсем адресын бирегез. Камера һәм фототека рөхсәтләре сез кулланган сайлаучыга карый.
Бер тапкыр көйләгез
- 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.
Нәтиҗәне кушымтагызда саклагыз
Йөкләнгән яки даими сакланган рәсемне Profile.image яки теркеме кырыгызга саклагыз. output_uri җайланмадагы вакытлы файл, шуңа күрә аны башта сайланган эш агымы белән саклагыз. Аннары output_width, output_height һәм output_mime‑ны метадата итеп саклагыз. Ике версия кирәк булса, оригиналь рәсемне саклагыз.
Уңышсызлык, гамәлне туктату һәм торгызу
source_load_failed яки editor_error өстендә error_code‑ны күрсәтегез һәм Load source‑ны тәкъдим итегез. Cancel operation тәмамланмаган нәтиҗәне кабул итүне туктата; башка төзәтүне башлар алдыннан is_busy=no‑ка кадәр көтегез. Clear session редакторны чистарта, ләкин башка урында сакланган рәсемне түгел.
Мөмкинлекләр һәм чикләүләр
JPEG һәм PNG экспорт; сыйфат 0–1; чыгыш рәсеменең иң озын ягы 1–4096 пиксель. Керү: 15 MiB һәм 20 мегапиксельгә кадәр. 20 гә кадәр тәмамланган үзгәреш. Кисү нисбәтләре: ирекле, 1:1, 4:3, 3:4 һәм 16:9. Эчке камера, фильтрлар, текст катламнары, перспектива төзәтү, WebP экспорт яки автоматик йөкләү юк.
Көйләүләр, гамәлләр һәм нәтиҗәләр
Бу исемнәрне Bubble эчендә кулланыгыз. Планлаштырылган функцияләр аерым билгеләнгән.
Кулланыла торган бета көйләүләре
Элемент көйләүләре
source_url · textdocument_context · textis_active · yes_nodisabled · yes_noshow_controls · yes_nocrop_aspect · textexport_format · textexport_quality · numberexport_max_dimension · numberallow_upscale · yes_noui_text_json · textlanguage · textХәлләр
editor_status · textis_busy · yes_nohas_image · yes_nohas_changes · yes_nocan_undo · yes_nocan_redo · yes_noimage_width · numberimage_height · numberoutput_uri · textoutput_width · numberoutput_height · numberoutput_bytes · numberoutput_mime · texterror_code · textcrop_active · yes_nocrop_rect_json · textВакыйгалар
source_loadedsource_load_failededit_appliededit_undoneedit_redoneeditor_resetexport_startedexport_completedoperation_cancellededitor_errorГамәлләр һәм аларның кертемнәре
Load sourceBegin cropApply cropCancel cropRotateFlipResizeUndoRedoReset editsExport imageCancel operationClear sessionЭлемент көйләүләре · 12
source_urltext · Стандарт: ""- Мисал кыйммәте
https://bestplugins.online/native-samples/avatar.jpg - Мисал Bubble ифадәсе
Selected Profile's image_url - Сайланган аудио, видео яки рәсем файлының адресы. Бу плагин ярдәм иткән файл төрен кулланыгыз.
document_contexttext · Стандарт: ""- Мисал кыйммәте
<current-user-id> - Мисал Bubble ифадәсе
Current User's unique id - Бу аккаунт яки язма өчен тотрыклы кыйммәт. Аның сакланган файлларын яки караламаларын торгызганда шул ук кыйммәтне кулланыгыз.
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 - Эчке контроль элементларын күрсәтергә яки яшерергә.
crop_aspecttext · Стандарт: "free"- Мисал кыйммәте
1:1 - Мисал Bubble ифадәсе
Avatar Settings' crop_ratio - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
export_formattext · Стандарт: "jpeg"- Мисал кыйммәте
jpeg - Мисал Bubble ифадәсе
Format Dropdown's value - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
export_qualitynumber · Стандарт: 0.85- Мисал кыйммәте
0.85 - Мисал Bubble ифадәсе
Image Settings' quality - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
export_max_dimensionnumber · Стандарт: 2048- Мисал кыйммәте
2048 - Мисал Bubble ифадәсе
Image Settings' max_side - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
allow_upscaleyes_no · Стандарт: false- Мисал кыйммәте
no - Мисал Bubble ифадәсе
Allow upscale Checkbox is checked - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
ui_text_jsontext · Стандарт: ""- Мисал кыйммәте
{} - Мисал Bubble ифадәсе
App Settings' player_labels_json (supported keys only) - Ярдәм ителгән төймә язмалары булган ихтыяри JSON. Эчке текстны куллану өчен буш калдырыгыз.
languagetext · Стандарт: "auto"- Мисал кыйммәте
uk - Мисал Bubble ифадәсе
Current User's preferred_language - language=auto җайланма яки браузер теленә ярдәм булганда шул телне куллана. Телне ачык сайлау өчен ярдәм ителгән тел кодын кертегез.
Гамәлләр һәм аларның кертемнәре · 13
Load source
Эш параметрлары юк
Begin crop
Эш параметрлары юк
Apply crop
origin_xnumber · Стандарт: —- Мисал кыйммәте
0 - Мисал Bubble ифадәсе
Crop Settings' x (or omit all rectangle inputs) - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
origin_ynumber · Стандарт: —- Мисал кыйммәте
0 - Мисал Bubble ифадәсе
Crop Settings' y (or omit all rectangle inputs) - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
widthnumber · Стандарт: —- Мисал кыйммәте
512 - Мисал Bubble ифадәсе
Resize Width Input's value:converted to number - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
heightnumber · Стандарт: —- Мисал кыйммәте
512 - Мисал Bubble ифадәсе
Resize Height Input's value:converted to number - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
Cancel crop
Эш параметрлары юк
Rotate
degreesnumber · Стандарт: —- Мисал кыйммәте
90 - Мисал Bubble ифадәсе
Rotation Dropdown's value - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
Flip
axistext · Стандарт: —- Мисал кыйммәте
horizontal - Мисал Bubble ифадәсе
Flip Direction Dropdown's value - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
Resize
widthnumber · Стандарт: —- Мисал кыйммәте
512 - Мисал Bubble ифадәсе
Resize Width Input's value:converted to number - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
heightnumber · Стандарт: —- Мисал кыйммәте
512 - Мисал Bubble ифадәсе
Resize Height Input's value:converted to number - Хәзерге бизнес язмасының кыйммәтен кулланыгыз; аны түбәндәге чикләргә тикшерегез.
Undo
Эш параметрлары юк
Redo
Эш параметрлары юк
Reset edits
Эш параметрлары юк
Export image
Эш параметрлары юк
Cancel operation
Эш параметрлары юк
Clear session
Эш параметрлары юк
Хәлләр һәм вакыйгалар
Хәлләр
editor_status · textБу гамәлнең хәзерге нәтиҗәсе. Уңышлы саклау алдыннан туры килгән тәмамлану вакыйгасын кулланыгыз.
is_busy · yes_noЭш әле дә бара. Яңа гамәлне башлар алдыннан көтегез.
has_image · yes_noСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
has_changes · yes_noСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
can_undo · yes_noСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
can_redo · yes_noСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
image_width · numberСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
image_height · numberСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
output_uri · textФайлның бу җайланмадагы урыны. Онлайн сакланырга тиеш булса, файлны аерым саклагыз яки йөкләгез.
output_width · numberСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
output_height · numberСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
output_bytes · numberСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
output_mime · textСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
error_code · textСоңгы гамәл өчен хата мәгълүматы. Ярдәмче хәбәрне күрсәтегез һәм тиешле кабатлау мөмкинлеген тәкъдим итегез.
crop_active · yes_noСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
crop_rect_json · textСайланган элементның хәзерге кыйммәте. Тиешле вакыйгадан соң укыгыз.
Вакыйгалар
source_loadedБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
source_load_failedБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
edit_appliedБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
edit_undoneБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
edit_redoneБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
editor_resetБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
export_startedБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
export_completedБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
operation_cancelledБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
editor_errorБу вакыйга булган вакытта, шул ук элементтан тиешле хәлләрне укыгыз.
Төзүчеләр сораган сораулар
output_uri – Bubble файлымы?
Юк. Бу җирле кэш юлы. Болыт файл сылтамасын саклаганчы, аны ышанычлы җирле саклагыч яки йөкләүче аша саклагыз.
Абонентлык ничек эшли?
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.
Бәйләнешле кулланмалар
Ярдәм өчен, кулланган плагин һәм җайланмагыз, тырышкан гамәлегез һәм нәтиҗәсен безгә хәбәр итегез. Шәхси мәгълүматсыз мисал кулланыгыз. Ачкычыгызны яки шәхси файлларыгызны беркайчан да уртаклашмагыз.