Photo Editor-ի նախորդ native ինտերֆեյսը։ Ընթացիկ բետայում խմբագրումը և արտահանումը դեռ փորձարկվում են։

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`-ը գործարկվում է, պահեք հին avatar-ը։ Մաքրեք սեսիան հաշվի փոփոխության դեպքում, որպեսզի այլ օգտվողը չտեսնի սևագիրը։

Խմբագրումը ստեղծում է տեղական պատճեն։ Ձեր հավելվածը ընտրում է, թե ինչպես պահել կամ վերբեռնել այն։

Պատրաստեք միատեսակ լուսանկարներ շուկայի հայտարարությունների կամ կատալոգի համար։

Տարբեր շրջանակավորումը և չափազանց մեծ պատկերները անսարք են դարձնում կատալոգը և մեծացնում են վերբեռնման չափը։

`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`, նախքան ձեր վերբեռնման աշխատանքային հոսքը արդյունքը պահելը։ Պահպանեք ստացված պատկերի հղումը տարրի վրա։

Եթե արտահանումը ձախողվում է կամ արդյունքը խախտում է ձեր վերբեռնման քաղաքականությունը, ցույց տվեք `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 վերականգնում են խմբագրման ուղին; չեղարկումը պետք է թողնի սկզբնական 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 avatar-ի համար, կարգավորեք կտրումը և օգտագործեք 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); Սահմանեք 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