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` како влезови за вашиот процес за поставување датотеки. Потоа зачувајте ја трајната референца во Profile.
Ако корисникот откаже или `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 ја создава уредената копија; вашата апликација прашува дали таа копија да се прикачи на Report.
Користете `has_changes`, `can_undo`, `can_redo` и `output_uri`. Складирајте оригиналните и уредените референци во одделни полиња на апликацијата по успешен поставување.
Cancel crop или Reset edits го враќа процесот на уредување; откажувањето мора да го остави оригиналниот прилог во Report непроменет.
Уредувањето создава локална копија. Вашата апликација избира како да ја зачува или постави.
Што работи сега
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. Снимете еднаш; потоа користете ги акциите подолу. Секој додаток во секој проект има свој клуч.
Прво изберете или снимете сликата со вашата апликација. Дадете на уредникот резултирачката читлива адреса на сликата. Дозволите за камера и фототека припаѓаат на алатката за избор што ја користите.
Конфигурирајте еднаш
- Создајте или изберете го вашиот 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.
Зачувајте го резултатот во вашата апликација
Снимете ја поставената или трајно зачувана слика во 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) - Поставете да доколку овој поглед е отворен. Поставете не кога се напушта, за да се застане репродукцијата или тековната работа.
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 File?
Не. Тоа е локална кеш патека. Сачувајте ја преку проверен локален чувар или поставувач пред да складирате референца за облачна датотека.
Како функционира претплатата?
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.
Поврзани упатства
За помош, кажете ни кој приклучок и уред користите, која акција ја испробавте и што се случи. Користете пример без лични податоци. Никогаш не споделувајте го вашиот клуч или приватни датотеки.