Алдыңғы нативті Photo Editor интерфейсі. Ағымдағы бета нұсқада өңдеу және экспорт әлі тестіленуде.

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.

Жұмыс ағынын құрыңыз ↓Плагин параметрлері ↗Native Lab

Құжаттама қаралды 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 қолданыңыз. Пайдаланушы Save пәрменін өзі таңдағанда 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 оқыңыз. Көшірмені таңдаған файл сақтау жұмыс ағыныңызбен сақтаңыз немесе жүктеп салыңыз, содан кейін сақталған файлды жазбада сақтаңыз.

Жұмыс ағыны диаграммасы — қолданба скриншоты емес

Бір рет баптаңыз

Осы плагин үшін кілтті іске қосу жоспарланған. BestPlugins → Dashboard → Plugins ішінде өзіңіздің Bubble қолданба жобасын жасаңыз немесе таңдаңыз. 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); Бұл көрініс ашық кезде 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